Uso del analizador JSON para convertir una cadena JSON en un objeto JSON

Puede utilizar el analizador JSON para convertir los datos de una cadena escrita en formato JSON en un objeto JSON que represente la cadena. El analizador JSON genera un esquema, con claves que se incluyen en la lista de campos que están disponibles para ser mapeados en nodos posteriores del flujo.

Cuando se crean flujos API o basados en eventos en App Connect se suele utilizar la respuesta o salida de un evento, acción o nodo de la caja de herramientas como entrada en una acción posterior mediante la asignación de los campos. En algunos casos en los que los datos se devuelven utilizando JavaScript Object Notation (JSON), los datos se proporcionan como una cadena escrita en formato JSON. Para asignar estos datos en una acción posterior, primero debe utilizar el analizador JSON integrado de App Connect para convertir los datos en un objeto JSON que represente la cadena.

El esquema que genera el analizador JSON se formatea como un conjunto estándar de pares de claves y valores separados por comas y rodeados de llaves {}. Las claves se definen como cadenas, y sus valores pueden ser uno de los siguientes tipos de datos JSON válidos: cadena, número, objeto, matriz, booleano o nulo. Cuando se generan estas claves, se incluyen en la lista de campos disponibles para la asignación al hacer clic en Insertar una asignación Insertar un icono de mapa en una acción posterior.

Definición de los datos que deben analizarse y generación de un esquema JSON válido

Puede utilizar el analizador JSON para analizar cadenas JSON de varias aplicaciones. Sin embargo, un caso de uso típico utiliza una acción de invocación de HTTP para realizar una solicitud GET, POST, PUT, PATCH, DELETE o HEAD que devuelva una respuesta de un punto final de HTTP.

El siguiente ejemplo muestra una acción de invocación HTTP dentro de un flujo multinodo. Aquí se está realizando una llamada GET a un servicio de pruebas de clientes HTTP en http://httpbin.org.

Figura 1. Ejemplo de entradas de campo para una acción de invocación HTTP
Ejemplo de entradas de campo para una acción de invocación HTTP

Para que las cabeceras y el cuerpo de la respuesta estén disponibles para su asignación en una acción posterior, debes insertar un nodo analizador JSON antes de añadir la acción. A continuación, puede utilizar el nodo para definir los datos que desea analizar y generar un esquema JSON válido. Puede insertar y configurar el nodo siguiendo estos pasos:

  1. Haga clic en el signo (+), vaya a la pestaña Caja de herramientas y, a continuación, haga clic en Analizador JSON.
    Figura 2. Seleccionar el analizador JSON en la pestaña Caja de herramientas
    Seleccionar el analizador JSON en la pestaña Caja de herramientas
  2. Utilice el campo Entrada JSON para especificar qué datos de la acción o evento anterior deben analizarse.
    Campo de entrada JSON
    Puede completar el campo Entrada JSON de las siguientes maneras.
    • Puede asignar los campos que se muestran en la lista de entradas disponibles haciendo clic en Insertar una asignación Insertar un icono de mapa.
      Figura 3. Entrada JSON que muestra un campo asignado
      Entrada JSON que muestra un campo asignado
    • Puede combinar texto con campos mapeados.
      Figura 4. Entrada JSON que muestra una combinación de campos de texto y mapeados
      Entrada JSON que muestra una combinación de campos de texto y mapeados
      Figura 5. Entrada JSON que muestra otra combinación de campos de texto y mapeados
      Entrada JSON que muestra otra combinación de campos de texto y mapeados
    • Cuando se resuelve, la entrada en el campo JSON Input debe producir JSON válido. Para evitar errores de ejecución, cualquier campo mapeado que incluya de un evento o acción anterior debe tener un valor que se transforme en una entrada válida. En función del tipo de datos del campo asignado, es posible que también deba encerrarlo entre comillas dobles o llaves {}.
      • Si la Response body para una acción anterior HTTP se devolvió en formato JSON como {"name":"Bob", "age":"99"}, una entrada de entrada JSON de {"responseBody": Response body} se resuelve en el siguiente JSON válido {"responseBody": {"name":"Bob", "age":"99″}}
      • Si el Response body para una acción HTTP anterior fue devuelto en texto plano como Blob, una entrada JSON Input de {"responseBody": Response body} produce JSON inválido: {"responseBody": Blob}

        Para que el JSON sea válido, la entrada JSON Input debe especificarse como {"responseBody": "Response body"} - es decir, Response body debe ir entre comillas dobles. El JSON se considera válido aunque no se haya devuelto ninguna respuesta porque la entrada JSON Input resuelve a {"responseBody": ""}.

      • Si el Request headers (JSON format) campo de una acción anterior de « HTTP » no tiene ningún valor, una entrada de entrada JSON de Request headers (JSON format) «resolves» se convierte en un valor vacío.
      • Si el Request headers (JSON format) campo de una acción anterior HTTP no tiene ningún valor, una entrada JSON Input de {"headers": Request headers (JSON format)} produce un JSON no válido: {"headers":}

        Para que el JSON sea válido, la entrada JSON Input debe especificarse como {"headers": {Request headers (JSON format)}} (es decir, Request headers (JSON format) debe estar entre llaves).

  3. Expanda la sección Esquema de salida y utilice el campo JSON de ejemplo para especificar el JSON de muestra que espera que se devuelva (y que debe convertirse en un objeto JSON). El siguiente ejemplo muestra un JSON de muestra de una llamada GET al servicio de pruebas de clientes HTTP mencionado anteriormente ( http://httpbin.org/get ).
    Figura 6. Ejemplo de campo JSON
    Ejemplo de campo JSON
    Puede configurar el campo Ejemplo JSON de las siguientes maneras.
    • Puede copiar una respuesta de ejemplo que devuelve un servidor web o una llamada API, por ejemplo, y pegarla en este campo.
    • Puede introducir una cadena JSON directamente en este campo. Por ejemplo, {"name":"Bob","age":"99″}
    • El campo Ejemplo JSON acepta un máximo de 16.000 caracteres. Esta función sólo se ofrece para las respuestas de API más pequeñas, ya que la generación de esquemas puede consumir muchos recursos y provocar problemas de rendimiento. Para respuestas de mayor envergadura, existen herramientas externas que puede utilizar para la generación de esquemas en caso necesario. Una vez generado el esquema, puede pegarlo directamente en el campo Esquema JSON (que se muestra en el paso siguiente).
  4. Para convertir el "Ejemplo JSON" en un objeto JSON, haga clic en Generar esquema. Puede ver el resultado en el campo Esquema JSON.
    Figura 7. El esquema JSON generado para un flujo con un nodo JSON Parser
    Flujo con un nodo JSON Parser: esquema JSON generado
    Consejo: También puede omitir el paso de generación del esquema e introducir un esquema válido directamente en el campo Esquema JSON.

Cuando añada otra aplicación de destino y la acción correspondiente al flujo, podrá ver las claves en el esquema JSON como campos a los que puede asignar.