Utilisation de tableaux dans les applications

Voici comment lire et écrire dans des tables à partir d’applications d’opérations de première ligne.

Dans ce guide, vous apprendrez…

• Comment lire des enregistrements de Table existants dans une application
• Comment mettre à jour des enregistrements de table existants dans une application
• Comment créer de nouveaux enregistrements de table dans une application
• Comment analyser les données des tables en fonction des actions effectuées dans l'application

Dans l'éditeur d'applications, vous pouvez lire, modifier et créer des enregistrements de table individuels. Comme les tables ne nécessitent aucun code, vous pouvez exécuter vos applications dans le Player et observer la mise à jour des tables en temps réel.

Ce guide présente les différentes façons d’utiliser conjointement les tableaux et les applications pour créer des applications plus performantes.

La lecture ou la mise à jour d'un enregistrement de table s'effectue en trois étapes :

1- Créez un « espace réservé d'enregistrement » pour attribuer un nom à cet enregistrement de table spécifique au sein de l'application

2- Chargez (ou créez) l’enregistrement dans une action de déclencheur

3a- Si vous souhaitez mettre à jour des champs individuels de l’enregistrement, incluez l’enregistrement de table dans une instruction « Then ».

3b- Si vous souhaitez écrire une logique autour des valeurs de l'enregistrement de table, incluez-le dans une instruction « Si »

Variables d’application et enregistrements de table

Lors de la création d’applications, vous devrez peut-être décider si une donnée spécifique doit être stockée dans une variable ou dans un enregistrement de table.

Les variables sont mieux adaptées aux données pertinentes pour l'utilisation individuelle de cette application particulière. Les tables sont mieux adaptées aux données auxquelles plusieurs applications doivent pouvoir accéder.

Les tables sont fréquemment utilisées pour suivre des éléments tels que :* les ordres de travail* les références (SKU) de produits individuels* les nomenclatures (BOM)* les matrices de compétences* … et bien plus encore

Avant de lire cet article, nous vous recommandons de consulter d’abord «Présentation des tables » afin de bien comprendre toutes les fonctionnalités des tables.

Étape 1 – Création d’un espace réservé d’enregistrement

Vous devez d’abord créer un «**espace réservé d’enregistrement »**dans l’application à partir de laquelle vous accéderez à l’enregistrement de la table. Il s’agit d’espaces réservés pour des enregistrements qui seront ensuite chargés dynamiquement dans la logique de déclenchement.

Par exemple, si vous souhaitez modifier un enregistrement de la table « Ordres de travail » dans une application, vous pouvez créer un espace réservé d’enregistrement intitulé « Ordre de travail actif ».

Vous chargerez ensuite un enregistrement de manière dynamique en fonction des données saisies par l’opérateur, mais il sera toujours référencé sous le nom « Ordre de travail actif »

Pour configurer ces espaces réservés, cliquez sur l’onglet « Enregistrements » situé à côté de la liste des étapes.

Choisissez ensuite « Ajouter une table ». Cliquez ensuite sur « Ajouter un espace réservé d’enregistrement ». Vous pourrez donner un nom à l’enregistrement que vous chargerez dynamiquement à partir d’un déclencheur (par exemple « Ordre de travail actif »).

Notez qu’il existe un paramètre « Enregistrer pour analyse ». Lorsqu’il est sélectionné, cela enregistre l’enregistrement de table chargé dans cet espace réservé d’enregistrement dans l’enregistrement d’achèvement de l’application.

Étape 2 – Accéder aux enregistrements dans l’éditeur de déclencheurs

Après avoir créé l’espace réservé d’enregistrement, vous pouvez désormais écrire la logique permettant de charger ou de créer dynamiquement des enregistrements en fonction des données saisies par l’opérateur.

Pour ce faire, vous pouvez utiliser les actions de déclencheur « Enregistrements de table » et « Manipulation des données ». Voici comment procéder.

Ajouter une instruction « Then »

Vous pouvez lire ou modifier des enregistrements de table à l’aide de plusieurs types d’actions de déclencheur. En voici un bref résumé.

Enregistrements de la table / Charger un enregistrement : charge un enregistrement existant avec un ID spécifique

Enregistrements de table / Créer un enregistrement : crée un nouvel enregistrement avec un ID spécifique

Enregistrements de table / Créer ou charger un enregistrement : SI un enregistrement avec un ID spécifique n'existe pas, le créer. Sinon, charger l'enregistrement avec un ID spécifique.

Chargement d’enregistrements existants

Pour lire ou modifier un enregistrement, vous devez d’abord le charger dans une application et lui attribuer un nom provisoire. Cette opération est souvent déclenchée par l’ouverture d’une étape ou l’appui sur un bouton.

Vous pouvez charger un enregistrement à la fois, et vous devez utiliser l’ID unique (premier champ de la table, valeur de type texte) pour sélectionner l’enregistrement.

Utilisez l’instruction « Table Records » « Load Record » pour effectuer cette opération.

{height="" width="600px"}* « Table Records »* « Load Record »* Par ID : « text » - 0146* Dans le nom de placeholder « active_wo »

Dans cet exemple, un enregistrement portant l’ID « 0146 » existe déjà dans une table d’ordres de travail.

Comme le champ « ID » de chaque table est un champ de texte, vous devez utiliser du texte pour accéder aux enregistrements individuels. Vous pouvez utiliser toutes les options habituelles pour choisir un ID :

• Enregistrement de la table
• Expression
• Valeur statique
• Informations sur l'application
• Variable

Voici un exemple d'utilisation d'une variable :

• « Enregistrements du tableau »
• « Charger un enregistrement »
• par ID : « Variable »
• « text_wo_id »
• vers : « Ordre de travail actif »

Création de nouveaux enregistrements

