穩定 ID

穩定版 ID 是外部固定為特定指定 ID 的外部不重複 ID 物件。可讓資料用戶協調採用通用資料格式的物件 (CDF) 動態饋給。在資料庫對應中,外部 ID 是一種外鍵,可讓資料使用者 會將 CDF 資訊提供中的物件傳送到其他資料庫

舉例來說,假設「Robert Brady」資料使用者 立即將對方連結到「Bob Brady」映像檔資料庫不過 根據 CDF 資料和圖像資料庫,可看出 美國國會圖書館 THOMAS 資料庫加以確認。接著 資料使用者就能將圖片與候選人連結。

所有固定 ID 都必須符合下列條件:

  • 穩定性:特定不重複實體的穩定 ID,例如 PersonParty,不得跨不同版本的資料變更 動態饋給換句話說,在某個應用程式的 實體。
  • 獨特性:切勿將固定 ID 重複用於不同實體, 。
  • 一致性:對於以下項目,必須使用相同的固定 ID: 可進行兩種模擬的候選人、政黨或學區 (如有需要), 選舉期間。

設定資料格式

請以下列格式提供固定 ID:

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

通用專屬 ID (UUID) 和 全域專屬 ID (GUID)。如下所示:

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

為提高資料可讀性,建議您加入額外的前置字元和 進一步細分實體例如將 per- 前置字串新增到 固定 ID 的員工或辦公室的 off-,均不符合 標準。

建議: per-e55b7dd4-cc98-11ec-9d64-0242ac120002

建議:off-7849514a-e8bc-11ec-8fea-0242ac120002

建議:-123456789012345

不建議使用: per-john-doe

  • 風險:名稱相同的其他人可能會使用相同的 ID。
  • 風險:資料變更可能會影響穩定 ID。

不建議的填寫方式:非美國總統

固定 ID 的使用位置

下列元素均須提供穩定 ID: