Внешний идентификатор

Сущность ExternalIdentifier позволяет создателям фидов связывать произвольные наборы пар «источник-значение» с определенными объектами. ExternalIdentifier — это код юрисдикции во внешней системе, используемый для сопоставления юрисдикции с такими объектами, как кандидаты, должности или геополитические единицы.

Поле Type сущности ExternalIdentifier используется для описания источника идентификатора, а не идентифицируемого объекта. Например, два из встроенных типов — это fips , аббревиатура от "Federal Information Processing Standard" (код федерального стандарта обработки информации), и state . Хотя для описания штатов можно использовать двухзначные коды FIPS, в данном случае значением Type должно быть fips , а не state . Это потому, что fips описывает источник идентификатора.

В ленте используются внешние идентификаторы в следующих целях:

  • Предоставьте стабильный идентификатор .
  • Укажите канонический идентификатор из внешнего источника, например, из базы данных Open Civic Data Identifiers или кода FIPS.
  • Укажите дополнительные атрибуты, которые не являются встроенными в схему NIST CDF.

При использовании для предоставления дополнительных данных или контекста для объекта внешние идентификаторы должны иметь Type other . Они также включают в себя 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"
        }
      ]
    }