Si vous souhaitez créer un nouvel enregistrement dans une table, vous devez utiliser l’option « Créer » ou « Créer ou charger ».

Si vous utilisez « Créer », vous devez créer un nouvel enregistrement avec un ID qui n'existe pas encore dans la table. Si l'enregistrement existe déjà dans la table, l'application générera une erreur.

Si vous utilisez « Créer ou charger », un enregistrement avec un identifiant spécifique sera chargé s'il existe déjà, ou créé si cet identifiant n'existe pas dans la table.

Dans ce cas, nous utilisons l’ID « 123 » pour créer un nouvel enregistrement.

• « Enregistrements de la table » « Créer un enregistrement »
• par ID : « Valeur statique » « texte » « 123 »
• dans : « Ordre de travail actif »

En règle générale, vous devez utiliser une valeur dynamique dans ce champ, comme une variable, car chaque fois qu'un opérateur utilise l'application, vous souhaiterez créer une nouvelle valeur.

Étape 3a – Modification des enregistrements dans l’éditeur de déclencheurs

Pour modifier un enregistrement, utilisez l’action « Manipulation des données », puis « Enregistrer » pour modifier ou mettre à jour la valeur d’un enregistrement.

Pour modifier un enregistrement, celui-ci doit déjà avoir été chargé en tant qu’espace réservé via « Enregistrements de table » « Charger » ou « Enregistrements de table » « Créer ».

Voici un exemple dans lequel vous allez mettre à jour le champ « status » d’un enregistrement chargé sous le nom « active_wo ».

• « Manipulation des données »
• « Stocker »
• « Texte » : « Réussi »
• « Enregistrement de la table » « active_wo »
• Champ : « status »

On utilise généralement un déclencheur de widget pour cela, par exemple lorsqu’un opérateur appuie sur un bouton pour signaler un changement.

Vous pouvez également incrémenter une valeur à partir d’un enregistrement de table. Consultez ce guide sur les tables d’inventaire pour savoir comment procéder

Étape 3b – Utilisation de la logique conditionnelle avec les enregistrements de table

Vous pouvez également modifier la logique de l’application en fonction de la valeur d’un champ d’un enregistrement spécifique.

Pour ce faire, assurez-vous qu’un enregistrement a déjà été chargé. Sélectionnez ensuite un champ de cet enregistrement et utilisez la même logique que celle que vous utiliseriez dans n’importe quelle autre instruction « if ».

Enregistrement de table : vérifiez la présence d’une valeur spécifique dans le champ d’un enregistrement de table chargé.

{height="" width=""}* « Enregistrement de table » « active_wo » « status »* « Contient »* « Valeur statique » « texte » « Vérification réussie »

Table : Vérifier si un enregistrement avec un ID spécifique existe déjà dans une table.

• « Table » « workorders » « a un enregistrement avec l’ID » « Valeur statique » « texte » « 001 »

Voici comment vous pourriez créer un message d’erreur invitant l’opérateur à saisir un autre numéro d’ordre de travail.

IF* « Table » « workorders » « has record with id »* « Valeur statique » « texte » « 024dfg45 »

ALORS* « Afficher une erreur » « Valeur statique » « texte » « Cet ordre de travail existe déjà, veuillez en saisir un nouveau ».

Étape 4 – Affichage des enregistrements d’une table dans les étapes

Pour ajouter cet enregistrement à une étape, sélectionnez l’option « Enregistrement de table » sous le bouton « Texte » dans le menu des widgets.

Dans l’onglet « Widget » du volet de contexte, sélectionnez votre espace réservé d’enregistrement parmi les options situées à côté de « Enregistrement » pour l’afficher dans le lecteur.

Cette fonctionnalité est couramment utilisée pour afficher les détails d’un ordre de travail à un opérateur, par exemple.

Pour réorganiser ou supprimer des champs individuels de l’affichage, cliquez sur le « x » ou sur le symbole en forme de grille correspondant à la propriété dans le volet de contexte.

Pour modifier le nombre de colonnes, utilisez l’option « Colonnes » dans le volet latéral.

Pour modifier l’affichage des libellés et des valeurs, ajustez la couleur et la taille de la police dans le volet latéral.

Pour voir comment ces données s’afficheront à l’opérateur, lancez l’application dans le Player ; vous pourrez alors visualiser l’intégralité de l’enregistrement du tableau. Les valeurs s’afficheront si vous chargez au préalable un enregistrement.

Effacement des espaces réservés aux enregistrements

Il peut parfois être nécessaire de vider un emplacement de record afin qu’aucun enregistrement spécifique ne soit chargé dans l’application sous cet emplacement.

Voici comment procéder :

• « Enregistrements du tableau » « Effacer un emplacement d'enregistrement »

Suppression des espaces réservés aux enregistrements

Pour supprimer un espace réservé d’enregistrement, sélectionnez-le dans la liste des enregistrements située à gauche de l’écran. Dans l’exemple ci-dessous, vous choisiriez « Ordre de travail actif ».

Sélectionnez ensuite « Supprimer » dans le menu qui s'affiche.

Affichage des utilisateurs et de leurs champs

Vous pouvez également créer une « Record Placeholder » pour les utilisateurs et leurs champs associés, puis charger un utilisateur spécifique à l’aide de la table intégrée. Pour plus de détails, consultez le guide dédié aux champs utilisateur.

Lectures complémentaires

• Créer votre premier tableau (guide pas à pas): un guide complet expliquant comment utiliser conjointement les tableaux et les applications
• Affichage de listes d'enregistrements dans les applications: utilisation du widget de tableau interactif pour afficher simultanément de nombreux enregistrements d'un tableau

Avez-vous trouvé ce que vous cherchiez ?

Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d’autres utilisateurs ont rencontré un problème similaire !