Ordinal-Konfigurationseigenschaft verwenden
Viele Komponenten verwenden die Konfigurationseigenschaft ordinal, um die Reihenfolge festzulegen, in welcher Elemente in der Benutzeroberfläche der Komponente angezeigt werden. "Kacheln" verwenden beispielsweise die Ordinalzahl, um die Reihenfolge der Kacheln festzulegen, und in der Elementliste wird damit die Reihenfolge der Spalten festgelegt.
 |
Wenn Sie die Ordinal-Eigenschaft in einer benutzerdefinierten Implementierung einer Komponente verwenden, dürfen Sie die Werte 0 oder 1 nicht als Ordinalwerte verwenden. Der niedrigste Wert, der in diesem Fall für die Ordinal-Eigenschaft verwendet werden kann, ist 2.
Wird die Ordinal-Eigenschaft in einer vordefinierten Konfiguration verwendet, so können die Werte 0 und 1 als Ordinalwerte verwendet werden.
|
Das folgende Beispiel zeigt, wie der Ordinalwert in einer Komponentenkonfiguration angezeigt wird:
"items": [
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
Die Elemente im vorstehenden Beispiel werden in der Benutzeroberfläche in der Reihenfolge NonRecurringCost, RecurringCost, RequestPriority, Category angezeigt.
Wenn keine Ordinalwerte in der Komponentenkonfiguration definiert sind, werden die Elemente entsprechend ihrer Reihenfolge in der Konfiguration angezeigt. Wenn die Reihenfolge der Elemente auf der Anpassungsseite angepasst wird, werden die Ordinalwerte überschrieben, und die Reihenfolge in der Benutzeroberfläche spiegelt die Anpassung wider.
Nachfolgend finden Sie eine Liste möglicher Eingabefälle für Ordinalwerte und das in diesen Fällen erwartete Verhalten:
|
Fall
|
Beispiel für Ordinalwerte
|
Verhalten in der Benutzeroberfläche
|
|---|---|---|
|
Ordinalwerte sind sequenzielle Werte.
|
0 1 2 3
|
Elemente werden in der Reihenfolge der Ordinalwerte angezeigt.
|
|
Ordinalwerte sind nicht sequenzielle Werte.
|
2 5 7 8
|
Elemente werden in der Reihenfolge der Ordinalwerte angezeigt.
|
|
Zwei Elemente haben den gleichen Ordinalwert.
|
0 1 1 2
|
Elemente werden in der Reihenfolge der Ordinalwerte angezeigt. Elemente mit dem gleichen Ordinalwert werden entsprechend ihrer Reihenfolge in der Konfiguration angezeigt.
Während der Laufzeit wird die Informationsmeldung in der Protokolldatei protokolliert.
|
|
Ein oder mehrere Elemente haben keine Ordinalwerte.
|
0 1 [leer] 3
|
Elemente werden in der Reihenfolge der Ordinalwerte angezeigt. Elemente ohne Ordinalwerte werden zuletzt angezeigt. Wenn mehrere Elemente keine Ordinalwerte haben, werden sie am Ende entsprechend ihrer Reihenfolge in der Konfiguration angezeigt.
Während der Laufzeit wird die Informationsmeldung in der Protokolldatei protokolliert.
|
|
Ein oder mehrere Elemente haben ungültige Eingaben für Ordinalwerte.
Beachten Sie, dass negative Werte als ungültige Eingaben betrachtet werden.
|
0 1 “string” 3
|
Elemente mit ungültigen Ordinalwerten werden als Elemente behandelt, die keine Ordinalwerte haben. Sie werden zuletzt angezeigt, und wenn mehrere Elemente ungültige Ordinalwerte aufweisen, werden diese entsprechend ihrer Reihenfolge in der Konfiguration angezeigt.
Während der Laufzeit wird die Informationsmeldung in der Protokolldatei protokolliert.
|