외부 식별자

ExternalIdentifier 항목을 사용하면 피드 생성자가 임의의 소스-값 쌍 집합을 특정 객체와 연결할 수 있습니다. ExternalIdentifier는 후보자, 사무실, 지정학적 단위와 같은 객체를 관할 구역과 연결하는 데 사용되는 외부 시스템의 관할 구역 코드인 경우가 많습니다.

ExternalIdentifier 항목의 Type 필드는 식별되는 객체가 아닌 식별자의 소스를 설명하는 데 사용됩니다. 예를 들어 내장 유형 중 두 가지는 '연방 정보 처리 표준' 코드의 약어인 fips와 state입니다. FIPS 두 자리 코드를 사용하여 주를 설명할 수 있지만 이 상황에 적합한 Type 값은 state이 아닌 fips입니다. fips는 식별자의 소스를 설명하기 때문입니다.

외부 식별자는 피드 전체에서 다음 용도로 사용됩니다.

  • 안정적인 식별자를 제공합니다.
  • Open Civic Data 식별자 또는 FIPS 코드와 같은 외부 리소스의 표준 식별자를 제공합니다.
  • NIST CDF 스키마에 포함되지 않는 추가 속성을 제공합니다.

객체에 대한 추가 데이터나 컨텍스트를 제공하는 데 사용되는 경우 외부 식별자는 other의 Type를 사용해야 합니다. 또한 제공된 데이터 유형에 따라 달라지는 OtherType와 Value도 포함됩니다. 이러한 방식으로 데이터를 제공하는 방법의 예는 Office을 참고하세요.

속성

다음 표에서는 ExternalIdentifier의 속성을 설명합니다.

속성 필수 여부 유형 설명
label 선택사항 string 정보 라벨입니다. 필요에 따라 사용합니다.

요소

다음 표에는 ExternalIdentifier의 요소가 나와 있습니다.

요소 다중성 유형 설명
Type 1 IdentifierType 식별자 유형을 제공합니다.
OtherType 0 또는 1 string IdentifierType 값이 other인 경우에 사용됩니다.
Value 1 string 관할 구역에서 사용하는 식별자입니다.

예

XML

    <ExternalIdentifiers>
     <ExternalIdentifier>
        <Type>other</Type>
        <OtherType>stable</OtherType>
        <Value>stable-gu-0081</Value>
      </ExternalIdentifier>
      <ExternalIdentifier>
        <Type>ocd-id</Type>
        <Value>ocd-division/country:ke/county:narok</Value>
      </ExternalIdentifier>
      <ExternalIdentifier>
        <Type>national-level</Type>
        <Value>33</Value>
      </ExternalIdentifier>
    </ExternalIdentifiers>

JSON

    "ExternalIdentifiers": {
      "ExternalIdentifier" : [
        {
          "Type": "other",
          "OtherType": "stable",
          "Value": "stable-gu-0081"
        },
        {
          "Type": "ocd-id",
          "Value": "ocd-division/country:ke/county:narok"
        },
        {
          "Type": "national-level",
          "Value": "33"
        }
      ]
    }