外部識別子

ExternalIdentifier エンティティを使用すると、フィード作成者は任意のデータセットを 特定のオブジェクトとソース値のペアを結合します。ExternalIdentifierはしばしば コードを外部システムで関連付けて、 候補者、事務所、地政学的部門などのオブジェクトを含む法域。

注: このエンティティは、すべてのフィードタイプで同じです。

ExternalIdentifier エンティティの Type フィールドは、 識別子の「source」であり、識別されるオブジェクトではありません。たとえば、 組み込みタイプは fips です。これは「Federal Information」の略語です。 処理標準」state があります。FIPS の 2 桁のコードは 状態の説明に使用する場合、この状況で想定される Type 値は fips です。 であり、state ではありません。これは、fips が ID のソースを記述するためです。

外部 ID は、フィード全体で次の目的で使用されます。

• 固定の識別子を指定します。
• Open Civic などの外部リソースからの正規 ID を指定する データ識別子（FIPS コード）。
• NIST CDF スキーマにネイティブではない追加の属性を指定します。

オブジェクトの追加データやコンテキストを提供する場合、外部 識別子には other の Type を使用する必要があります。OtherTypeもあります と Value のどちらも、提供されるデータの種類によって異なります。1 つの この方法でデータを提供する方法については、 Office。

注: 複数形 ExternalIdentifiers は、 1 つ以上のイベントをラップするコレクション ExternalIdentifier 個のエンティティ。ExternalIdentifier が複数回出現しています サブエンティティを使用して、管轄区域を複数のコードに関連付けることができます。

属性

次の表に、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"
        }
      ]
    }