ExternalIdentifier
实体可让 Feed 创建者将任意一组
特定对象的“来源-值”对。ExternalIdentifier
经常是
外部系统中的代码,用于将
司法管辖区。
ExternalIdentifier
实体的 Type
字段用于描述
标识符的来源,而不是正在标识的对象。例如,
内置类型为 fips
,它是“Federal Information”的缩写
“Processing Standard”和 state
。尽管 FIPS 两位数代码可以
用于描述状态,在这种情况下的预期 Type
值为 fips
而不是 state
。这是因为 fips
描述的是标识符的来源。
整个 Feed 中都会出于以下目的使用外部标识符:
- 提供稳定的标识符。
- 提供来自外部资源(例如 Open Civic)的规范标识符 数据标识符或 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" } ] }