Ajout d'un message

Les messages représentent une définition abstraite des données transmises. Un message se compose de parties logiques, chacune associée à une définition dans un système de type. Les messages WSDL sont des objets de niveau supérieur qui peuvent être référencés par les éléments en entrée, en sortie et par défaut d'une opération (dans un type de port).

Vous pouvez créer un message à partir de la vue de la structure en cliquant avec le bouton droit de la souris sur le dossier Messages puis en cliquant sur Ajouter un message.

Pour créer un nouveau message pour votre élément en entrée, en sortie et par défaut, procédez comme suit :

  1. Dans la vue Conception, cliquez avec le bouton droit de la souris sur votre élément en entrée, en sortie et par défaut, puis cliquez sur Définir un message > Nouveau message.
  2. Entrez le nom du message dans la boîte de dialogue. Ce nom doit être unique parmi tous les messages définis dans le document WSDL englobant. Cliquez sur OK.
  3. Le nouveau message s'affiche dans la vue Conception dans le type de port.

Remarque : les messages sont référencés dans un type de port (spécifiquement par les objets en entrée, en sortie et par défaut d'une opération). Les objets en entrée, en sortie et par défaut dans une liaison ne référencent pas les messages. Par conséquent, vous ne pouvez pas créer un nouveau message en cliquant avec le bouton droit de la souris sur un objet en entrée, en sortie et par défaut dans une liaison (ces objets sont appelés entrée de liaison, sortie de liaison et valeur par défaut de liaison).

Conseil : vous pouvez également créer un message pour votre élément en entrée, en sortie et par défaut à l'aide de la vue de la structure. Sous le dossier Types de port, cliquez avec le bouton droit de la souris sur l'élément, puis cliquez sur Définir un message > Ajouter un message. Votre message s'affiche dans la vue Structure sous le dossier Messages.

Pour réutiliser un message pour votre élément en entrée, en sortie et par défaut, procédez comme suit :

  1. Dans la vue Conception, cliquez avec le bouton droit de la souris sur votre élément en entrée, en sortie et par défaut, puis cliquez sur Définir un message > Message existant.
  2. Dans la zone Nom, entrez une chaîne de recherche pour filtrer la liste ou laissez la zone vierge pour tout afficher.
  3. Vous pouvez changer la portée de la liste en sélectionnant une des options suivantes :
    • Espace de travail. Affiche la liste de tous les messages disponibles dans votre espace de travail.
    • Projet englobant. Affiche la liste de tous les messages disponibles dans le projet contenant votre fichier.
    • Ressource en cours. Affiche la liste de tous les messages disponibles dans votre fichier en cours.
    • Jeux de documents. Affiche la liste de tous les messages disponibles dans un ensemble de fichiers donné. Pour sélectionner un jeu de documents, cliquez sur Sélectionner. Vous pouvez sélectionner des fichiers dans un jeu de documents existant ou créer un jeu de documents. Une fois les fichiers sélectionnés, cliquez sur OK.
  4. Les messages existants s'affichent. Sélectionnez-en un et cliquez sur OK.

Pour importer un message existant pour votre élément en entrée, en sortie et par défaut, procédez comme suit :

  1. Dans la vue Conception, cliquez avec le bouton droit de la souris sur votre élément en entrée, en sortie et par défaut, puis cliquez sur Définir un message > Message existant.
  2. Dans la zone Nom, entrez une chaîne de recherche pour filtrer la liste ou laissez la zone vierge pour tout afficher.
  3. Vous pouvez importer un message en sélectionnant une des options suivantes :
    • Espace de travail. Affiche la liste de tous les messages disponibles dans votre espace de travail.
    • Projet englobant. Affiche la liste de tous les messages disponibles dans le projet contenant votre fichier.
    • Jeux de documents. Affiche la liste de tous les messages disponibles dans un ensemble de fichiers donné. Pour sélectionner un jeu de documents, cliquez sur Sélectionner. Vous pouvez sélectionner des fichiers dans un jeu de documents existant ou créer un jeu de documents. Une fois les fichiers sélectionnés, cliquez sur OK.
  4. Les messages s'affichent. Sélectionnez-en un et cliquez sur OK.

Vous pouvez maintenant ajouter des parties à votre message. Les parties sont un mécanisme souple décrivant le contenu logique abstrait d'un message.