Migliori pratiche per la denominazione degli elementi in Tulipano

Scopo

Esaminare le nostre migliori pratiche per la denominazione degli elementi personalizzati in Tulip come punto di partenza per le vostre applicazioni e convenzioni di denominazione.

Tutti gli elementi personalizzati, ad esempio variabili, fasi, record, ecc., in Tulip devono essere denominati in modo da renderli leggibili, non ambigui e comprensibili per facilitare l'usabilità delle applicazioni durante il loro ciclo di vita.

Si raccomanda di adottare le seguenti convenzioni generali di denominazione per tutti gli elementi:

• Nome descrittivo
• Parole scritte per intero, senza abbreviazioni
• Prima lettera di ogni parola in maiuscolo, lettere successive in minuscolo
• Singole parole separate da uno spazio

Le sezioni seguenti illustrano alcune linee guida più dettagliate per elementi specifici.

Variabili

I nomi delle variabili devono essere unici per un'App, tuttavia gli stessi nomi possono essere riutilizzati all'interno della piattaforma Tulip.

• Il tipo di variabile non è incluso nel nome
• Abbreviazioni di unità di misura scritte tra parentesi accanto al nome delle variabili numeriche

Industrie regolamentate

Si consiglia di memorizzare un valore e la sua unità di misura in due campi variabili/registro tabella separati, ad esempio "Peso totale" e "Peso totale_UOM". Per ulteriori informazioni, consultare le Best Practice per la creazione di applicazioni GxP.

Variabili utilizzate per filtrare le tabelle

Le variabili utilizzate per filtrare una tabella rispetto a una colonna specifica devono essere denominate con il prefisso "Filter". Questo migliora l'usabilità di tali variabili durante la creazione dell'applicazione. Questo è consigliato per le variabili utilizzate esclusivamente per il filtraggio. Le variabili di uso generale nelle applicazioni non necessitano di un prefisso.

Variabili per gli indicatori chiave

Per le applicazioni con indicatori chiave, ad esempio CPP/CQA (Critical Process Parameters / Critical Process Attributes) o KPI, aggiungere un prefisso ai nomi delle variabili per migliorarne la leggibilità.

Tabelle

I nomi delle tabelle devono essere adattati alla stessa convenzione di denominazione utilizzata per le variabili e devono essere raggruppati con un prefisso. Le tabelle devono essere raggruppate in base allo scopo generale, ad esempio casi d'uso multipli/tutti i casi d'uso, o a casi d'uso specifici. Si raccomanda di usare '

' per il raggruppamento generale e non usare '*'. Il simbolo '*' viene utilizzato da Tulip per contrassegnare le tabelle provenienti dalle applicazioni della libreria Tulip.

Trigger

Si sconsiglia di usare il nome predefinito "trigger senza nome". Il nome di un trigger dovrebbe invece descrivere la sua funzionalità in poche parole.