PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Paramètres de la procédure à exécuter
  • Type du paramètre
  • Appel de la fonction J2EEExécute
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Exécute une procédure sur un serveur de services Web XML J2EE.
Remarque : Les paramètres de la procédure doivent être spécifiés avant l'utilisation de la fonction J2EEExécute grâce à la structure J2EE (voir Notes).
Exemple
// Cet exemple est basé sur la présence du module Text2Image Webservice
// sur le site dwdemos.alphaworks.ibm.com.
// Si le module n'était plus disponible sur le site,
// l'exemple ne fonctionnerait plus
// Paramètres à passer au service
// Largeur de l'image
J2EE.Valeur[1] = SAI_LARGEUR
J2EE.Nom[1] = "ImageWidth"
J2EE.Type[1] = J2EETypeEntier
...
// Interrogation du Webservice sur le serveur Web
SI J2EEExécute(...
"http://dwdemos.alphaworks.ibm.com:8085/soap/servlet/rpcrouter", ...
"createImage", "urn:text2image", ...
"http://alphaworks.ibm.com/alphabeans/text2image/createImage/") ALORS
// Le résultat est une image, on en fait un fichier temporaire
nIDFic est un entier
nIDFic = fOuvre(fRepExe() + "\temp.gif", foCréation)
fEcrit(nIDFic, J2EEDonneRésultat(J2EERésultat))
fFerme(nIDFic)
// Affichage
IMG_GEN = ""
IMG_GEN = fRepExe() + "\temp.gif"
// Suppression du fichier temporaire
fSupprime(IMG_GEN)
SINON
// Si le service ne retourne pas d'erreur (ex : Serveur inaccessible)
SI J2EEErreur(J2EEErrMessage) ~= "" ALORS
Erreur(ErreurInfo())
// Si le service a retourné une erreur (erreur du service)
SINON
Erreur("Erreur J2EE : " + J2EEErreur(J2EEErrMessage))
FIN
FIN
Syntaxe
<Résultat> = J2EEExécute(<URL du serveur> , <Nom de la procédure> [, <Espace de nommage de la procédure> [, <Action de la procédure> [, <Style d'encodage>]]])
<Résultat> : Booléen
  • Vrai si la communication avec le serveur a été établie,
  • Faux dans le cas contraire (aucune communication n'a été établie). Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<URL du serveur> : Chaîne de caractère (avec guillemets)
URL du serveur à contacter. Ce paramètre est fourni dans la documentation du serveur de services Web XML J2EE et de ses procédures.
<Nom de la procédure> : Chaîne de caractères (avec guillemets)
Nom de la procédure à exécuter sur le serveur spécifié. Ce paramètre est fourni dans la documentation du serveur de services Web XML J2EE et de ses procédures.
Attention à respecter la casse (Majuscules / Minuscules) du nom de la procédure.
<Espace de nommage de la procédure> : Chaîne de caractères optionnelle (avec guillemets)
Espace de nommage (appelé aussi "NameSpace") de la procédure à exécuter. Ce paramètre est fourni dans la documentation du serveur de services Web XML J2EE et de ses procédures.
<Action de la procédure> : Chaîne de caractères optionnelle (avec guillemets)
Action de la procédure (appelé aussi "J2EEAction"). Ce paramètre est fourni dans la documentation du serveur de services Web XML J2EE et de ses procédures.
<Style d'encodage> : Chaîne de caractères optionnelle (avec guillemets)
Style d'encodage de la procédure (appelé aussi "EncodingStyle"). Ce paramètre est fourni dans la documentation du serveur de services Web XML J2EE et de ses procédures.
Remarques

Paramètres de la procédure à exécuter

Pour passer des paramètres à une procédure exécutée sur un serveur de services Web XML J2EE, WINDEV utilise la structure suivante :
VariableTypeDétail
J2EE.NameSpaceChaîne de caractères optionnelleEspace de nommage (appelé "NameSpace") du paramètre.
J2EE.NomChaîne de caractèresNom du paramètre.
J2EE.ParamXMLChaîne de caractères optionnelleDescription complète du paramètre sous forme XML. Si ce paramètre est spécifié, les autres paramètres (Valeur, Nom, Type, NameSpace et StyleEncodage) sont ignorés.
J2EE.StyleEncodageChaîne de caractères optionnelleStyle d'encodage (appelé "EncodingStyle") du paramètre.
J2EE.TypeConstanteType du paramètre
J2EE.ValeurTout typeValeur du paramètre.

Cette structure doit être utilisée pour chaque paramètre. Par exemple :
J2EE.Valeur[1] = 94010
J2EE.Nom[1] = "CodePostal"
J2EE.Type[1] = J2EETypeChaîne
Cette structure est équivalente à :
J2EE.ParamXML[1] = <CodePostal xsi:type="xsd:string">94010</CodePostal>

Type du paramètre

Le type du paramètre peut être :
ConstanteType
J2EETypeBinaireBase64Binaire
J2EETypeBinaireHexaBinaire hexadecimal
J2EETypeBooléenBooléen
J2EETypeChaîneChaîne de caractères
J2EETypeChaîneNormaliséeChaîne de caractères sans retour chariot (RC) et sans tabulation (TAB)
J2EETypeDécimalTout nombre sans limite
J2EETypeEntierEntier compris entre - 2 147 483 648 et + 2 147 483 647
J2EETypeEntierCourtEntier court
J2EETypeEntierCourtNonSignéEntier court non signé
J2EETypeEntierIllimitéEntier (sans limite)
J2EETypeEntierLongEntier long
J2EETypeEntierLongNonSignéEntier long non signé
J2EETypeEntierNégatifEntier négatif (sauf 0)
J2EETypeEntierNonNégatifEntier non négatif
J2EETypeEntierNonPositifEntier non positif
J2EETypeEntierNonSignéEntier non signé
J2EETypeEntierPositifEntier positif (sans 0)
J2EETypeOctetOctet
J2EETypeOctetNonSignéOctet non signé
J2EETypeRéelRéel
J2EETypeRéelDoubleRéel double
J2EETypeURLAdresse URL

Appel de la fonction J2EEExécute

Après l'appel de la fonction J2EEExécute :
  • Les paramètres de la procédure sont effacés.
  • La structure de l'entête spécifié avec la fonction J2EEAjouteEntête est effacée.
  • La fonction J2EEDonneRésultat permet de récupérer le résultat de la procédure exécutée.
  • La fonction J2EEErreur permet de récupérer le message d'erreur de la procédure exécutée.
Composante : wd250com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire