Un modo per archiviare a lungo termine i dati delle tue app Tulip è tramite le “Conclusioni delle app”. Questo articolo ti mostrerà come fare.
In questo articolo imparerai:* Perché la tua app dovrebbe avere un pulsante “Completa”* I diversi tipi di trigger per il completamento dell’app* Quali dati vengono salvati al completamento o all’annullamento di un’app* Le migliori pratiche per il completamento delle app
Read more about [completions](/r230/docs/<span translate=)">Completions data.
Come completare un'app
Per salvare le informazioni da un’app Tulip, un operatore deve “completare l’app”. Per abilitare questa funzione, è necessario aggiungere un pulsante “Completa” alla propria app.
Ogni volta che un operatore utilizza il pulsante “Completa”, verrà aggiunta una nuova riga nella scheda “Completamenti”. Ogni riga contiene i seguenti valori:
- Informazioni sul completamento dell’app, come il nome della stazione, l’ID badge dell’operatore e la data/ora di inizio e fine dell’app.
- Tutte le variabili e i relativi valori al momento del completamento dell’app.
- Opzionale: è possibile scegliere di includere eventuali record di tabella caricati nell’app al momento del completamento, affinché vengano archiviati
Ogni variabile definita nell’app (ad es. codice a barre, operatore connesso, tempo impiegato, risultato dell’ispezione) costituirà una colonna in questa vista. Quando un operatore “completa l’app”, viene creata un’altra riga nell’elenco.
I valori in tutti i passaggi del modulo verranno memorizzati e cancellati quando completi un'app.
Infatti, se si accede alla scheda «Completamenti» in ogni singola app, è esattamente ciò che si vedrà.

Esistono diversi modi per “completare l’app” una volta che un operatore ha terminato di utilizzarla.
È possibile utilizzare il pulsante "Completa " integrato nell’Editor dell’app oppure creare un trigger personalizzato con una transizione "completa l’app".
Pulsante "Completa"
Selezionare " Pulsanti " dalla barra degli strumenti e scegliere "Completa".

È possibile aggiungere manualmente la transizione di completamento dell’app tramite il pulsante "Aggiungi nuove transizioni":

Utilizza un trigger personalizzato:
Nel caso sopra riportato, la logica del pulsante "Completa" è impostata di default su:
- Quando"viene premuto il pulsante";
- Allora, "App" -> "Completa app".

Tuttavia, è possibile aggiungere questa transizione a qualsiasi trigger che corrisponda alla fine del flusso di lavoro. Ad esempio:

- Quando, "Dispositivo", "GPIO", emette un segnale in "questa stazione" con l'evento "pin abbassato"
- Se, "Uscita dispositivo" "pin" "=" "Valore statico" "intero" "2"
- Allora, "App" "Completa app"
In questo esempio, qualsiasi dispositivo IoT che invii un segnale di pin abbassato al pin 2 del gateway I/O GPIO in questa fase farà sì che l’app venga completata.
Oltre a "Completa app", ci sono altre 2 opzioni:
Completa e poi passa a: completa l’app e poi passa a un’altra app.
"Completa e passa a un passaggio": completa l’app, quindi passa a un altro passaggio all’interno della stessa app o a un passaggio specifico in un’altra app.
Completa e vai alla schermata iniziale: completa l’app, quindi passa alla schermata iniziale dell’app. L’app non si avvierà finché un operatore non premerà il pulsante “Inizia”.
Completa e disconnetti l’utente corrente: completa l’app e disconnette l’utente corrente
Completa, poi passa all’app in base al nome: completa l’app, poi passa a un’altra app che può essere specificata tramite un valore proveniente dall’app in una variabile, ecc.
Completa e poi vai al passaggio specificato per nome: completa l’app e poi passa a un altro passaggio nella stessa app che può essere specificato tramite un valore dell’app contenuto in una variabile, ecc.
Nota: le app possono essere completate solo quando vengono eseguite dal Tulip Player. Una volta completata l’app, l’operatore vedrà un messaggio come quello mostrato di seguito.

