Table des matières

Search

  1. Préface
  2. Services Web
  3. Services Web SOAP
  4. Objet de données WSDL
  5. Objet de schéma
  6. Comment créer un service Web SOAP
  7. Mappages d'opération
  8. Analyse des messages SOAP du service Web
  9. Génération des messages SOAP du service Web
  10. Transformation Consommateur de service Web
  11. Services Web REST
  12. Comment créer un service Web REST
  13. Transformation Consommateur de service Web REST
  14. Cas d'utilisation de la transformation Consommateur de service Web REST
  15. Administration des services Web REST et SOAP
  16. Annexe A: Compatibilité des types de données

Guide des services Web

Guide des services Web

Comment traiter des messages de demande et de réponse au format XML

Comment traiter des messages de demande et de réponse au format XML

Vous disposez d'un fichier XML qui contient une hiérarchie d'éléments à utiliser pour créer le message de demande que la transformation Consommateur de service Web REST envoie à un service Web. Le fichier XML contient des données que vous pouvez utiliser pour identifier une personne de votre organisation, telles que leur ID, nom, e-mail et pays. Il est possible que ces éléments s'affichent dans le fichier XML de la manière suivante :
<Person><ID>sample</ID><Name>sample</Name><Email>sample</Email><Country>sample</Country></Person>
Vous disposez d'un autre fichier XML qui contient une hiérarchie d'éléments à utiliser pour créer le message de réponse. Le fichier XML contient des données sur le type de message d'accueil à utiliser pour vous adresser à chaque personne. Le message d'accueil contient des données sur l'ID de l'individu et le contenu du message d'accueil. Il est possible que ces éléments s'affichent dans le fichier XML de la manière suivante :
<Greeting><ID>sample</ID><Content>sample</Content></Person>
Pour utiliser la hiérarchie d'éléments dans ces fichiers XML d'une transformation Consommateur de service Web REST, importez d'abord les fichiers XML en tant qu'objets de schéma dans l'outil Developer tool, puis utilisez ces objets pour définir l'entrée de la méthode et la sortie de la méthode lorsque vous créez la transformation Consommateur de service Web REST.

Étape 1. Créer des schémas à partir de fichiers XML.

Effectuez les étapes suivantes pour créer un objet de schéma pour l'entrée de la méthode. Répétez ces étapes pour créer un objet de schéma pour la sortie de la méthode.
  1. Dans l'outil Developer tool, cliquez sur
    Fichier > Nouveau > Schéma
    pour ouvrir l'assistant de schéma.
  2. Sélectionnez
    Créer à partir d'un fichier d'exemple
    .
  3. Cliquez sur
    Parcourir
    .
  4. Accédez au fichier XML et cliquez sur
    Ouvrir
    .
  5. Entrez un nom pour le schéma et vérifiez l'emplacement du projet. Si nécessaire, accédez à un nouvel emplacement.
    Cette boîte de dialogue montre l'assistant Nouveau schéma. L'option Créer à partir d'un fichier d'exemple est sélectionnée.
  6. Pour afficher les éléments de schéma, cliquez sur
    Suivant
    .
    Cette capture d'écran montre un aperçu de l'objet de schéma. Vous pouvez observer l'élément parent Person, et le type PersonType.
  7. Cliquez sur Terminer.
    Vous pouvez utiliser l'objet de schéma que vous avez créé pour définir l'entrée de la méthode dans la transformation.
  8. Répétez les étapes 1 jusqu'à 7 pour créer un objet de schéma pour la sortie de la méthode.

Étape 2. Créer la transformation Consommateur de service Web REST.

