穩定版 ID 是外部固定為特定指定 ID 的外部不重複 ID 物件。可讓資料用戶協調採用通用資料格式的物件 (CDF) 動態饋給。在資料庫對應中,外部 ID 是一種外鍵,可讓資料使用者 會將 CDF 資訊提供中的物件傳送到其他資料庫
舉例來說,假設「Robert Brady」資料使用者 立即將對方連結到「Bob Brady」映像檔資料庫不過 根據 CDF 資料和圖像資料庫,可看出 美國國會圖書館 THOMAS 資料庫加以確認。接著 資料使用者就能將圖片與候選人連結。
所有固定 ID 都必須符合下列條件:
- 穩定性:特定不重複實體的穩定 ID,例如
Person
或Party
,不得跨不同版本的資料變更 動態饋給換句話說,在某個應用程式的 實體。 - 獨特性:切勿將固定 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:
- 第
BallotMeasureSelection
個,共BallotSelection
個 Candidate
Coalition
(共Party
)Contest
Election
Office
Party
Person
ReportingUnit