xml-to-json

Utilisez la stratégie xml-to-json pour convertir le contenu contextuel de votre API du format XML (extensible markup language) au format JSON ( JavaScript Object Notation).

Prise en charge des passerelles

Tableau 1. Tableau des passerelles prenant en charge cette stratégie, ainsi que la version de stratégie correspondante
Passerelle Version de la stratégie
DataPower® Gateway (v5 compatible) 1.0.0
DataPower API Gateway 2.0.0

Cette rubrique explique comment configurer la stratégie dans votre source OpenAPI . Pour plus de détails sur la configuration de la stratégie dans l'interface utilisateur de l'assemblage, voir XML en JSON.

A propos de

La stratégie xml-to-json possède la structure suivante:
- xml-to-json:
   version: version
   title: Title
   description: Description
Remarque: Si vous utilisez DataPower API Gateway, l'entrée de la règle xml-to-json doit être des données analysées. Une façon de produire des données analysées consiste à utiliser une stratégie parse avant une stratégie xml-to-json dans votre flux d'assemblage, qui fournit un contrôle explicite de l'action d'analyse.

Propriétés

Le tableau suivant décrit les propriétés de la stratégie :
Tableau 2. Propriétés de politique
Propriété Obligatoire Descriptif Type de données
version Oui Numéro de version de la stratégie chaîne
title Oui Titre de la stratégie. chaîne
description Non Description de la stratégie. chaîne
DataPower API Gateway
onlyinput Non Le message d'entrée à convertir. Indiquez le nom d'une variable dans le contexte d'API. variableName.body, le contenu du message représente l'entrée JSON à convertir. La valeur par défaut de la variable est message et message.body est l'entrée par défaut. chaîne
DataPower API Gateway
onlyoutput Non Le message de sortie pour stocker le résultat de la conversion. Indiquez le nom d'une variable dans le contexte d'API. variableName.body représente le résultat de la conversion du format JSON au format XML. Lorsque le message d'entrée indiqué est le message par défaut, la sortie par défaut est message.body. Sinon, quand le message d'entrée est la variable my-message-variable, par exemple, la sortie par défaut est my-message-variable.body.

La variable ne peut pas être en lecture seule dans le contexte d'API.

chaîne
DataPower API Gateway
onlyconversionType Non Type de conversion qui détermine le format cible de la sortie. Les options suivantes sont disponibles :
  • badgerFish : La convention BadgerFish est utilisée pour déterminer le format de conversion de la sortie.
  • apicv5 : La convention apicv5 est utilisée pour déterminer le format de conversion de la sortie.
chaîne

Exemple

Voici un exemple de stratégie xml-to-json :
- xml-to-json:
   version: 1.0.0
   title: XML to JSON transform
   description: Transforms XML message body to JSON format