Créez la transformation. Utilisez les schémas pour définir l'entrée de la méthode et la sortie de la méthode.
  1. Dans l'éditeur de mappage de l'outil Developer tool, faites défiler la palette de mappage vers le bas pour localiser la transformation Consommateur de service Web REST et faites-la glisser vers le mappage.
  2. Entrez un nom pour la transformation.
  3. Sélectionnez une méthode HTTP. Dans cet exemple, sélectionnez la méthode HTTP POST.
    Cette capture d'écran montre l'assistant Nouvelle transformation Consommateur de service Web REST. Vous pouvez spécifier le nom, l'emplacement et la méthode HTTP. Dans cet exemple, la méthode HTTP POST est sélectionnée.
  4. Pour définir la sortie de la méthode, cliquez sur
    Suivant
    .
  5. Sélectionnez
    Créer à partir d'un élément dans un objet de schéma
    .
    Cette image montre la boîte de dialogue de configuration de l'entrée de la méthode pour la transformation Consommateur de service Web REST. L'option Créer à partir d'un élément dans un objet de schéma est sélectionnée.
  6. Cliquez sur
    Parcourir
    .
  7. Sélectionnez l'élément parent dans le schéma. Dans cet exemple, le schéma utilisé pour l'entrée de la méthode contient l'élément parent
    Person
    .
    Cette image montre la boîte de dialogue qui vous invite à sélectionner un élément de schéma. Elle montre l'objet de schéma stocké dans le référentiel modèle et l'élément parent dans l'objet de schéma. L'élément parent de cet objet de schéma est Person.
  8. Cliquez sur
    OK
    .
  9. Sélectionnez
    Mappage d'entrée
    .
  10. Mappez les éléments sous
    RequestInput
    dans la zone Ports à
    Rest_Consumer_Input
    dans la zone Définition de l'entrée de la méthode. Pensez à mapper la clé de la zone Ports à la zone Définition de l'entrée de la méthode.
    L'image montre le mappage d'entrée. La zone Ports est à gauche et la zone Définition de l'entrée de la méthode est à droite. Les éléments de la zone Ports sont mappés aux éléments correspondants de la zone Définition de l'entrée de la méthode. La clé imbriquée sous RequestInput est mappée à celle imbriquée sous Rest_Consumer_Input.
  11. Pour définir la sortie de la méthode, cliquez sur
    Suivant
    dans l'assistant de transformation.
  12. Sélectionnez
    Créer à partir d'un élément dans un objet de schéma
    .
  13. Sélectionnez l'élément parent dans le schéma. Dans cet exemple, le schéma que nous utilisons pour la sortie de la méthode contient l'élément parent
    greeting
    .
    Cette image montre la boîte de dialogue qui vous invite à sélectionner un élément de schéma. Elle montre l'objet de schéma stocké dans le référentiel modèle et l'élément parent dans l'objet de schéma. L'élément parent de cet objet de schéma est greeting.
  14. Mappez les éléments sous
    Rest_Consumer_Output
    dans la zone Définition de la sortie de la méthode à la zone Ports. Il n'est pas nécessaire de mapper la clé.
    Cette image montre un exemple de mappage de sortie. La zone Définition de la sortie de la méthode est à gauche et la zone Ports est à droite. Les éléments de la zone Définition de la sortie de la méthode sont mappés aux éléments correspondants de la zone Ports. La clé de la zone Définition de la sortie de la méthode n'est pas mappée à la zone Ports.
  15. Cliquez sur
    Terminer
    .
    L'image suivante montre comment la transformation est susceptible de s'afficher dans le flux de travail du mappage :
    Cette image montre un mappage avec une transformation Lecture, une transformation Consommateur de service Web REST et une transformation Écriture. Les ports de la transformation Lecture sont liés en tant que ports d'entrée dans la transformation Consommateur de service Web REST en aval. Le contenu du port de sortie de la transformation Consommateur de service Web REST est lié à la transformation Écriture en aval.
  16. Sélectionnez la transformation Consommateur de service Web REST dans l'éditeur de mappage.
  17. Accédez à la vue
    Propriétés
    et sélectionnez l'onglet
    Avancé
    .
  18. Configurez les propriétés avancées. Pour entrer une URL de base, configurez la propriété
    URL
    ou entrez une connexion HTTP dans la propriété
    Connexion
    .
    Cette image montre les propriétés avancées de la transformation Consommateur de service Web REST. Les propriétés avancées incluent URL et Connexion.