Comment utiliser les tableaux dans les applications

Vue d'ensemble

Voici comment stocker des données dans un tableau dans Tulip et déplacer des valeurs d'un type de données à un autre.

Dans cet article, vous apprendrez...

• Comment créer et utiliser des tableaux
• Comment modifier les tableaux dans l'éditeur de triggers
• Utiliser le split string pour transformer la sortie d'une Connector Function en tableau.

Lestableaux et les objets sont deux structures de données populaires qui sont utilisées dans de nombreux langages de programmation. Tulip utilise ces structures de données dans deux parties de la plate-forme :

1. Les variables, pour stocker plusieurs points de données liés à la même variable.
2. Les connecteurs, pour passer la sortie d'une fonction Connecteur à une variable.

Les tableaux peuvent être créés :

1. Dans l'éditeur de déclencheurs (manuellement)
2. Dans l'éditeur d'expression (manuellement)
3. dans la vue Résumé des variables (illustrée ci-dessous) (manuellement).
4. En stockant la sortie d'une entrée Multiselect.
5. En stockant la sortie d'une fonction de connecteur SQL qui renvoie plusieurs lignes ou un connecteur HTTP avec un tableau dans le JSON qui est renvoyé (automatiquement).

Création de tableaux

Dans l'éditeur de déclencheurs

Vous pouvez créer un tableau en utilisant l'action "Push onto Array".

• Données "Arrays" "Push Onto Array" : "Static Value" "text" "text" array : (créer un tableau ici)

Dans l'éditeur d'expression

Vous pouvez créer un nouveau tableau via l'action "Data Manipulation" "Store". Comme ceci :

• "Manipulation de données" "Store" data : "Expression" "[1,2,3]" emplacement : "test_array"

Chaque tableau ne peut avoir qu'un seul type de valeur, c'est-à-dire des chaînes de caractères ou des entiers.

Dans la vue Résumé des variables

Naviguez jusqu'à la vue Résumé des variables dans l'onglet "App" du Volet contextuel, puis créez une nouvelle variable en haut de la modale :

Manipulation des tableaux

Vous pouvez créer et manipuler des tableaux dans l'éditeur de déclencheurs. Dans une instruction "Then", cliquez sur "Add new Action", puis choisissez l'option "Arrays".

Dans la liste déroulante suivante, vous verrez une variété de méthodes de tableau. Celles-ci s'alignent sur les méthodes de tableau en JavaScript, alors consultez ce guide des méthodes de tableau si vous avez besoin de plus d'explications.

Les méthodes de tableau disponibles sont les suivantes

1. Effacer un tableau
2. Concaténation de tableaux
3. Obtenir à partir d'un index dans un tableau
4. Obtenir la longueur du tableau
5. Insérer à l'index dans le tableau
6. Joindre à une chaîne
7. Pop du tableau
8. Push sur un tableau
9. Retirer et stocker l'élément à l'index du tableau
10. Remove at index in Array
11. Set index in Array
12. Somme de Array
13. Échanger des éléments dans un tableau

En fonction de votre sélection dans cette liste déroulante, le reste des champs vous donnera des options sur le tableau que vous souhaitez manipuler, l'indice que vous souhaitez modifier et la nouvelle valeur que vous définissez.

• Données "Arrays" "Set Index in Array" : "Valeur statique" "nombre" "90" tableau : "test_a" index : "Static Value" "integer" "0"

Dans l'exemple ci-dessus, vous changez la valeur à l'indice 0 dans un tableau appelé "test_a" en une valeur de 90.

• "Arrays" "Get from index in Array" array : "Variable" "test_a" index : "Valeur statique" "entier" "0" stocker dans la variable : "test_vari"

Dans l'exemple ci-dessus, vous accédez à la valeur à l'indice 0 d'un tableau appelé "test_a" et la stockez dans une variable appelée "test_vari".

Recherche dans les tableaux

Supposons que vous souhaitiez utiliser un widget multisélection pour permettre à un opérateur de saisir plusieurs types de défauts concernant un seul produit. Ensuite, en fonction des défauts qu'il saisit, vous souhaitez l'envoyer vers un ensemble spécifique d'étapes de reprise.

Un formulaire multi-sélection enregistre automatiquement les valeurs dans un tableau. Vous devrez donc rechercher une valeur spécifique dans ce tableau, puis envoyer l'opérateur à une étape spécifique.

