Migliori pratiche per la denominazione degli elementi in Tulipano
  • 01 Nov 2022
  • 2 Minuti da leggere
  • Contributori

Migliori pratiche per la denominazione degli elementi in Tulipano


Article Summary

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
EsempioProblemaEsempio migliore
FattoNon descrittivoOperazione conclusa
operatorNameMinuscolo e senza spazioNome dell'Operatore

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
EsempioProblemaEsempio migliore
Per le industrie regolamentate, vedere il commento qui sotto.Peso totale (g)
fltTemperatureFDigitare il nome, senza spazi e con unità di misura errataPer le industrie regolamentate, vedere la sottosezione successivaTemperature (°F)

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.

EsempioProblemaEsempio migliore
Temperatura (°F)Solo una variabile utilizzata per il valore e l'unità di misuraTemperatura Temperatura_UOM

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.

EsempioProblemaEsempio migliore
Filtro di statoSuffisso senzaFilter_Status
Filtro IPCtimestampSuffisso vs. prefisso
Minuscolo e senza spazioFilter_IPC Timestamp

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à.

EsempioProblemaEsempio migliore
Temperatura CPPIl prefisso non è chiaramente separato dal nome della variabileTemperatura CPP (°C)
AssayB_CQAUso come suffisso invece che come prefissoCQA_Assay B
DisponibilitàManca il prefisso per l'indicatore chiaveKPI_Disponibilità

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.

EsempioProblemaEsempio migliore
Tabella_etichette_stampateUso del suffisso #Etichette_stampate
*Etichette_stampateUso del prefisso '*'#Etichette_stampate

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.

Esempio, problema, nome migliore.
Trigger senza nomeNome predefinitoIncrementa il contatore dei difetti
Controlla lo statoTroppo poco contestoControlla lo stato di consegna dell'ordine

Questo articolo è stato utile?