ExternalIdentifier
實體可讓動態饋給創作者將
與特定物件的來源/值組合配對ExternalIdentifier
是經常出現
管轄區內的程式碼,這類管轄區的用途是連結
列有候選人、公職人員或地緣政治單位等物品的管轄區。
ExternalIdentifier
實體的 Type
欄位可用來描述
識別物件的 來源,而非所識別物件。例如,假設有
內建類型為 fips
,即「Federal Information」的縮寫
「Processing Standard」程式碼和 state
雖然 FIPS 2 碼代碼的
用於說明狀態,此時的 Type
值是 fips
而非 state
。這是因為 fips
說明 ID 的來源。
在動態饋給中,外部 ID 會用於下列目的:
- 提供穩定的 ID。
- 提供外部資源 (例如 Open Civic) 的標準 ID 資料 ID 或 FIPS 程式碼。
- 請提供不屬於 NIST CDF 結構定義的其他屬性。
當你用來提供物件的其他資料或背景資訊時,
ID 必須使用 other
的 Type
。此版本也包含OtherType
和 Value
,這兩者都取決於提供的資料類型。對於
以這種方式提供資料的範例,請參閱
Office
。
屬性
下表說明 ExternalIdentifier
的屬性:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
label |
選用 | string |
資訊標籤。供需要時使用。 |
元素
下表列出 ExternalIdentifier
的元素:
元素 | 多重性 | 類型 | 說明 |
---|---|---|---|
Type |
1 | IdentifierType |
提供 ID 類型。 |
OtherType |
0 或 1 | string |
當 IdentifierType 的值為
other 。 |
Value |
1 | string |
管轄區使用的 ID, |
範例
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" } ] }