Personalização avançada > Usando componentes reutilizáveis > Informações de configuração adicionais > Usando o campo de configuração ordinal
  
Usando o campo de configuração ordinal
Muitos componentes reutilizáveis usam o campo de configuração ordinal para definir a ordem na qual os elementos aparecem na interface do usuário do componente. Por exemplo, o componente de Bloco usa o ordinal para definir a ordem dos blocos e o componente da Barra de ações o usa para definir a ordem das ações. Para todos os componentes reutilizáveis além da Barra de ações, somente os valores não negativos para o ordinal têm suporte e os valores negativos são tratados como entradas inválidas. A Barra de ações tem suporte a valores ordinais negativos. Todos os componentes reutilizáveis têm suporte a zero como um valor ordinal.
A seguir, veja um exemplo de como o ordinal aparece em uma configuração de componente:
"items": [
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
Os itens no exemplo acima aparecem na interface do usuário na ordem NonRecurringCost, RecurringCost, RequestPriority, Category.
Se não houver nenhum valor ordinal definido na configuração de componente, os itens aparecerão de acordo com a ordem na configuração. Se a ordem dos itens for adaptada na página de adaptação, os valores ordinais serão substituídos e a ordem na interface do usuário refletirá a adaptação.
A seguir, há uma lista de possíveis casos de entrada para valores ordinais e o que é esperado nestes casos:
Caso
Exemplo de valores ordinais
Comportamento na interface do usuário
Os valores de pedidos são valores sequenciais.
1 2 3 4
Os itens aparecem na ordem dos valores ordinais.
Os valores de pedidos são valores não sequenciais.
2 5 7 8
Os itens aparecem na ordem dos valores ordinais.
Dois itens têm o mesmo valor ordinal.
1 2 2 4
Os itens aparecem na ordem dos valores ordinais. Itens com o mesmo valor ordinal aparecem de acordo com a ordem na configuração.
Durante o tempo de execução, a mensagem de INFO é registrada no arquivo de log.
Um ou mais itens não têm valores ordinais.
1 2 [vazio] 4
Os itens aparecem na ordem dos valores ordinais. Os itens sem os valores ordinais aparecem por último. Se múltiplos itens não tiverem valores ordinais, eles aparecerão no final, de acordo com a ordem na configuração.
Durante o tempo de execução, a mensagem de INFO é registrada no arquivo de log.
Um ou mais itens têm entradas inválidas para valores ordinais.
1 2 “string” 3
Os itens com valores ordinais inválidos são tratados como itens que não têm valores ordinais. Eles aparecem por último e, no caso de múltiplos itens com valores ordinais inválidos, eles aparecem de acordo com a ordem na configuração.
Durante o tempo de execução, a mensagem de INFO é registrada no arquivo de log.