SW-EXTERNE
BUT
Cette fonction permet de configurer, exécuter et récupérer les paramètres d’un service WEB externe, à partir d’une requête DIALOG.
Disponible dans tous les types de requête.
SYNTAXE
Variable = SW-EXTERNE ( MODE : action sur le service WEB
SW : Nom du service WEB à exécuter
IDENT : identifiant du service WEB
PARAM : Nom du paramètre en entrée ou sortie du service WEB
VALEUR : Valeur du paramètre en entrée du service WEB
E-S :LISTE : Liste DIALOG en entrée/sortie du service WEB
S :ID : identifiant retournée lors de l’initialisation du service WEB
S :VALPARAM : Valeur du paramètre en sortie )
PARAMETRES
Paramètre | E/S | O | Type | Description |
MODE | E | Oui | Caractère | Action sur le service WEB externe. Cette référence peut prendre l’une des valeurs suivantes : INIT : initialisation du service WEB externe PUT-C : passage d’un paramètre de type caractère PUT-I : passage d’un paramètre de type entier PUT-D : passage d’un paramètre de type date PUT-R : passage d’un paramètre de type décimal PUT-L : passage d’un paramètre de type logique PUT-LISTE : passage d’un paramètre de type Liste DIALOG GET-C : récupération d’un paramètre de type caractère GET-I : récupération d’un paramètre de type entier GET-D : récupération d’un paramètre de type date GET-R : récupération d’un paramètre de type décimal GET-L : récupération d’un paramètre de type logique GET-LISTE : récupération d’un paramètre de type Liste DIALOG EXE : exécution service WEB externe |
SW | E | Oui | Caractère | Référence service WEB externe à lancer. Cette référence peut être donnée par une variable locale, une constante globale ou une constante locale. Ce paramètre n’est disponible que dans le cas où le MODE est égal à EXE. |
IDENT | E | Oui | Caractère | Identifiant du service WEB renvoyé par la fonction en MODE « INIT ». Peut être donné par une variable locale, une constante globale ou une constante locale. |
PARAM | E | Oui | Caractère | Nom du paramètre à envoyer au service WEB ou à récupérer en sortie du service WEB. Peut être donné par une variable locale, une constante globale ou une constante locale. Ce paramètre n’est pas utilisé dans le cas où le MODE est égal à INIT ou EXE. |
VALEUR | E | Oui | Caractère Numérique Logique Date | Valeur du paramètre à envoyer au service WEB. Paramètre utilisé seulement dans le cas où le MODE est égal à l’une des options de passage de paramètres (PUT-*). Ce paramètre peut être donné par une variable locale, une constante globale, une constante locale ou par une sélection de Liste DIALOG dans le cas PUT-LISTE. |
E-S :LISTE | E | Oui | Caractère | Paramètre utilisé dans le cas où le MODE est égal à GET-LISTE. Il contient la référence de la liste à récupérer en retour d’exécution du service WEB. |
S :ID | E | Oui | Caractère | Identifiant service WEB retourné dans une variable de type caractère, dans le cas où le MODE est égal à INIT. |
S :VALPARAM | E | Oui | Caractère Numérique Logique Date | Valeur du paramètre après exécution du service WEB. Paramètre utilisé seulement dans le cas où le MODE est égal à l’une des options de récupération de paramètres (GET-* sauf GET-LISTE). |
NOTES
La fonction retourne dans la variable résultat :
Le code erreur DIAPASON et le libellé associé à l’erreur, lors de toute anomalie d’exécution
Vide si tout s’est bien passé
EXEMPLE
VLO.RES = SW-EXTERNE( MODE= INIT , S:ID= VLO.ID )
VLO.NumLig = CLO.214888
VLO.RES = SW-EXTERNE( MODE= PUT-I , IDENT= VLO.ID , PARAM= CLO."idLigne" , VALEUR= VLO.NumLig )
VLO.RES = SW-EXTERNE( MODE= EXE , SW= CLO."CFG_WEB_ELCIA_POST" , IDENT= VLO.ID )
VLO.RES = SW-EXTERNE( MODE= GET-LISTE , IDENT= VLO.ID , PARAM= CLO."Param-liste" , E-S:LISTE= WFEIAXmlMes )
Cette requête permet de lancer le service WEB qui attend en entrée un numéro de ligne et qui renvoie en résultat la liste DIAPASON WFEIAXmlMes.