外部标识符

ExternalIdentifier 实体可让 Feed 创建者将任意一组 特定对象的“来源-值”对。ExternalIdentifier经常是 外部系统中的代码,用于将 司法管辖区。

ExternalIdentifier 实体的 Type 字段用于描述 标识符的来源,而不是正在标识的对象。例如, 内置类型为 fips,它是“Federal Information”的缩写 “Processing Standard”和 state。尽管 FIPS 两位数代码可以 用于描述状态,在这种情况下的预期 Type 值为 fips 而不是 state。这是因为 fips 描述的是标识符的来源。

整个 Feed 中都会出于以下目的使用外部标识符:

  • 提供稳定的标识符
  • 提供来自外部资源(例如 Open Civic)的规范标识符 数据标识符或 FIPS 代码。
  • 提供非 NIST CDF 架构原生的其他属性。

用于为对象提供其他数据或上下文时,外部 标识符需要使用值为 otherType。还包含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"
        }
      ]
    }