外部 ID

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 必須使用 otherType。此版本也包含OtherTypeValue,這兩者都取決於提供的資料類型。對於 以這種方式提供資料的範例,請參閱 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"
        }
      ]
    }