Cómo utilizar las matrices en las aplicaciones

Visión general

Aquí se explica cómo almacenar datos en un array en Tulip y mover valores de un tipo de datos a otro.

En este artículo aprenderás...

• Cómo crear y utilizar Arrays
• Cómo modificar arrays en el Editor de Disparos
• Usar la cadena dividida para convertir la salida de una Función de Conector en un array

Los arrays y los objetos son dos estructuras de datos populares que se utilizan en muchos lenguajes de programación. Tulip utiliza estas estructuras de datos en dos partes de la plataforma:

1. Variables, para almacenar múltiples puntos de datos relacionados con la misma variable
2. Conectores, para pasar la salida de una función de Conector a una variable

Se pueden crear matrices:

1. En el Editor de Disparos (manualmente)
2. En el Editor de Expresiones (manualmente)
3. En la vista de resumen de variables (mostrada abajo) (manualmente)
4. Almacenando la salida de una entrada Multiselect.
5. Almacenando la salida de una función de conector SQL que devolvió múltiples filas o conector HTTP con un array en el JSON que se devuelve(automáticamente)

Creación de Arreglos

En el Editor de Disparos

Puede crear un Array utilizando la acción "Push onto Array".

• "Arrays" "Push Onto Array" datos: "Static Value" "text" "text" array: (crear array aquí)

En el Editor de Expresiones

Puede crear un nuevo Array a través de la acción "Data Manipulation" "Store". Así:

• "Manipulación de Datos" "Almacenar" datos: "Expresión" "[1,2,3]" ubicación: "test_array"

Cada array sólo puede tener un tipo de valor, es decir, cadenas o enteros.

En la vista de resumen de variables

Navegue a la Vista de Resumen de Variables en la pestaña "App" del Panel Contextual, luego cree una nueva variable en la parte superior del modal:

Manipulación de Arrays

Puede crear y manipular arrays a través del Editor de Disparos. En una sentencia "Then", haga clic en "Add new Action" y luego elija la opción "Arrays".

En el siguiente desplegable, verá una variedad de métodos de arrays. Estos se alinean con los métodos de arreglos en JavaScript, así que revisa esta guía de métodos de arreglos si necesitas más explicaciones.

Los métodos de arreglos disponibles incluyen:

1. Borrar Array
2. Concatenar Arrays
3. Obtener de índice en Array
4. Obtener la longitud del Array
5. Insertar en un índice del array
6. Unir a la cadena
7. Sacar de la matriz
8. Empujar a la matriz
9. Eliminar y almacenar el elemento en el índice de la matriz
10. Eliminar en el índice de la matriz
11. Establecer el índice en la matriz
12. Sumar la matriz
13. Intercambiar elementos en la matriz

Dependiendo de su selección en este desplegable, el resto de los campos le darán opciones sobre el array que desea manipular, el índice que desea cambiar y el nuevo valor que está estableciendo.

• "Arrays" "Establecer Índice en Array" datos: "Valor estático" "número" "90" array: "prueba_a" índice: "Valor estático" "entero" "0"

En el ejemplo anterior, se está cambiando el valor en el índice 0 de un array llamado "test_a" a un valor de 90.

• "Arrays" "Get from index in Array" array: "Variable" "test_a" índice: "Valor estático" "entero" "0" almacenar en la variable: "test_vari"

Y en el ejemplo anterior, estás accediendo al valor en el índice 0 de un array llamado "test_a" y almacenándolo en una variable llamada "test_vari".

Búsqueda en arrays

Supongamos que quiere utilizar un widget de selección múltiple para permitir que un operador introduzca varios tipos de defectos sobre un mismo producto. Entonces, dependiendo de los defectos que introduzcan, le gustaría enviarlos a un conjunto específico de pasos de retrabajo.

Un formulario multiselección guarda automáticamente los valores en una matriz. Por lo tanto, tendrá que buscar en esta matriz un valor específico, y luego enviar al operador a un paso específico.

Puede utilizar la acción de activación "Join To String" para lograr esto. Esto combinará todos los elementos de un array en una sola cadena, y la almacenará en una variable separada. Luego, en un Trigger separado, puede utilizar una sentencia "If" para ver si esta cadena contiene un valor específico.

Los elementos de la matriz pueden estar separados por cualquier cadena que elijas. La mayoría de los usuarios de Tulip prefieren una coma (,).

Este es un ejemplo de cómo unir todos los elementos de un array en una cadena:

• "Arrays" "Join To String" unir: "tipos de defectos"
• con delimitador: "Valor estático" "texto" ","
• almacenar en: "tipos_de_defecto_unidos"

Aquí está el segundo disparador que se utilizaría para buscar en esta nueva cadena un valor específico:

IF

• "Variable" "defect_types_joined" "Contiene" "Static Value" "text" "chip"

Uso de la cadena dividida para crear matrices

Basándonos en todo lo que hemos visto hasta ahora, sería muy difícil obtener la salida de algunos tipos de funciones de conector en un array. Para resolver este problema, puede utilizar split string.

Si quieres preparar la salida de tu función de conector para almacenarla en un array, necesitas añadir un carácter común entre cada dato. Algunos ejemplos comunes son

• Punto y coma (;)
• Coma (,)
• Carácter de nueva línea ("\n")

Supongamos que tiene una serie de datos que desea almacenar en una matriz. En su consulta SQL o petición GET HTTP, primero querrá combinarlos en una cadena, si no están ya almacenados en un objeto.

Este es un ejemplo:

7989;43f3;3e3;f34;f;34;3

El delimitador común es un punto y coma.

En el Editor de Activación, querrá utilizar la opción "Dividir cadena" para convertir esta cadena en una matriz.

Primero seleccione la variable que desea dividir. En este caso, se llama "q".

A continuación, añada el delimitador.

Por último, elija la variable en la que desea almacenar la matriz.

• "Dividir cadena" dividir: "Variable" "q" por: "Valor estático" "texto" ";" almacenar en: "w"

Visualización de las variables de la matriz

Si quieres asegurarte de que esto funciona, añade un texto variable a un paso. Luego, elige la variable que almacena el array.

Finalmente, abra el Tulip Player, y vea si todos los elementos del array aparecen como una lista con viñetas. Es posible que tenga que ampliar el cuadro de texto para tener en cuenta el número de elementos de la matriz.

Cuando se devuelve una matriz de un solo tipo de datos desde los conectores HTTP (texto, booleano, entero, etc.), la salida será una lista con viñetas, como se muestra en la sección anterior.

Visualización de arrays desde funciones de conectores SQL y HTTP

Cuando devuelves una matriz de objetos desde una función de conector HTTP o múltiples filas desde una función de conector SQL, una lista con viñetas no será una visualización ideal.

En su lugar, consulte esta guía separada para ver cómo convertir la salida de su función de conector en una lista interactiva o estática.

Revisión de todas las variables de la matriz en una aplicación

Para poder manipular una estructura de datos, é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.

Las matrices se mostrarán como "Matriz" en la columna "Tipo", dependiendo del tipo de valores que contengan. También puede crear valores por defecto para los índices del array.

Más información

• Cómo utilizar las salidas de las funciones del conector en las aplicaciones
• Cómo llamar a una función de conector utilizando disparadores
• 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.