稳定的标识符是指在外部稳定的特定标识符, 对象。它们允许数据使用者以通用数据格式协调对象 (CDF) Feed 以及其他数据存储区。在数据库术语中,外部是指 标识符是一种外键形式, 对象发送到其他数据库。
例如,如果“Robert Brady”是候选对象,数据使用者可能不会 立即将此人与“Bob Brady”存储在图片数据库中。不过, CDF 数据和图像数据库可能表明 根据美国国会图书馆 THOMAS 数据库识别的立法机构 01469。然后 数据使用者可以将图像与候选网络关联起来。
所有稳定的标识符都必须满足以下条件:
- 稳定性:特定唯一实体的稳定标识符,如
Person
或Party
,不得在不同版本的数据中发生变化 Feed。也就是说,对于某个特定广告, 实体。 - 唯一性:切勿为其他实体重复使用稳定的标识符,即使 如果 Feed 中不再有原始实体,则会发生该错误。
- 一致性:您必须对 如有需要,可以同时在两个候选人、政党或选区 可能性较高。
数据格式设置
请以下格式提供稳定的标识符:
<ExternalIdentifier>
<Type>other</Type>
<OtherType>stable</OtherType>
<Value>match the regex ^[a-zA-Z0-9_-]+$</Value>
</ExternalIdentifier>
通用唯一标识符 (UUID) 和 全局唯一标识符 (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。
- 风险:数据变化可能会影响稳定的 ID。
不建议:非美国总统
在何处使用固定 ID
对于以下元素,必须使用稳定的标识符:
- 第
BallotMeasureSelection
行(共BallotSelection
行) Candidate
- 第
Coalition
个(共Party
个) Contest
Election
Office
Party
Person
ReportingUnit