Annullare un'app
Supponiamo che NON si desideri salvare i dati relativi a una determinata sessione di utilizzo di un'app. In questo caso, sarà opportuno "annullare l'app" e probabilmente tornare a un passaggio specifico. Ciò cancellerà tutti i dati raccolti dall'ultima apertura dell'app.
Esistono 5 transizioni di trigger che corrispondono direttamente alle transizioni di trigger relative al completamento dell’app:

- Annulla app
- Annulla e poi passa a
- Annulla e passa al passaggio
- Annulla e vai alla schermata iniziale
- Annulla e poi disconnetti l'utente corrente
Dettagli tecnici sul completamento dell'app
Ecco tutti i dati che vengono salvati automaticamente ad ogni completamento o annullamento dell'app:
- Ora di inizio: data e ora in cui l’operatore ha aperto il primo passaggio
- Ora di fine: la data e l’ora in cui l’operatore ha premuto il pulsante “Completa” o “Annulla”
- Durata: il tempo intercorso tra l’ora di inizio e quella di fine
- Utente connesso: in base all’ID del badge della persona che ha effettuato l’accesso a Tulip Player
- Nome della postazione: il nome della postazione in cui è stata utilizzata l’app, come specificato nella scheda “Reparto di produzione”
- Commenti: eventuali commenti relativi all’app nel suo complesso inseriti nel menu del Player
- Versione: la versione dell’app al momento del completamento
- Annullata: se l’app è stata annullata o meno
- ID di esecuzione: l’ID univoco di quella specifica esecuzione dell’app
- Nome dell’ultimo passaggio visualizzato: il nome dell’ultimo passaggio visualizzato prima che un utente completasse o annullasse l’app
Migliori pratiche
Nella configurazione dell’area di produzione, è prassi comune assegnare la “versione pubblicata più di recente” di un’app a livello di gruppo di stazioni o di una stazione specifica.
Affinché una stazione inizi a eseguire la versione pubblicata più di recente, deve verificarsi una delle seguenti condizioni:
- L'app venga riavviata tramite Menu / Riavvia app.
- Venga utilizzata una transizione "App / Completa app...".
- Venga utilizzata una transizione "App / Annulla app...".
Per questo motivo, è buona prassi assicurarsi che l’app Tulip utilizzi tale transizione in un determinato momento del suo utilizzo.
:::(Avviso) (Utilizzare "App / Completa app" sulle app headless)
Se si utilizza un'“app headless” (ad es. per eseguire trigger di Macchine e Dispositivi), si consiglia di aggiungere un trigger Timer per eseguire una transizione “App / Completa app” a intervalli regolari.
A condizione che la Tulip Station sia assegnata a "Most recently published version", ciò garantirà che l’app venga eseguita su quella istanza di Tulip Station più recente (recently-published version), oltre a mitigare eventuali problemi causati da potenziali perdite di memoria.
:::
Eliminazione dei dati al completamento delle app
Per conformarsi agli standard GxP di produzione, i dati in Tulip non possono essere eliminati.
Tuttavia, esiste una soluzione alternativa. È possibile copiare l’app ed eliminare quella precedente; in questo modo si otterrà una nuova tabella priva di voci.
Nascondere i dati dei completamenti da Analytics
È probabile che si desideri omettere alcuni dati della scheda «Completamenti» dall’analisi. Ora è possibile farlo individuando il record che si desidera omettere nella scheda «Completamenti» e deselezionando la casella «Includi nell’analisi». In questo modo l’analisi verrà filtrata in modo da non includere tale record.

L’esclusione di questo record dall’analisi non lo rimuoverà dai dati relativi ai completamenti, pertanto le esportazioni di questi dati non ne risentiranno.
Approfondimenti
{{snippet.Hai trovato quello che cercavi?}}
