Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
Puedes usar las políticas incluidas en Apigee Edge para manipular los mensajes que fluyen por los proxies de API. Con las políticas, puedes hacer lo siguiente:
- Convertir mensajes de un formato a otro, como de XML a JSON.
- Establecer valores variables a partir del contenido de los mensajes y crear mensajes a partir de valores variables.
- Usa código de procedimiento, como JavaScript, Java y Python, para administrar mensajes y datos de maneras más complejas.
En general, cuando se usan estas políticas, se especifican las entradas y las salidas como variables de flujo. Durante el tiempo de ejecución, Apigee Edge recupera el valor de entrada de una variable de origen y escribe el valor de salida en una variable de salida.
Este tema presenta estas capacidades. Para obtener información más completa y técnica, consulta las referencias de la política para cada uno.
Administración sencilla para XML y JSON
Apigee Edge incluye políticas que facilitan la conversión entre XML y JSON, y la transformación de XML con XSL.
Convierte JSON a XML
La política de JSON a XML toma tu entrada JSON y la convierte a XML.
En el siguiente ejemplo de políticas, la política toma un mensaje con formato JSON de la variable request y, luego, reemplaza el valor de la variable por un mensaje con formato XML.
La entrada se especifica en el elemento <Source>, mientras que la salida se especifica en el elemento <OutputVariable>.
<JSONToXML name="jsontoxml">
<Source>request</Source>
<OutputVariable>request</OutputVariable>
</JSONToXML>
Convierte XML a JSON
La política de XML a JSON convierte el mensaje de entrada XML en JSON.
En el siguiente ejemplo de políticas, la política toma un mensaje con formato XML de la variable response y, luego, reemplaza el valor de la variable por un mensaje con formato JSON.
La entrada se especifica en el elemento <Source>, mientras que la salida se especifica en el elemento <OutputVariable>.
<XMLToJSON name="ConvertToJSON"> <OutputVariable>response</OutputVariable> <Source>response</Source> </XMLToJSON>
Transforma XML con XSL
Puedes usar la política de transformación de XSL para transformar mensajes con XSL. Por ejemplo, después de convertir una carga útil de JSON a XML, puedes usar la política de transformación de XSL con una hoja de estilo para realizar la transformación que necesitas.
En el siguiente ejemplo de políticas, la política toma un mensaje con formato XML de la variable response y, luego, reemplaza el valor de la variable por un mensaje con formato my_transform.xsl. La entrada se especifica en el elemento <Source>, mientras que la salida se especifica en el elemento <OutputVariable>.
<XSL name="TransformXML">
<ResourceURL>xsl://my_transform.xsl</ResourceURL>
<Source>response</Source>
<OutputVariable>response</OutputVariable>
</XSL>
<Source>request</Source>
<ResourceURL>xsl://XSL-Transform-1.xsl</ResourceURL>
<OutputVariable/>
Controla datos variables
El control de datos dentro de un proxy a menudo implica solo trabajar con datos de estado como valores de variables de flujo. A menudo, puedes hacerlo mediante una política que obtenga o establezca valores variables. Por ejemplo, puede que quieras dar forma a los valores de variables en un mensaje o extraer el contenido de un mensaje para configurar valores de variables.
Asegúrate de ver las referencias de las dos siguientes políticas:
- Asignar política de mensajes para crear mensajes a partir de valores de variables.
- Extrae la política de variables para asignar variables desde el contenido del mensaje.
Crea transformaciones más complejas
Para el manejo de datos cuya complejidad está fuera de la capacidad de las políticas incluidas, puedes usar lenguajes de procedimiento como JavaScript, Java o Python.
En general, esto implica escribir código en uno de estos lenguajes y, luego, invocar el código desde una política específica para el lenguaje. Para obtener más información, consulta Incorpora código de procedimiento.