Comment utiliser les sorties des fonctions des connecteurs dans les applications ?

Objectif

Les fonctions des connecteurs SQL et HTTP envoient des "sorties" aux applications sous forme d'objets ou de tableaux. Apprenez à manipuler ces objets dans les applications.

Dans cet article, vous apprendrez...
* Comment utiliser les "sorties" d'une fonction Connecteur dans une application.

Comment utiliser les sorties d'une fonction Connecteur dans une application ?

Lestableaux et les objets sont deux structures de données populaires qui sont utilisées dans de nombreux langages de programmation. Tulip utilise ces deux structures de données dans les fonctions connecteurs :

1. Lorsqu'une fonction de connexion SQL renvoie plusieurs lignes, la sortie est envoyée à une application sous la forme d'un tableau rempli d'objets.
2. Lorsqu'une fonction de connexion HTTP renvoie une sortie contenant un tableau, ce tableau apparaît dans l'application comme un tableau d'objets.
3. Lorsqu'une fonction de connecteur SQL renvoie une seule ligne, ou qu'une fonction de connecteur HTTP renvoie n'importe quelle sortie, les valeurs sont stockées sous forme de paires clé/valeur dans un objet.

Les objets ne peuvent être créés automatiquement qu'à l'issue d'une fonction de connexion réussie.

Ce guide vous montrera comment les sorties de la fonction Connecteur sont automatiquement organisées. Ensuite, vous verrez comment utiliser ces résultats dans les applications.

Collecte des résultats des connecteurs

Imaginons que vous souhaitiez extraire d'une base de données SQL toutes les données relatives à un opérateur spécifique en fonction de l'identifiant de son badge Tulip.

Pour ce faire, vous écrivez une fonction de connecteur SQL qui prend l'identifiant du badge en entrée et enregistre toutes les informations relatives à l'opérateur dans une sortie. Dans ce cas, la sortie s'appelle nom_groupe. Voici à quoi cela ressemblerait :

Cette fonction a une sortie, nom_du_groupe, qui est stockée comme une chaîne de caractères. Ceci est basé sur l'étiquette "Text" dans la section Outputs.

En fait, lorsque vous créez une fonction Connecteur, vous n'avez pas la possibilité de stocker la sortie sous forme de tableau ou d'objet. Voici les types de données autorisés dans la section "Outputs".

Vous devez donc la stocker en tant que "Texte", puis la manipuler dans l'éditeur de déclencheurs.

Exécutez cette fonction dans l'éditeur de déclencheurs pour stocker la sortie dans un objet.

• "Exécuter la fonction du connecteur" connecteur : "SBD - Test" "Navigation de l'opérateur".
• ID du badge : "Valeur statique" "texte" "2222" et enregistrer le résultat sous : "Variable" "test_var"

Dans ce cas, vous utilisez une valeur de 2222 comme entrée, et vous enregistrez le résultat dans une variable appelée "test_var".

Utilisation d'objets dans une application

Dans l'exemple ci-dessus, nous avons pris une sortie appelée nom_du_groupe et l'avons enregistrée dans une variable appelée test_var. La vue des variables de l'application montre que cette variable est en fait un objet avec une propriété appelée "group_name".

En fait, si la fonction de connexion avait plusieurs sorties, chacune d'entre elles serait enregistrée comme une nouvelle propriété de l'objet appelé "test_var" qui a été créé dans le déclencheur. Cela vous permet d'organiser toutes les sorties d'un appel de fonction en un seul endroit.

Vous pouvez tester les sorties de la fonction en ajoutant un texte variable à votre application, puis en sélectionnant la variable dans l'onglet Widget du volet contextuel.

Dans ce cas, nous avons une variable appelée "Order Details" qui stocke un objet avec 5 champs :

• orderPlaced
• quantité
• adresse 1
• adresse2
• adresse3

Dès que vous aurez sélectionné l'objet dans la zone de recherche Variables, vous verrez les 5 champs se remplir dans votre application avec des étiquettes basées sur les noms des propriétés. Vous devrez peut-être développer le champ de texte des variables pour les voir toutes en même temps.

Affichage des objets

Si votre objet possède plusieurs propriétés, vous pouvez souhaiter les afficher toutes en même temps à une étape de votre application. Cela est plus facile que de créer un nouveau texte variable pour chaque propriété individuelle.

Pour réorganiser/supprimer des propriétés individuelles de l'objet, cliquez sur le symbole x ou le symbole de grille sur la propriété dans le volet contextuel.

Pour modifier le nombre de colonnes, utilisez l'option Colonnes du volet contextuel.

Pour modifier l'affichage des étiquettes et des valeurs, ajustez la couleur et la taille de la police dans le Volet contextuel.

Pour voir comment ces données seront présentées à l'opérateur, exécutez l'application dans le lecteur, et vous pourrez voir l'objet entier. Les valeurs seront incluses si vous exécutez d'abord la fonction de connexion qui rassemble les valeurs.

Manipulation des objets

L'utilisation d'un tableau d'objets dans votre application peut limiter vos possibilités d'extraire les points de données que vous essayez de cibler. Vous pouvez manipuler un tableau d'objets généré par une fonction de connexion pour faciliter l'accès aux données que vous souhaitez utiliser dans votre logique, etc. Pour ce faire, vous devez spécifier la ou les clés d'un objet que vous souhaitez extraire. Cela contribuera à rationaliser la sortie des données et vous permettra de mieux exploiter les données qui vous intéressent.

Un exemple de fonction de connexion est présenté ci-dessous :

Le résultat ci-dessus est un tableau d'objets. Lorsque les fonctions de connecteur renvoient un tableau d'objets, l'éditeur d'expression propose des actions qui permettent de les manipuler. Ces fonctions de mappage vous permettent de mapper les valeurs correspondantes en fonction d'une clé donnée. Les valeurs renvoyées peuvent être mises en correspondance avec un tableau du type sélectionné. Vous pouvez utiliser MAP_TO_TEXT_LIST() pour obtenir un tableau de texte contenant tous les titres.

• Connecteur "Run Connector Function" : "Test" "Test Function" et enregistrer le résultat sous : "test_output"
• "Manipulation de données" "Stocker" les données : "Expression" "MAP_TO_TEXT_LIST(Variable.test_outout.Test Parent, 'Test Child')

Le premier paramètre passé dans la fonction map est le tableau d'objets. Le deuxième paramètre, 'Test Child', est le nom de l'extracteur indiqué dans la sortie de la fonction de connexion. Le nom de l'extracteur est utilisé comme clé pour extraire les valeurs. Cela produira tous les titres dans un tableau de chaînes de caractères.

Examen de toutes les variables d'objet dans une application

Pour pouvoir manipuler une structure de données dans une application, elle doit déjà être stockée en tant que 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 objets seront affichés avec le symbole universel d'objet, "{}".

Affichage de plusieurs lignes de SQL ou de tableaux à partir de connecteurs HTTP

Si vous souhaitez transformer plusieurs lignes de données SQL ou des tableaux provenant de connecteurs HTTP en listes interactives dans une application, consultez ce guide séparé.

Autres lectures

• Comment utiliser les tableaux dans les applications
• Comment appeler une fonction de connecteur à l'aide de déclencheurs
• Guide de l'éditeur d'expressions dans l'App Editor

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 !