EIA- Lancement Document ou REB depuis commande Shell (diap.sh)
Une commande shell permet d’exécuter un Document ou une requête REB dans DIAPASON depuis l’invite de commande serveur ou depuis un client à distance.
Syntaxe diap.sh pour lancement document ou requête
Ce shell se trouve dans le répertoire “Shell” de DIAPASON. La syntaxe d’utilisation de ce shell est la suivante (être positionné dans le répertoire Shell) :
Exécution document « TIS03857 » dans la société « ISIA » :
diap.sh 'ACT=DOC;SOC=ISIA;DOC=TIS03857'
Exécution de la requête REB « TIS03857 » dans la société « TEST »:
diap.sh 'ACT=REB;SOC=TEST;REB=TIS03857'
La liste des paramètres passés à ce shell sont sous la forme « PAR1=VAL1 ;PAR2=VAL2 ;…. ». Les valeurs possibles sont décrites dans le tableau ci-dessous :
ACT | Obligatoire : action à effectuer. DOC pour un document, REB pour une requête REB. |
SOC | Obligatoire: référence société. |
DOC | Obligatoire pour un document : correspond à une référence document de type « REB » (6,7,8,9,91) dans la société précisée. |
REB | Obligatoire pour une requête REB : correspond à une référence requête dans la société précisée. |
SCR.xxx | Permet d’initialiser une valeur pour la variable standard critère (SCR) de référence xxx. |
VCR.xxx | Permet d’initialiser une valeur pour la variable spécifique critère (VCR) de référence xxx. |
LBA | Liste de Bases complémentaires à connecter. Par défaut, les bases du document ou de la requête seront connectées. |
SE1 | Permet de spécifier un caractère de remplacement du séparateur « ; ». Voir exemples ci-dessous. |
SE2 | Permet de spécifier un caractère de remplacement du séparateur « = ». Voir exemples ci-dessous. |
Paramètres spécifiques aux documents :
IMP | Imprimante |
FIC | Fichier édition |
FOR | Format imprimante |
DES | Destinataire document |
REP | Répertoire fichier édition |
FAT | File d’attente édition |
NEX | Nombre d’exemplaires |
CL1 | Clé 1 document |
CL2 | Clé 2 document |
CL3 | Clé 3 document |
Retour de la fonction diap.sh
Le shell diap.sh renvoie un résultat qui peut prendre 3 formes :
SORTIE=*OK
SORTIE=*ERR texte de l’erreur
SORTIE=*INC
Remarque : le retour du shell peut être redirigé dans un fichier en utilisant le « > nomdefichier ». Dans ce cas, toutes les traces de DIALOG seront écrites également dans ce fichier.
Exemples de lancement document ou requête
Exécution du document « TIS03857 » avec envoi du résultat par la messagerie :
diap.sh 'SOC=ISIA;ACT=DOC;DOC=TIS03857;IMP=MESSAGE'
Exécution du document « TIS03857 » avec une variable VCR :
diap.sh 'SOC=ISIA;ACT=DOC;DOC=TIS03857;VCR.Texte=Ceci est le texte'
Exécution du document « TIS03857 » avec une variable VCR dont le texte contient le caractère « ; » :
diap.sh 'SOC=ISIA;ACT=DOC;DOC=TIS03857;SE1=£ ;VCR.Test=début £ fin'
La valeur de la variable VCR.Test sera « début ; fin » car le caractère « £ » spécifié dans le paramètre SE1 sera remplacé par « ; ».
Exécution du document « TIS03857 » avec une variable VCR dont le texte contient le caractère « = » :
diap.sh 'SOC=ISIA;ACT=DOC;DOC=TIS03857;SE2=£ ;VCR.Test=quatre £ 4'
La valeur de la variable VCR.Test sera « quatre = 4 » car le caractère « £ » spécifié dans le paramètre SE2 sera remplacé par « = ».
Exécution du document « TIS03857 » avec connections aux bases LOC et LOC2 :
diap.sh 'SOC=ISIA;ACT=DOC;DOC=TIS03857;LBA=LOC,LOC2'
Remarque
Il est nécessaire de préciser les critères d'un document même si ces derniers sont déjà prédéfinis sur le document lui-même.