Cómo utilizar las salidas de las funciones de los conectores en las aplicaciones

Propósito

Las funciones del conector SQL y HTTP envían "salidas" a las apps como objetos o matrices. Aprenda a manipular los objetos en las aplicaciones.

En este artículo aprenderás...
* Cómo utilizar los "Outputs" de una función de conector en una app

Cómo utilizar los "Outputs" de las funciones de los conectores en las apps

LosArrays y los Objetos son dos estructuras de datos populares que se utilizan en muchos lenguajes de programación. Tulip utiliza estas dos estructuras de datos en las funciones conectoras:

1. Cuando una función de conector SQL devuelve varias filas, la salida se envía a una aplicación como una matriz llena de objetos
2. Cuando una función de conector HTTP devuelve una salida con un array, el array aparecerá en una app como un array lleno de objetos.
3. Cuando una función de conector SQL devuelve una única fila, o una función de conector HTTP tiene cualquier salida, los valores se almacenan como pares clave/valor en un objeto

Los objetos sólo pueden crearse automáticamente cuando se completa con éxito una función de conector.

Esta guía le mostrará cómo se organizan automáticamente las salidas de las funciones conectoras. Luego, verá cómo utilizar estas salidas en las aplicaciones.

Recogiendo las salidas de los Conectores

Imagina que quieres extraer todos los datos sobre un operador específico de una base de datos SQL en función de su ID de insignia de Tulipán.

Para hacer esto, escribirías una función de conector SQL que toma badge_id como entrada, y guarda toda la información del operador en una salida. En este caso, la salida se llama group_name. Este es el aspecto que tendría:

Esta función tiene una salida, nombre_grupo, que se almacena como una cadena. Esto se basa en la etiqueta "Texto" en la sección de salidas.

De hecho, cuando creas una función de Conector, no hay opción de almacenar la salida como un array o un objeto. Aquí están los tipos de datos permitidos de la sección "Outputs".

Por lo tanto, debes almacenarlo como "Texto", y luego manipularlo en el Editor de Disparos.

Ejecute esta función en el Editor de Disparos para almacenar la salida en un Objeto.

• "Ejecutar la función del conector" conector: "SBD - Test" "Navegación del operador"
• ID de la placa: "Valor estático" "texto" "2222" y guarde el resultado como "Variable" "test_var"

En este caso, está utilizando un valor de 2222 como entrada, y almacenando el resultado en una variable llamada "test_var".

Uso de objetos en una aplicación

En el ejemplo anterior, tomamos una salida llamada nombre_grupo y la guardamos en una variable llamada test_var. La vista de variables de la aplicación muestra que esta variable es en realidad un objeto con una propiedad llamada "nombre_grupo".

De hecho, si la Función Conectora tuviera múltiples salidas, cada una se guardaría como una nueva propiedad del objeto llamado "test_var" que se creó en el Trigger. Esto le permite organizar todas las salidas de una llamada a la función en un solo lugar.

Puede probar las salidas de la función añadiendo algún texto de variable a su aplicación y luego seleccionando la variable en la pestaña Widget del panel de contexto.

En este caso, tenemos una variable llamada "Order Details" que almacena un objeto con 5 campos:

• orderPlaced
• cantidad
• dirección1
• dirección2
• dirección3

En cuanto seleccione el objeto en el cuadro de búsqueda de Variables, verá que los 5 campos se llenan en su aplicación con etiquetas basadas en los nombres de las propiedades. Es posible que tenga que ampliar el campo de texto de las variables para verlas todas a la vez.

Visualización de Objetos

Si su objeto tiene múltiples propiedades, puede querer mostrarlas todas a la vez en un paso de su aplicación. Esto es más fácil que crear un nuevo texto variable para cada propiedad individual.

Para reordenar/eliminar propiedades individuales del objeto, haga clic en la x o en el símbolo de la rejilla de la propiedad en el Panel de Contexto.

Para cambiar el número de columnas, utilice la opción Columnas del Panel de Contexto.

Para cambiar la visualización de las etiquetas y los valores, ajuste el color y el tamaño de la fuente en el Panel de Contexto.

Para ver cómo se mostrarán estos datos al operador, ejecute la aplicación en el Reproductor, y podrá ver el objeto completo. Los valores se incluirán si primero ejecuta la Función Conectora que recoge los valores.

Manipulación de Objetos

El uso de un Array de objetos en su app puede limitar sus opciones para extraer los puntos de datos a los que está tratando de llegar. Puedes manipular un Array de objetos que se emite desde una función de conector para facilitar el acceso a los datos que deseas utilizar en tu lógica, etc. Esto puede hacerse especificando la(s) clave(s) dentro de un objeto que desee extraer. Esto ayudará a agilizar la salida de datos, permitiéndole aprovechar mejor los datos que le interesan.

Un ejemplo de Función de Conector se puede ver a continuación:

La salida anterior es un array de objetos. Cuando las funciones conectoras devuelven un array de objetos, hay acciones en el editor de expresiones que ayudan a manipularlos. Estas funciones de mapeo le permiten mapear los valores correspondientes basados en una clave dada. Los valores devueltos pueden ser mapeados a un array del tipo seleccionado. Puede utilizar MAP_TO_TEXT_LIST() para obtener un array de texto de todos los Títulos.

• "Ejecutar la función del conector" conector: "Prueba" "Función de prueba" y guardar el resultado como: "test_output"
• "Manipulación de datos" "Almacenar" datos: "Expresión" "MAP_TO_TEXT_LIST(Variable.test_out.Test Parent, 'Test Child')

El primer parámetro que se pasa a la función map es el array de objetos. El segundo parámetro, 'Test Child', es el nombre del extractor señalado en la salida de la función de conector. El nombre del extractor se utiliza como clave para extraer los valores. Esto dará como resultado todos los títulos en un array de cadenas.

Revisión de todas las variables de objetos en una aplicación

Para poder manipular una estructura de datos en una app, ésta debe estar ya almacenada como una variable. Puede ver sus variables existentes entrando en el Panel Contextual en el Editor de Aplicaciones, y seleccionando el símbolo de la Sigma junto a "Variables" en la pestaña de Aplicaciones.

Los objetos se mostrarán con el símbolo de objeto universal, "{}".

Visualización de Múltiples Filas de SQL o Arrays desde Conectores HTTP

Si desea convertir múltiples filas de salida SQL o matrices de conectores HTTP en listas interactivas en una aplicación, consulte esta guía independiente

Más información

• Cómo utilizar matrices en las aplicaciones
• Cómo Llamar a una Función de Conector Usando Triggers
• Guía del editor de expresiones en el editor de aplicaciones

¿Has encontrado lo que buscabas?

También puedes dirigirte a community.tulip.co para publicar tu pregunta o ver si otros se han enfrentado a una pregunta similar.