Accès
Pour afficher ou modifier les caractéristiques générales d'un service Web du domaine courant, choisir selon le cas :
l'option de menu contextuel Modifier (ou le bouton équivalent) dans l'onglet Services Web du Gestionnaire d'objets,
l'option du menu contextuel Modifier de la boîte de dialogue Référentiel – Services Web dans l'Editeur L4G.
Seules les informations Nom, Désignation et Visibilité peuvent être modifiées.
Les informations saisies
Nom
Nom du service Web.
Ce nom doit être un nom de ressource valide (au sens IBM du terme), unique dans l'environnement.
Longueur limitée à 15 caractères.
Désignation
Désignation définissant clairement le service Web.
Longueur limitée à 250 caractères.
Les informations affichées
Nom réel
Nom réel du service Web dans le fichier de description.
Espace de noms cible (service)
Espace de noms utilisé pour qualifier les éléments du service Web.
Espace de noms (schémas)
Espace(s) de noms utilisé(s) pour qualifier les types complexes définis par le(s) schéma(s) XML du service Web.
Emplacement
URL du service Web.
Les boutons radio
Visibilité
La visibilité d'un service Web peut être publique ou privée.
Un service Web public ne peut pas être changé en privé s'il est attaché à plus d'un domaine.
La liste arborescente
Opérations
Cette liste présente le nom des opérations du service Web qui peuvent être appelées.
Le mode d'appel est précisé par l'icône affichée avant le nom de l'opération. L'image d'une enveloppe indique un appel en mode "message. L'image d'un rouage indique un appel en mode "paramètre".
Il est à noter que le mode "message" peut toujours se substituer au mode "paramètre".
Pour chacune des opérations, la liste présente les éventuels paramètres en entrée. Ces paramètres sont signalés par une flèche verte.
Un paramètre en entrée est défini par un type de base et un nom. Les types de base sont :
- Alpha
- Entier court
- Entier
- Entier long
- Réel
- Date
- Time
- Timestamp
- Image
- Bool
Un paramètre en entrée peut comporter une ou plusieurs restrictions par rapport à son type de base. Dans ce cas, le nom du paramètre est affiché en bleu et est souligné. Il est alors possible de cliquer sur ce nom afin d'ouvrir une boîte de dialogue présentant les restrictions sur le type associé au paramètre.
Pour un mode d'appel "message", un paramètre en entrée est soit un paramètre simple (comme pour le mode "paramètre"') soit un paramètre complexe.
Dans le cas d'un paramètre simple, ce dernier est défini par un type de base et un nom.
Dans le cas d'un paramètre complexe, le paramètre est défini par une arborescence.
Chaque élément de l'arborescence porte un nom.
Un type de base est associé à chaque élément terminal (feuille).
Un élément multiple (tableau) est suivi du symbole [num] ou [] si le nombre de postes est indéfini.
Un élément facultatif est suivi du symbole *.
Un élément dont la valeur peut-être vide est affiché en gris clair.
Pour invoquer une opération en mode "message", il faut dans un premier temps constituer un document XML conforme à la définition des paramètres en entrée, puis utiliser ce document XML avec la directive *CORPS_MSG_MEM ou * CORPS_MSG_FIC de l'ordre SW_APPELER.
Un exemple du message à constituer est fourni à l'aide de l'option Requête exemple du menu contextuel de l'opération.
Pour chacune des opérations, la liste présente l'éventuel paramètre en sortie. Ce paramètre est signalé par une flèche rouge.
Un paramètre en sortie est soit un paramètre simple, soit un paramètre complexe.
Dans le cas d'un paramètre simple, ce dernier est défini par un type de base et un nom.
Dans le cas d'un paramètre complexe, le paramètre est défini par une arborescence détaillant la structure du résultat.
Un paramètre complexe peut être interrogé dans le L4G à l'aide d'une requête XPATH.
Chaque élément de l'arborescence porte un nom.
Un type de base est associé à chaque élément terminal (feuille).
Un élément multiple (tableau) est suivi du symbole [].
Un attribut associé à un élément est marqué en rouge et un type de base lui est associé.
Remarques :
- Tous les éléments pour lesquels un type de base est associé peuvent être interrogés à l'aide d'une requête XPATH, en utilisant l'ordre SW_RECUP_VAL (éléments terminaux, attributs d'un élément).
- Tous les éléments multiples peuvent être interrogés à l'aide d'une requête XPATH, en utilisant l'ordre SW_COMPTER_VAL pour connaître le nombre d'occurrences.
Le menu contextuel
Copier
Disponible pour chaque élément de la liste arborescente, cette option permet de copier dans le presse-papiers la syntaxe XPATH permettant de référencer l'élément en question.
Requête exemple
Disponible uniquement pour les opérations, cette option permet d'afficher une requête exemple – sous forme d'un document XML – pour invoquer l'opération en mode message. Les valeurs des données sont remplacées par un caractère '?'.
Les boutons
Fichier WSDL
Ouverture d'une boîte de dialogue affichant le fichier de description WSDL et des éventuels schémas XML liés à ce fichier de description.
Informations
Ouverture d'une boîte de dialogue affichant des informations sur le service Web en cours, telles que le nom du propriétaire concepteur, les dates et heures de création et de dernière modification.
Commentaires
Ouverture d'une boîte de dialogue permettant la saisie d'un texte de commentaire qui sera associé au service Web en cours.
Modifier
Validation des modifications et fermeture de la boîte de dialogue.
Annuler
Fermeture de la boîte de dialogue sans valider aucune modification.
Raccourci-clavier : Echap.
Cliquez ci-dessous pour plus d'informations sur la consommation d'un service Web :