Construire votre première table (Walkthrough)

Ce guide vous apprendra à utiliser la fonctionnalité Tables pour stocker des données dans plusieurs apps.

Dans cet article, vous apprendrez

• Comment créer un tableau type "Bons de travail".
• Comment lire, créer et modifier un enregistrement dans ce tableau via l'éditeur de déclencheurs.

Note : Ce sujet est présenté dans la section "Working With Data and Tables" de Tulip University.

Sans l'utilisation de la Table, vous pouvez avoir des difficultés à mettre à jour des données qui sont utilisées dans plusieurs applications d'opérations de première ligne dans Tulip.

Par exemple, vous pouvez vouloir lire et modifier une nomenclature ou un bon de travail dans plusieurs applications qui fonctionnent dans votre atelier.

Vous pourriez créer une base de données SQL et appeler des fonctions Connector pour mettre à jour les lignes d'une table. Vous pourriez aussi utiliser un connecteur HTTP pour lire/écrire à partir d'un ERP.

Mais cela vous oblige à écrire du code.

La fonction Table vous permet de créer des tables que vous pouvez lire et modifier via les applications Tulip.

Aucun code n'est nécessaire, et vous pouvez les utiliser instantanément dans vos apps d'opérations de première ligne.

Dans ce guide, nous allons vous montrer les bases des tableaux en créant un exemple de tableau qui stocke les bons de travail et vous permet ensuite d'utiliser ces bons de travail dans les applications.

À la fin de ce tutoriel, le tableau "Bons de travail" ressemblera à ceci :

Il comportera 8 colonnes :

• ID (texte)
• Produit (texte)
• Description (texte)
• Couleur (texte)
• Taille (nombre)
• Quantité (nombre)
• Matériau (texte)
• Défaut (booléen)

Vous apprendrez comment :

• lire ces enregistrements et utiliser les valeurs existantes dans vos applications
• Modifier les enregistrements existants
• Créer de nouveaux enregistrements

Vous pouvez modifier les tableaux à partir de deux parties de Tulip :

• L'option "Tables" sous l'onglet "Apps" de la barre de menu.
• L'éditeur de déclencheurs dans l'éditeur d'applications

Créer une nouvelle table

Voici comment créer la table "Bons de travail". Cliquez sur l'option "Tables" sous l'onglet "Apps".

Ensuite, utilisez le bouton Créer un tableau en haut à droite de la liste des tableaux, et nommez le nouveau tableau "Bons de travail".

Cliquez ensuite sur le nouveau tableau Commandes de travail dans la liste pour commencer à le modifier.

Pour commencer, vous aurez 0 enregistrement et une seule colonne, ID, qui est un champ de texte. Il s'agit d'un domaine dans lequel les tableaux diffèrent des tableaux d'une base de données traditionnelle : chaque "enregistrement", ou ligne du tableau, doit avoir une valeur textuelle unique plutôt qu'une valeur numérique unique.

Vous souhaitez ajouter quelques champs supplémentaires. Pour ajouter des champs à la table, cliquez sur le bouton "+" à côté de l'ID. Vous devez sélectionner un type de champ et une étiquette.

Ajoutez les champs suivants à votre tableau :

• ID (texte)
• Produit (texte)
• Description (texte)
• Couleur (texte)
• Taille (nombre)
• Quantité (nombre)
• Matériau (texte)
• Défaut (booléen)

Si vous voulez le tester, cliquez sur "Créer un enregistrement" en haut à droite de la page.

Une fois que vous êtes satisfait du tableau, allez dans l'éditeur d'applications pour connecter le tableau à une application spécifique.

Connexion des tableaux à une application

Maintenant, vous devez créer la logique pour que les applications puissent lire et/ou mettre à jour le tableau.

C'est peut-être la partie la plus importante de l'utilisation des tableaux dans les applications.

Après avoir ouvert une application, cliquez sur l'onglet Enregistrements à côté de l'onglet Étapes.

Ensuite, sélectionnez "+ Ajouter un enregistrement".

Il s'agit du créateur de l'enregistrement Placeholder. Considérez-le comme un outil permettant de nommer le type d'enregistrements que vous allez charger à partir d'une table.

Dans ce cas, vous souhaitez charger dynamiquement un bon de travail spécifique lorsqu'un opérateur utilise l'application.

Donc, nommez l'enregistrement Placeholder "Work Order In Progress" et sélectionnez la table "Work Orders".

Cela signifie que nous sommes sur le point d'écrire la logique qui sélectionnera de manière dynamique un bon de travail spécifique, et y fera référence en tant que "Bon de travail en cours".

Voici comment fonctionne le Record Placeholder :

Si vous voulez lire ou modifier un enregistrement existant, vous devez charger cet enregistrement dans l'application et lui donner un nom de placeholder. L'espace réservé à l'enregistrement vous permettra de suivre plus facilement votre logique lorsque vous l'examinerez dans l'éditeur de déclencheurs.

Dans l'image ci-dessus, vous allez charger l'enregistrement avec l'id "val1" et le nommer "Work Order in Progress".

Chargement des enregistrements