Vous pouvez utiliser l'action Trigger "Join To String" pour y parvenir. Cette action combinera tous les éléments d'un tableau en une seule chaîne de caractères, et la stockera dans une variable distincte. Ensuite, dans un autre Trigger, vous pouvez utiliser une instruction "If" pour vérifier si cette chaîne contient une valeur spécifique.

Les éléments du tableau peuvent être séparés par n'importe quelle chaîne de caractères de votre choix. La plupart des utilisateurs de Tulip préfèrent une virgule (,).

Voici un exemple de jointure de tous les éléments d'un tableau en une chaîne de caractères :

• "Arrays" "Join To String" join : "types de défauts"
• avec délimiteur : "Valeur statique" "texte" ","
• stocker dans : "types_de_défauts_joints"

Voici le deuxième déclencheur que vous utiliserez pour rechercher une valeur spécifique dans cette nouvelle chaîne :

IF

• "La variable "defect_types_joined" "contient" la valeur statique "text" "chip".

Utilisation de Split String pour créer des tableaux

D'après tout ce que nous avons vu jusqu'à présent, il serait très difficile d'obtenir la sortie de certains types de fonctions connecteurs dans un tableau. Pour résoudre ce problème, vous pouvez utiliser Split String.

Si vous voulez préparer la sortie de votre fonction de connexion à être stockée dans un tableau, vous devez ajouter un caractère commun entre chaque élément de données. Voici quelques exemples courants :

• Point-virgule ( ;)
• Virgule (,)
• Caractère de nouvelle ligne ("\n")

Supposons que vous ayez une série de points de données que vous souhaitez stocker dans un tableau. Dans votre requête SQL ou votre demande HTTP GET, vous voudrez d'abord les combiner en une seule chaîne, si elles ne sont pas déjà stockées dans un objet.

Voici un exemple :

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

Le délimiteur commun est le point-virgule.

Dans l'éditeur de déclencheurs, vous voudrez utiliser l'option "Split String" pour convertir cette chaîne en tableau.

Sélectionnez d'abord la variable que vous souhaitez diviser. Dans ce cas, elle s'appelle "q".

Ensuite, ajoutez le délimiteur.

Enfin, choisissez la variable dans laquelle vous souhaitez stocker le tableau.

• "Split String" split : "Variable" "q" by : "Valeur statique" "texte" " ;" stocker dans : "w"

Affichage des variables de tableau

Si vous voulez vous assurer que cela fonctionne, ajoutez du texte variable à une étape. Ensuite, choisissez la variable qui stocke le tableau.

Enfin, ouvrez le lecteur Tulip, et voyez si tous les éléments du tableau apparaissent sous forme de liste à puces. Il se peut que vous deviez agrandir la zone de texte afin de tenir compte du nombre d'éléments du tableau.

Lorsque vous retournez un tableau d'un seul type de données à partir de connecteurs HTTP (texte, booléen, entier, etc.), la sortie sera une liste à puces, comme indiqué dans la section ci-dessus.

Affichage de tableaux à partir de fonctions SQL et de connecteurs HTTP

Lorsque vous renvoyez un tableau d'objets à partir d'une fonction de connecteur HTTP ou plusieurs lignes à partir d'une fonction de connecteur SQL, une liste à puces ne constitue pas un affichage idéal.

Consultez plutôt ce guide distinct pour savoir comment transformer la sortie de votre fonction de connexion en une liste interactive ou statique.

Examen de toutes les variables de tableau dans une application

Pour pouvoir manipuler une structure de données, celle-ci doit déjà être stockée sous forme de variable. Vous pouvez voir vos variables existantes en entrant dans le volet contextuel de l'éditeur d'application, et en sélectionnant le symbole Sigma à côté de "Variables" dans l'onglet App.

Les tableaux seront affichés comme "Tableau" dans la colonne "Type", en fonction du type de valeurs qu'ils contiennent. Vous pouvez également créer des valeurs par défaut pour les indices du tableau.

Autres lectures

• Comment utiliser les sorties des fonctions du connecteur dans les applications ?
• Comment appeler une fonction de connexion à l'aide de déclencheurs ?
• Guide de l'éditeur d'expressions dans l'éditeur d'applications

Vous avez trouvé ce que vous cherchiez ?

Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres ont été confrontés à une question similaire !