Skip to main content
Skip table of contents

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.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.