Altova MapForce 2027 Enterprise Edition

Cette section du dialogue vous permet de sélectionner les structures de requête et de réponse de votre votre appel de service web. Lorsque vous appelez des services web qui attendent du contenu dans le corps du message de requête ou qui renvoient du contenu dans le corps du message de réponse, vous pouvez définir les structures de requête et de réponse selon l'une des options suivantes :

•Pas de structure

•XML

•JSON

•Protocol Buffers

Note : dans les appels de services Web créés avec MapForce, vous pouvez utiliser le format JSON standard comme structure de requête ou de réponse ; les structures JSON Lines ou JSON5 ne sont pas prises en charge.

La structure sélectionnée détermine les items mappables qui apparaissent sur le mappage comme enfants de l’item Corps .

Structure de requête

Pour définir la structure de requête de votre appel de service web, accédez à la section Structures du dialogue Paramètres d’appel de service Web, puis cliquez sur Éditer à côté du champ Requête. Ceci ouvrira la boîte de dialogue Structure de requête (capture d’écran ci-dessous) Vous pouvez également ouvrir le dialogue Structure de requête en cliquant sur le bouton situé dans la partie de requête du composant de service web de votre mappage.

Type de structure

Une fois que vous avez ouvert le dialogue Structure de requête, sélectionnez une des options suivantes dans la section Type de structure :

•Si le service web n'attend aucun contenu dans le corps de la requête, ou si vous souhaitez fournir le corps brut (entité MIME) directement à partir du mappage, sélectionnez Pas de structure.

•Pour le XML, procurez-vous le schéma XML ou DTD de la requête auprès du fournisseur du service web. Si vous sélectionnez un fichier d’instance XML, il doit avoir une référence de schéma valide. Quelques schémas XML définissent les éléments avec une déclaration globale (à savoir, les éléments dont le parent est l’élément schéma). Pour de tels schémas, vous pouvez choisir quel élément dans le schéma devrait être l’élément racine de la structure du mappage dans MapForce. Pour ce faire, cliquez sur Choisir, puis, dans le dialogue qui s'affiche, sélectionnez l'élément racine souhaité.

•Pour le format JSON, procurez-vous le schéma JSON de la requête auprès du fournisseur du service web ou générez-le à partir d'un fichier JSON d'exemple à l'aide d'un outil tel qu'Altova XMLSpy.

•Pour les Protocol Buffers, demandez au fournisseur du service web le fichier .proto décrivant le fichier binaire, puis cliquez sur Parcourir pour sélectionner ce fichier. Le champ Type de message racine est pertinent quand le fichier Protocol Buffers contient de multiples types de messages. Cliquez sur Choisir pour sélectionner le type de message qui doit être au niveau de la racine de la structure.

Astuce : si vous avez un fichier de requête échantillon XML ou JSON, mais n’avez pas de fichier schéma, vous pouvez utiliser Altova XMLSpy pour générer le fichier de schéma. Le cas échéant, XMLSpy peut convertir votre fichier d'instance de XML à JSON, ou vice-versa.

Écraser type de contenu

En option, sélectionnez la case à cocher Écraser type de contenu si vous avez besoin d’écraser l’en-tête Content-Type définie implicitement par MapForce. Vous pouvez aussi saisir les paramètres après le type de contenu, par exemple, Content-Type: text/html; charset=utf-8.

Structure de réponse

Pour définir la structure de réponse de votre appel de service Web, accédez à la section Structures du dialogue Paramètres d’appel de service Web et cliquez sur Éditer à côté du champ Réponse. Ceci ouvre le dialogue Structure de réponse (capture d’écran ci-dessous). Vous pouvez également ouvrir le dialogue Structure de requête en cliquant sur le bouton situé dans la partie réponse du composant de service web dans votre mappage.

Type de structure

Une fois que avez ouvert le dialogue Structure de requête, vous devez sélectionner une des options dans la section Type de structure. Si le service web ne renvoie aucun contenu dans la partie corps, ou si vous souhaitez traiter le corps brut (entité MIME) directement à partir du mappage, sélectionnez Pas de structure. Pour information sur les autres options disponibles dans cette section du dialogue, voir Type de structure dans la sous-section Structure de requête ci-dessus.

Type de contenu et statut HTTP

E n option, remplissez les cases de texte Type de contenu et Statut HTTP (capture d’écran ci-dessous) si vous avez besoin de filtrer une entité de réponse MIME par type de média (contenu) et code de statut HTTP. Cette option est utile si vous avez besoin d’un traitement conditionnel en fonction du code d’état HTTP et du type de contenu renvoyés par l’appel de service web. Pour un exemple, voir Gestion d'erreur dans les HTTP API.

Par défaut, le filtre Type de contenu est défini à */*, qui correspond à tous les types de médias. Les codes de statut HTTP par défaut sont 200-299. Si l’appel de service web renvoie un autre code d’état qui n’est pas géré explicitement, l’exécution du mappage échouera et générera une erreur.