Uso del analizador CSV para convertir texto CSV en un objeto JSON

En un flujo, un evento o acción puede devolver valores separados por comas (CSV) de un archivo o algún otro contenido. Añade un nodo analizador CSV a un flujo para transformar la cadena de datos CSV en un objeto JSON. A continuación, puede utilizar el objeto JSON para asignar los datos CSV a las acciones posteriores del flujo.

Lo primero que hay que tener en cuenta

Los datos CSV que devuelve un evento o acción deben estar en texto plano y pueden contener uno o varios registros de datos en formato tabular. La coma (,) es el único delimitador admitido para los campos de datos. Por ello, si el valor de un campo incluye una coma, dicho valor debe ir entre comillas dobles ("").

El esquema que genera el analizador CSV 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 en una acción posterior.

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

El siguiente ejemplo muestra una sección de un flujo multinodo que utiliza una acción Recuperar archivo de Box para especificar el identificador de un archivo CSV cuyo contenido desea recuperar y analizar.

Casilla Campos de acción de recuperación de archivos — Figura 1. Recuperar campos de acción de archivo

Para que los datos CSV estén disponibles para su asignación en una acción posterior, inserte un nodo analizador CSV antes de la acción y, a continuación, utilice el nodo analizador CSV para definir los datos que desea analizar y generar un esquema JSON válido.

Para insertar y configurar el nodo analizador CSV, siga estos pasos.

Haga clic en el icono (+), vaya a la pestaña Caja de herramientas y, a continuación, haga clic en Analizador CSV.
Figura 2. Seleccionar el analizador CSV en la pestaña Caja de herramientas
Utilice el campo Entrada CSV para indicar qué datos de la acción o evento anterior se analizan. Puede asignar a los campos que se muestran en la lista de entradas disponibles (a la que se accede haciendo clic en Insertar una asignación ). Normalmente, estos datos son el contenido de un archivo CSV o algún otro contenido CSV en un cuerpo de texto. El siguiente ejemplo muestra cómo asignar datos al contenido de un archivo en Box.
Figura 3. Campo de entrada CSV
Despliegue la sección Opciones de análisis CSV y esquema de datos y utilice el campo CSV de ejemplo para especificar datos de texto sin formato que representen una muestra de su contenido CSV.
El siguiente ejemplo muestra datos de muestra de un archivo CSV exportado desde un servidor de gestión de IBM API Connect® a Box. El archivo CSV contiene datos de eventos de la API asociados a uno de los cuadros de mando de Analytics. En este ejemplo, desea analizar estos datos para poder utilizar Gmail o Slack para enviar información analítica pertinente sobre sus API o aplicaciones a sus ejecutivos.

Figura 4. Ejemplo de campo CSV

Puede seleccionar y copiar una o varias filas de su contenido CSV y pegarlas en el campo Ejemplo CSV. Si el contenido del CSV contiene cabeceras de columna que desea definir como claves en el esquema JSON que genera App Connect, asegúrese de incluir la fila de cabecera en su selección. Sólo se utiliza la primera fila para analizar el formato CSV del esquema. El campo Ejemplo CSV acepta un máximo de 16.000 caracteres.
Si incluyó una cabecera CSV en el CSV de muestra, seleccione la casilla de verificación La primera fila de los datos CSV es una cabecera para indicar que las cabeceras de columna deben analizarse como claves en el esquema generado.
Figura 5. La primera fila de los datos CSV es una casilla de verificación de encabezado
Para convertir el CSV de muestra en un objeto JSON, haga clic en Generar esquema. Puede ver el resultado en el campo Esquema JSON.
- Si ha seleccionado la casilla de verificación La primera fila de los datos CSV es una cabecera, las cabeceras de columna definidas se analizan como claves que puede asignar posteriormente.
- Si no ha seleccionado esta casilla, se generará una serie genérica de claves etiquetadas como field1, field2, ..., fieldN para su uso. Puede sobrescribir estas claves genéricas para especificar cadenas de encabezado alternativas si es necesario.
También puede omitir el paso de generación del esquema e introducir un esquema válido directamente en el campo Esquema JSON. También puede modificar los tipos de datos de las claves actualizando los valores de los atributos de tipo de las propiedades. Por ejemplo, puede cambiar "type": "string" (que se muestra en el siguiente ejemplo) por "type": "number".
```
    ...
    "properties": {
      "bytes_received": {
        <strong>"type": "string"</strong>,
        "minLength": 1
      },
    ...
```

Formas de procesar los datos analizados

La salida de un nodo analizador CSV es un array. Por lo tanto, para utilizar esta salida en un nodo posterior en el flujo, normalmente se incluye un nodo For each después del nodo CSV parser para iterar a través del array. Alternativamente, puedes manipular los datos del array utilizando JSONata.