Personalizzare ThingWorx Navigate > Creare task personalizzati > Utilizzare i componenti ThingWorx Navigate in un task personalizzato > Configurare i componenti > Utilizzare la proprietà di configurazione ordinale
  
Utilizzare la proprietà di configurazione ordinale
Molti componenti utilizzano la proprietà di configurazione ordinal per impostare l'ordine di visualizzazione degli elementi nell'interfaccia utente del componente. Ad esempio, Riquadri utilizza l'ordinale per impostare l'ordine dei riquadri mentre Elenco elementi lo utilizza per impostare l'ordine delle colonne.
* 
Quando si utilizza la proprietà ordinale in un'implementazione personalizzata di un componente, non utilizzare i valori 0 o 1 come valori ordinali. Il valore minimo che è possibile utilizzare per la proprietà ordinale in questo caso è 2.
Quando si utilizza la proprietà ordinale in una configurazione predefinita, si possono utilizzare i valori 0 e 1 come valori ordinali.
Di seguito è riportato un esempio di come l'ordinale viene visualizzato in una configurazione di un componente:
"items": [
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
Gli elementi nell'esempio precedente vengono visualizzati nell'interfaccia utente nell'ordine NonRecurringCost, RecurringCost, RequestPriority e Category.
Se nella configurazione del componente non sono presenti valori ordinali definiti, gli elementi vengono visualizzati in base al relativo ordine nella configurazione. Se l'ordine degli elementi viene personalizzato nella pagina di personalizzazione, i valori ordinali vengono ignorati e l'ordine nell'interfaccia utente riflette la personalizzazione.
Di seguito è riportato un elenco di possibili casi di input per i valori ordinali e gli elementi previsti in questi casi:
Caso
Esempio di valori ordinali
Comportamento nell'interfaccia utente
I valori dell'ordine sono valori sequenziali.
0 1 2 3
Gli elementi vengono visualizzati nell'ordine dei valori ordinali.
I valori dell'ordine sono valori non sequenziali.
2 5 7 8
Gli elementi vengono visualizzati nell'ordine dei valori ordinali.
Due elementi hanno lo stesso valore ordinale.
0 1 1 2
Gli elementi vengono visualizzati nell'ordine dei valori ordinali. Gli elementi con lo stesso valore ordinale vengono visualizzati in base al relativo ordine nella configurazione.
Durante la fase di esecuzione, il messaggio INFO viene registrato nel file di log.
Uno o più elementi non hanno valori ordinali.
0 1 [vuoto] 3
Gli elementi vengono visualizzati nell'ordine dei valori ordinali. Gli elementi senza valori ordinali vengono visualizzati per ultimi. Se più elementi non hanno valori ordinali, vengono visualizzati alla fine, in base al relativo ordine nella configurazione.
Durante la fase di esecuzione, il messaggio INFO viene registrato nel file di log.
Uno o più elementi hanno input non validi per i valori ordinali.
Si noti che i valori negativi vengono considerati input non validi.
0 1 “string” 3
Gli elementi con valori ordinali non validi vengono trattati come elementi che non hanno valori ordinali. Vengono visualizzati per ultimi e, nel caso di più elementi con valori ordinali non validi, vengono visualizzati in base al relativo ordine nella configurazione.
Durante la fase di esecuzione, il messaggio INFO viene registrato nel file di log.