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 :
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 :
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.
Dans l'outil Developer tool, cliquez sur
Fichier > Nouveau > Schéma
pour ouvrir l'assistant de schéma.
Sélectionnez
Créer à partir d'un fichier d'exemple
.
Cliquez sur
Parcourir
.
Accédez au fichier XML et cliquez sur
Ouvrir
.
Entrez un nom pour le schéma et vérifiez l'emplacement du projet. Si nécessaire, accédez à un nouvel emplacement.
Pour afficher les éléments de schéma, cliquez sur
Suivant
.
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.
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.
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.
Entrez un nom pour la transformation.
Sélectionnez une méthode HTTP. Dans cet exemple, sélectionnez la méthode HTTP POST.
Pour définir la sortie de la méthode, cliquez sur
Suivant
.
Sélectionnez
Créer à partir d'un élément dans un objet de schéma
.
Cliquez sur
Parcourir
.
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
.
Cliquez sur
OK
.
Sélectionnez
Mappage d'entrée
.
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.
Pour définir la sortie de la méthode, cliquez sur
Suivant
dans l'assistant de transformation.
Sélectionnez
Créer à partir d'un élément dans un objet de schéma
.
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
.
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é.
Cliquez sur
Terminer
.
L'image suivante montre comment la transformation est susceptible de s'afficher dans le flux de travail du mappage :
Sélectionnez la transformation Consommateur de service Web REST dans l'éditeur de mappage.
Accédez à la vue
Propriétés
et sélectionnez l'onglet
Avancé
.
Configurez les propriétés avancées. Pour entrer une URL de base, configurez la propriété