고급 사용자 지정 > 재사용 가능 컴포넌트 사용 > 추가 구성 정보 > 서수 구성 필드 사용
  
서수 구성 필드 사용
여러 재사용 가능 컴포넌트에서 ordinal 구성 필드를 사용하여 컴포넌트 사용자 인터페이스에 요소가 표시되는 순서를 설정할 수 있습니다. 예를 들어, 타일 컴포넌트는 서수를 사용하여 타일 순서를 설정하고 작업 모음 컴포넌트는 서수를 사용하여 작업 순서를 설정합니다. 작업 모음 외에 모든 재사용 가능 컴포넌트에서는 음수가 아닌 값이 서수로 지원되며 음수 값은 잘못된 입력으로 처리됩니다. 작업 모음은 음수 서수 값을 지원하지 않습니다. 모든 재사용 가능 컴포넌트는 0을 서수 값으로 지원합니다.
다음은 컴포넌트 구성에 서수가 표시되는 방법에 대한 예입니다.
"items": [
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
위의 예에 나오는 항목은 NonRecurringCost, RecurringCost, RequestPriority, Category 순서로 사용자 인터페이스에 표시됩니다.
컴포넌트 구성에 정의된 서수 값이 없으면 구성에 나온 순서에 따라 항목이 표시됩니다. 수정 페이지에서 항목 순서가 수정되면 서수 값이 재정의되고 사용자 인터페이스에 표시되는 순서에 수정 내용이 반영됩니다.
다음은 서수 값으로 가능한 입력 사례와 이러한 사례에서 예상되는 상황을 보여주는 목록입니다.
사례
서수 값의 예
사용자 인터페이스의 동작
순서 값이 연속적인 값입니다.
1 2 3 4
서수 값의 순서대로 항목이 표시됩니다.
순서 값이 비연속적인 값입니다.
2 5 7 8
서수 값의 순서대로 항목이 표시됩니다.
두 항목의 서수 값이 동일합니다.
1 2 2 4
서수 값의 순서대로 항목이 표시됩니다. 동일한 서수 값을 가진 항목이 구성에 있는 해당 순서대로 표시됩니다.
런타임에 정보 메시지가 로그 파일에 기록됩니다.
하나 이상의 항목에 서수 값이 없습니다.
1 2 [비어 있음] 4
서수 값의 순서대로 항목이 표시됩니다. 서수 값이 없는 항목이 마지막에 표시됩니다. 여러 항목에 서수 값이 없으면 구성에 있는 해당 순서대로 마지막에 표시됩니다.
런타임에 정보 메시지가 로그 파일에 기록됩니다.
하나 이상의 항목에 잘못된 서수 값 입력이 있습니다.
1 2 “string” 3
서수 값이 잘못된 항목은 서수 값이 없는 항목으로 처리됩니다. 이러한 항목은 마지막에 표시되고, 잘못된 서수 값을 가진 여러 항목은 구성에 있는 해당 순서대로 표시됩니다.
런타임에 정보 메시지가 로그 파일에 기록됩니다.