Voici ce qui se passe lorsque vous souhaitez charger un enregistrement afin de le lire ou de le modifier.

Modification des enregistrements

Si vous souhaitez modifier l'enregistrement après son chargement, il vous suffit de choisir l'enregistrement stocké sous un nom générique donné.

Création d'un nouvel enregistrement

Si vous souhaitez créer un nouvel enregistrement dans une table, vous devez également le charger avec un nom de placeholder, ce qui l'ajoutera à la table appropriée.

Reprenons notre exemple. Vous voulez d'abord charger dynamiquement un enregistrement avec le nom générique "Bon de travail en cours".

Tout d'abord, vous voudrez ajouter l'espace réservé "Bon de travail en cours" à votre application afin que les opérateurs puissent voir l'enregistrement spécifique qui provient de la table "Bons de travail".

Pour ce faire, sélectionnez l'option "Enregistrement du tableau" sous l'en-tête Texte dans le menu Widget.

Ensuite, sélectionnez "Bon de travail en cours" dans la liste déroulante Enregistrement de l'onglet Widget du Volet contextuel. Il se peut que vous deviez agrandir la zone de texte pour faire tenir toutes les étiquettes et les valeurs.

Modification des tableaux dans l'éditeur de déclencheurs

Tout d'abord, nous devons ajouter un enregistrement au tableau pour pouvoir l'utiliser dans notre application.

Retournez dans la table "Work Orders" et créez un enregistrement pour un cadre de vélo.

Il doit ressembler à ceci, avec l'ID "0146".

Ensuite, retournez à l'étape dans l'éditeur d'application et créez un déclencheur d'étape.

Vous allez d'abord charger l'enregistrement correct en tant que "Bon de travail en cours" afin de pouvoir le mettre à jour ultérieurement.

Paramétrez le déclencheur pour qu'il se déclenche "à l'ouverture de l'étape". Choisissez ensuite "Table Records" dans la première liste déroulante de l'instruction "Then", et choisissez "Load Record".

Choisissez ensuite "Static Value", "Text" et entrez "0146" dans le champ "Work Order in Progress". Cliquez sur "Save".

Ensuite, si vous exécutez cette application dans le lecteur, vous verrez toutes les données de l'enregistrement avec l'ID "0146" dans l'application. Le Trigger les tire de la bonne table.

Vous ne pouvez charger et modifier qu'un seul enregistrement à la fois par placeholder. Toutefois, vous pouvez créer plusieurs espaces réservés et modifier plusieurs enregistrements à la fois en utilisant plusieurs instructions "then" dans un déclencheur.

Modification d'un enregistrement

Dans cet exemple, un produit a été modifié et nous devons mettre à jour ce vélo pour qu'il soit "bleu" au lieu de "vert". Voici comment nous allons procéder.

Vous allez modifier cet enregistrement en changeant le champ "Couleur" de "Bleu" en "Vert". Pour ce faire, ajoutez d'abord un bouton "Changer la couleur", et attachez un déclencheur.

Choisissez "Data Manipulation" dans la première liste déroulante d'une instruction "Then", puis choisissez "Store" et "Static Value" "Text" avec le mot "Blue".

Sélectionnez un emplacement de "Table Record" et ensuite "Work in Progress", et vous verrez alors une série d'options.

Les options de la liste déroulante sont toutes les zones de texte de la table "Bons de travail". Puisque vous avez déjà chargé le bon de travail le plus pertinent, vous pourrez changer sa couleur en sélectionnant "Couleur", puis "Enregistrer". Lancez l'application et appuyez sur le bouton pour l'essayer.

En cliquant sur le bouton, vous enregistrerez "Bleu" dans le champ "Couleur" du "Bon de travail en cours", qui sera ensuite transmis à l'enregistrement correct dans la table des Bons de travail.

Création d'un nouvel enregistrement

Si vous êtes certain qu'un enregistrement avec un ID spécifique n'existe pas encore et que vous voulez le créer, choisissez l'option "Table Records" dans une instruction "Then", puis sélectionnez "Create Record".

Ensuite, vous devez créer un ID unique, dans ce cas, "0148".

Ensuite, choisissez l'emplacement où vous souhaitez charger le nouvel enregistrement. Cette opération remplacera l'enregistrement chargé à l'aide du nom de l'espace réservé, puis enverra le nouvel enregistrement avec un simple ID et des valeurs vides dans tous les autres champs vers la table appropriée.

Si vous souhaitez modifier les valeurs de l'enregistrement, utilisez la méthode de "modification" décrite ci-dessus pour changer les valeurs une par une.

Déclarations conditionnelles utilisant des enregistrements

Sélectionnez "Enregistrement de table", choisissez l'emplacement de votre enregistrement, puis sélectionnez l'un des champs pour créer la logique. Assurez-vous d'avoir chargé un enregistrement à l'aide du caractère générique de l'enregistrement avant d'utiliser les conditions, sinon les champs "Enregistrement du tableau" seront vides.

Autres lectures

• Comment modifier les tables dans l'éditeur d'applications
• Comment analyser les enregistrements de la table en même temps que les données de l'application ?
• Affichage de listes d'enregistrements dans les 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 !