Ecco come leggere e scrivere nelle tabelle dalle app operative in prima linea.

In questa guida imparerai...
- Come leggere i record esistenti di una tabella in un’app
- Come aggiornare i record delle tabelle esistenti in un’app
- Come creare nuovi record di una tabella in un'app
- Come analizzare i dati nelle tabelle in base al completamento delle app
Nell’App Editor puoi leggere, modificare e creare singoli record delle tabelle. Poiché le tabelle non richiedono alcun codice, puoi eseguire le tue app nel Player e osservare l’aggiornamento delle tabelle in tempo reale.
Questa guida illustrerà i vari modi in cui è possibile utilizzare le tabelle e le app insieme per creare app più potenti.
Ci sono tre passaggi per leggere o aggiornare qualsiasi record di tabella:
1- Creare un “Segnaposto del record” per assegnare un nome a quel particolare record della tabella all’interno dell’app
2- Caricare (o creare) il record in un’azione di trigger
3a- Se si desidera aggiornare singoli campi del record, includere il record della tabella in un’istruzione “Then”.
3b- Se si desidera scrivere una logica basata sui valori presenti nel record della tabella, includere il record della tabella in un'istruzione “If”
Variabili dell’app e record di tabella
Quando si creano app, potrebbe essere necessario decidere se un dato specifico debba essere memorizzato in una variabile o in un record di tabella.
Le variabili sono più adatte per i dati rilevanti per l’utilizzo individuale di quella particolare app. Le tabelle sono più adatte per i dati a cui devono accedere più app.
Le tabelle vengono spesso utilizzate per tenere traccia di concetti quali:* Ordini di lavoro* SKU dei singoli prodotti* Distinta base (BOM)* Matrice delle competenze* ...e molto altro ancora
Prima di leggere questo articolo, è consigliabile leggere "Panoramica sulle tabelle " per comprendere appieno le funzionalità delle tabelle.
Passaggio 1 - Creazione di un segnaposto per il record
Per prima cosa, dovrai creare un**“Segnalibro del record”**nell’app in cui accederai al record della tabella. Si tratta di segnaposto per i record che verranno successivamente caricati dinamicamente nella logica di trigger.
Ad esempio, se si desidera modificare un record dalla tabella “Ordini di lavoro” in un’app, si potrebbe avere un segnaposto per record denominato “Ordine di lavoro attivo”.
In seguito caricheresti un record dinamicamente in base all’input dell’operatore, ma verrebbe sempre indicato come “Ordine di lavoro attivo”

Per configurare questi segnaposto, fare clic sulla scheda “Record” accanto all’elenco dei passaggi.

Quindi scegli “Aggiungi una tabella”. Successivamente, clicca su “Aggiungi un segnaposto record”. Potrai assegnare un nome al record che verrà caricato dinamicamente da un trigger (ad esempio “Ordine di lavoro attivo”).

Si noti che è presente un’impostazione denominata “Salva per analisi”. Se selezionata, questa opzione salverà il record della tabella caricato in questo segnaposto record nel record di completamento dell’app.
Passaggio 2 - Accesso ai record nell’editor dei trigger
Dopo aver creato il segnaposto del record, è ora possibile scrivere la logica per caricare o creare dinamicamente i record in base all’input dell’operatore.
A tal fine, è possibile utilizzare le azioni del trigger "Record della tabella" e "Manipolazione dei dati". Ecco come procedere.
Aggiungere un'istruzione "Then"
È possibile leggere o modificare i record della tabella con diversi tipi di azioni trigger. Ecco un breve riepilogo.
Record della tabella/Carica record: carica un record esistente con un ID specifico
Record tabella/Crea record: crea un nuovo record con un ID specifico
Record della tabella/Crea o carica record: SE non esiste un record con un ID specifico, crearlo. Altrimenti, caricare il record con un ID specifico.
Caricamento di record esistenti
Per leggere o modificare un record, è necessario prima caricarlo in un'app e assegnargli un nome provvisorio. Questa operazione viene spesso attivata dall'apertura di un passaggio o dalla pressione di un pulsante.
È possibile caricare un record alla volta ed è necessario utilizzare l’ID univoco (primo campo della tabella, valore di tipo testo) per selezionare il record.
Per farlo, utilizzare l’istruzione “Record della tabella” “Carica record”.
{height="" width="600px"}* "Record della tabella"* “Carica record”* Per ID: “testo” - 0146* Nel segnaposto “active_wo”
In questo esempio, nella tabella degli ordini di lavoro esiste già un record con ID "0146".

Poiché il campo “ID” in ogni tabella è un campo di testo, è necessario utilizzare il testo per accedere ai singoli record. È possibile utilizzare tutte le opzioni tipiche per selezionare un ID:
- Record della tabella
- Espressione
- Valore statico
- Informazioni sull'app
- Variabile
Ecco un esempio in cui viene utilizzata una variabile:

