등록 정보 설명은 공통 기본 이벤트 스펙으로 정의됩니다.
등록 정보 설명은 이벤트가 포함할 수 있는 등록 정보에 대해 설명합니다.
이는 단순 유형으로서 공통 기본 이벤트 스펙으로 정의된 모든 등록 정보일 수
있습니다. 등록 정보 설명은 msgDataElement와 같은 복합 등록 정보를
설명할 수는 없으나 복합 등록 정보의 하위 항목인 단순 등록 정보는 설명할 수
있습니다. 이벤트 정의에는 임의의 수의 등록 정보 설명(없음 포함)가
포함될 수 있습니다.
등록 정보 설명은 다음 필드를 포함합니다.
- name
- 등록 정보의 이름. 이는 CommonBaseEvent 요소의 속성 이름 또는
CommonBaseEvent의 복합 하위 요소 속성이어야 합니다.
몇 가지 예로는 심각도, 우선순위 및 globalInstanceId가 있습니다.
- path
- 등록 정보가 CommonBaseEvent의 속성이 아닌 경우 등록 정보에
대한 경로를 지정하는 XPath 위치 경로. 경로는 설명되는 등록 정보의
상위 등록 정보를 식별합니다. 예는 다음과 같습니다.
- 심각도와 같은 CommonBaseEvent의 등록 정보를 설명하려면
경로를 지정하지 마십시오. 널 경로는 맨 위 레벨 등록 정보를 지정합니다.
- CommonBaseEvent의 복합 등록 정보인 msgDataElement의 등록 정보를
설명하려면 경로 msgDataElement를 지정합니다.
- 그 자체가 msgDataElement의 복합 등록 정보인 msgHelp의
등록 정보를 설명하려면 경로 msgDataElement/msgHelp를 지정하십시오.
경로는 반복된 등록 정보의 특정 인스턴스도 설명할 수 있습니다.
예를 들어 이벤트 정의가 여러 contextDataElements 등록 정보를 설명하는 경우 businessContext라는
하나의 등록 정보를 지정하고 경로 contextDataElements[@name='businessContext']를 사용할 수 있습니다.
- defaultValue
- 등록 정보의 기본값. 기본값은 필수 등록 정보가 누락된
이벤트의 컨텐츠 완료 시 사용되어야 하는 값을
나타냅니다. (따라서 등록 정보 설명이 필수이고 기본값을 정의하는
경우에 의미가 있습니다.) 이 필드는 선택적입니다.
- required
- 등록 정보가 필수인지 아니면 선택적인지를 지정하는 부울 값.
이 필드가
true인 경우 등록 정보는 필수입니다. 이 필드는 선택적이어서, 지정되지 않으면
등록 정보는 선택적인 것으로 가정됩니다.
- permittedValue
- 등록 정보에 허용되는 값. 이벤트 정의에서 등록 정보에 대해
특정 값만 허용하는 경우, 각각의 값은 등록 정보 설명에서 permittedValue
필드로 표시됩니다. 등록 정보 설명은 임의의 수의 허용된 값을
포함할 수 있습니다. 이 필드는 선택적이며, minValue 또는 maxValue 필드가
지정되는 경우 지정해서는 안됩니다.
- minValue
- maxValue
- 등록 정보에 허용되는 최소 및 최대값. 이벤트 정의가
등록 정보에 대해 값 범위를 허용하는 경우, 이러한 필드는 해당
범위의 하한 및 상한을 정의합니다. minValue만 지정하면
허용되는 범위에 상한이 없으며, 비슷하게 maxValue만 지정하면
허용되는 범위에 하한이 없습니다. 이들 필드는 선택적이며 permittedValue 필드가
지정되는 경우 지정해서는 안됩니다.