Configuración de la política JSON a XML para DataPower API Gateway

Siga estos pasos para configurar la política JSON a XML para DataPower® API Gateway en la interfaz de usuario de ensamblaje.

Acerca de esta tarea

Nota: Este tema describe la implementación de la política JSON a XML en DataPower API Gateway. Si utiliza DataPower Gateway (v5 compatible), consulte «Configuración de la política de conversión de JSON a XML para DataPower Gateway (compatible con v5 ) ». Para obtener más información sobre los distintos tipos de pasarela, consulte Tipos de pasarela deAPI Connect.

Para obtener información sobre cómo configurar la política en tu fuente de OpenAPI, consulta json-to-xml.

Procedimiento

En el panel de navegación, haz clic en «Desarrollo » y, a continuación, selecciona la pestaña «API ».
Se abre la página Desarrollar .
Pulse el título de la definición de API con la que desea trabajar o cree una nueva API.
Seleccione la pestaña Pasarela y, a continuación, pulse Políticas en el panel de navegación.
Para obtener más información sobre cómo trabajar con el editor de ensamblados de una API, consulta «El editor de ensamblados ».
Busque la política JSON a XML en la paleta y arrastre la política al lienzo.

Especifique las propiedades siguientes.

Tabla 1. Propiedades de la póliza
Etiqueta de propiedad	Obligatorio	Descripción	Tipo de datos
Título	Sí	El título de la política. El valor predeterminado es `json-to-xml`.	serie
Descripción	Nee	Una descripción de la política.	serie
Entrada	Nee	El mensaje de entrada que se debe convertir. Especifique el nombre de una variable en el contexto de la API. `variableName.body` la carga útil del mensaje, representa la entrada JSON que se va a convertir. El valor predeterminado de la variable es `message` y `message.body` es la entrada predeterminada.	serie
output	Nee	El mensaje de salida en el que almacenar el resultado de la conversión. Especifique el nombre de una variable en el contexto de la API. `variableName.body` representa el resultado de la conversión del formato JSON al formato XML. Cuando el mensaje de entrada especificado es el mensaje predeterminado, la salida predeterminada es `message.body`. De lo contrario, cuando el mensaje de entrada es por ejemplo la variable `my-message-variable`, la salida predeterminada es `my-message-variable.body`. La variable no puede ser de solo lectura en el contexto de la API.	serie
Tipo de conversión	Nee	El tipo de conversión que determina el formato de destino de la salida. Están disponibles las opciones siguientes: Ninguno: no tiene lugar ninguna conversión de la salida. badgerFish: se utiliza el convenio de BadgerFish para determinar el formato de conversión de destino de la salida.	serie
Nombre de elemento XML raíz	Sí	El nombre del elemento raíz del documento XML resultante. Esta propiedad sólo se utiliza si el documento JSON de entrada no es jerárquico y tiene más de una propiedad de nivel superior, o si el recuadro de selección Salida siempre del elemento raíz está seleccionado. El valor predeterminado es `json`.	serie
Ofrecer siempre la salida del elemento raíz	Sí	Seleccione este recuadro de selección si siempre desea que la política genere el elemento raíz, incluso si no es necesario que el documento XML esté bien formado. El valor predeterminado es `false`.	booleano
Nombre de elemento de elementos de matriz JSON	Nee	El nombre de elemento XML que se utilizará para elementos de matriz JSON.	serie

Especifica una versión para la política haciendo clic en el icono «Fuente» y completando la version sección correspondiente del archivo YAML de la política. Por ejemplo:
```
execute:
  - json-to-xml:
      version: 2.0.0
      title: json-to-xml
  ...
```
Debe especificar una versión para la política que sea compatible con la pasarela que está utilizando. Cuando se publica la API, si la versión es incompatible con la pasarela, se genera un error de validación que especifica las versiones disponibles.
Pulse Guardar.

Ejemplo

Por ejemplo, el objeto JSON simple siguiente

{ "a": { "$" : "hello" } }

pasa a

<a>hello</a>

El objeto JSON siguiente con un atributo

{ "a": { "$" : "hello", "@type" : "world" } }

pasa a

<a type="world">hello</a>