- "Record della tabella"
- "Carica record"
- per ID: "Variabile"
- "text_wo_id"
- in: "Ordine di lavoro attivo"
Creazione di nuovi record
Se si desidera creare un nuovo record in una tabella, è necessario utilizzare l'opzione "Crea" o "Crea o carica".
Se si utilizza "Crea", è necessario creare un nuovo record con un ID che non esista già nella tabella. Se il record esiste già nella tabella, l'app genererà un errore.
Se si utilizza "Crea o carica", verrà caricato un record con un ID specifico se già esistente, oppure verrà creato se l’ID non è presente nella tabella.
In questo caso, utilizziamo l’ID “123” per creare un nuovo record.

- "Record della tabella" "Crea record"
- per ID: "Valore statico" "testo" "123"
- in: "Ordine di lavoro attivo"
Di norma, in questo campo è necessario utilizzare un valore dinamico, come una variabile, poiché ogni volta che un operatore utilizza l’app, si vorrà creare un nuovo valore.

Passaggio 3a - Modifica dei record nell'editor dei trigger
Per modificare un record, utilizzare l’azione “Manipolazione dati”, quindi “Salva” per modificare o aggiornare il valore in un record.
Per modificare un record, è necessario che sia già stato caricato come segnaposto tramite "Record della tabella" "Carica" o "Record della tabella" "Crea".
Ecco un esempio in cui aggiornerai il campo “status” di un record caricato come “active_wo”.

- “Manipolazione dati”
- “Salva”
- "Testo": "Superato"
- "Record della tabella" “active_wo”
- Campo: “status”
In genere si utilizza un trigger widget per eseguire questa operazione, ad esempio quando un operatore preme un pulsante per segnalare una modifica.

È anche possibile incrementare un valore da un record della tabella. Consulta questa guida alle tabelle di inventario per scoprire come
Passaggio 3b - Utilizzo della logica condizionale con i record di tabella
Potresti anche voler modificare la logica dell’app in base al valore contenuto in un campo di un record specifico.
Per farlo, assicurati che un record sia già stato caricato. Quindi, seleziona un campo dal record e utilizza la stessa logica che useresti in qualsiasi altra istruzione "if".
Record della tabella: verifica la presenza di un valore specifico nel campo di un record della tabella caricato.
{height="" width=""}* “Record della tabella” “active_wo” “status”* “Contiene”* "Valore statico" "testo" "Superato"
Tabella: verifica se in una tabella esiste già un record con un ID specifico.

- "Tabella" "ordini di lavoro" "ha un record con id" "Valore statico" "testo" "001"
Ecco come si potrebbe creare un messaggio di errore che richieda all’operatore di inserire un numero di ordine di lavoro diverso.

IF* "Tabella" "ordini di lavoro" "ha un record con id"* "Valore statico" "testo" "024dfg45"
ALLORA* "Mostra errore" "Valore statico" "testo" "Questo ordine di lavoro esiste già, inserirne uno nuovo".
Passaggio 4 - Visualizzazione dei record della tabella nei passaggi
Per aggiungere questo record a un passo, seleziona l’opzione “Record della tabella” sotto il pulsante “Testo” nel menu dei widget.

Nella scheda "Widget" del pannello di contesto, selezionare il segnaposto del record dalle opzioni accanto a "Record" per visualizzarlo nel lettore.

Questo viene comunemente utilizzato, ad esempio, per visualizzare i dettagli di un ordine di lavoro a un operatore.
Per riordinare o rimuovere singoli campi dalla visualizzazione, fare clic sulla x o sul simbolo della griglia sulla proprietà nel pannello di contesto.

Per modificare il numero di colonne, utilizzare l’opzione Colonne nel riquadro laterale.

Per modificare la visualizzazione delle etichette e dei valori, regolare il colore e la dimensione del carattere nel riquadro laterale.

Per vedere come questi dati verranno mostrati all’operatore, esegui l’app nel Player: potrai così visualizzare l’intero record della tabella. I valori saranno inclusi se prima carichi un record.
Cancellazione dei segnaposto dei record
A volte, potresti voler cancellare un segnaposto del record in modo che non vi sia alcun record specifico caricato nell’app sotto quel segnaposto.
Ecco come procedere:

- "Record della tabella" "Cancella segnaposto del record"
Eliminazione dei segnaposto dei record
Per eliminare un segnaposto record, seleziona il segnaposto dall'elenco dei record sul lato sinistro dello schermo. Nell'esempio riportato di seguito, dovresti selezionare "Ordine di lavoro attivo".
Quindi, selezionare "Elimina" dal menu che appare.

You must first remove the record placeholder from all triggers where it is referenced. You can use the "Steps where used" list to find the steps with the triggers that need to be modified.
Visualizzazione degli utenti e dei relativi campi
È inoltre possibile creare una tabella incorporata ( Record Placeholder ) per gli utenti e i relativi campi, quindi caricare un utente specifico tramite la tabella incorporata. Per ulteriori dettagli, consultare la guida dedicata ai campi utente.
Ulteriori approfondimenti
- Crea la tua prima tabella (guida passo passo): una guida completa su come utilizzare insieme tabelle e app
- Visualizzazione di elenchi di record nelle app: utilizzo del widget tabella interattiva per visualizzare contemporaneamente molti record della tabella
Hai trovato quello che cercavi?
Puoi anche visitare community.tulip.co per pubblicare la tua domanda o verificare se altri hanno affrontato un problema simile!
