외부 식별자

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

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

외부 식별자는 피드 전체에서 다음과 같은 목적으로 사용됩니다.

  • 안정적인 식별자를 제공합니다.
  • Open Civic Data Identifiers 또는 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"
        }
      ]
    }