不変の識別子

不変 ID は、外部的に不変で、特定のオブジェクトの一意の識別子です。 渡されます。データ利用者は、これらを使用して共通データ形式のオブジェクトを調整できる （CDF）フィードを作成できます。データベース用語では、外部 識別子は外部キーの一種で、データ利用者はこれを使用して 他のデータベースにフィードできます。

たとえば “Robert Brady”がデータ コンシューマは その人物を「ボブ・ブレイディ」に取得されますただし、 CDF データと画像データベースから、この人物が 米国議会図書館の THOMAS データベースに登録されている議員 01469 です。その後 データ利用者は画像を候補とリンクさせることができます。

すべての不変の識別子について、次の条件が満たされる必要があります。

  • 安定性: 特定の固有のエンティティの不変の識別子（ Person または Party。データの異なるバージョン間では変更できません。 できます。つまり、特定のキーの固定 ID が時間とともに変化してはいけません。 エンティティです。
  • 一意性: 別のエンティティに対して不変の識別子を再利用しないでください。これには、 フィードに元のエンティティが存在しない場合
  • 一貫性: すべてのエンティティに同じ不変の識別子のセットを使用する必要があります。 （必要に応じて）両方のシミュレーションの候補者、政党、学区を編成すること。 決定します。

データ形式

次の形式で不変の識別子を指定します。

<ExternalIdentifier>
  <Type>other</Type>
  <OtherType>stable</OtherType>
  <Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>

固定 ID のわかりやすい例は、UUID（Universal Unique Identifier）です。 グローバル一意識別子（GUID）。次のようになります。

e55b7dd4-cc98-11ec-9d64-0242ac120002

データの読みやすさを向上させるには、接頭辞と名前を追加し、 エンティティをさらに分類できます。たとえば、per- 接頭辞を次の内容に追加します。 個人またはオフィスの off- は、固定 ID が あります。

推奨: per-e55b7dd4-cc98-11ec-9d64-0242ac120002

推奨: off-7849514a-e8bc-11ec-8fea-0242ac120002

推奨: per-123456789012345

非推奨例: per-john-doe

  • リスク: 同じ名前の人物が同じ ID を持つ可能性があります。
  • リスク: データを変更すると、Stable ID に影響する可能性があります。

非推奨例: 「off- Presidento-of-us」

固定 ID を使用する場所

次の要素では、不変の識別子が必須です。