修订历史记录

此处列出了 CDF 文档的变更。

2026 年 9 月 24 日

• 添加了 CandidateImageInContactInformation 验证器规则，用于在 ContactInformation.Uri 中设置 candidate-image 时发出警告，并建议改用 Person.ImageUri。

2026 年 9 月 14 日

• 更新了 CandidatesReferencedInRelatedContests 验证器规则和候选参考文档，不再将后续比赛视为相关比赛。

2026 年 9 月 2 日

• 添加了 SqsQueueNameIsFullyQualifiedArn 验证器规则，以确保在元数据 Feed 中设置 SqsQueueName 时，该值是有效的完全限定 SQS ARN。

2026 年 8 月 28 日

• 已将 TotalSeats 添加到 Contest。
• 更新了 VoteCountValidSeatsDeltaTypes 规则，以针对 SpecialBallotSelection 元素中的旧版 seats-delta 报告错误，并支持 seats-delta-institutional，而无需设置 seats-delta-mandate。

2026 年 8 月 27 日

• 弃用了旧版 JSON Feed 格式，并移除了开发者指南和参考文档中的所有 JSON 架构示例，改用 CDF XML。

2026 年 8 月 26 日

• 更新了参考文档中稳定 ID 和对象 ID 的示例，以使用带连字符的匈牙利命名法。
• 更新了稳定标识符指南，以列出各种实体类型的前缀建议。

2026 年 8 月 25 日

• 已移除 HungarianStyleNotation 规则。
• 更新了稳定标识符指南，明确指出匈牙利命名法是一种最佳实践，但并非必需，并添加了前缀示例。

2026 年 8 月 24 日

• 更新了国际注意事项指南，以明确规定候选人和政党名称的英语译名必须来自官方来源、信誉良好的媒体或合作伙伴出版物。

Aug 22, 2026

• 更新了 FeedLongevity 和 Feed 类型，并提供了有关何时可从常青动态源中移除实体的指南。

Aug 5, 2026

• 更新了 CountedInTotal 的架构，以允许使用 minOccurs=0，这符合文档的规定。

2026 年 7 月 29 日

• 更新了 FeedInactiveDateIsLatestDate 以跳过检查测试 Feed。
• 添加了新的 DuplicateBallotTitleSeatPair 规则，用于检查竞赛中是否存在重复的（选票标题、席位）对。
• 添加了新的 FeedInactiveDateNotOlderThanOneYear 规则。

2026 年 7 月 17 日

• 检查所有 Uri 元素是否都具有有效的语言代码（如果指定了语言代码）。

2026 年 7 月 9 日

• 移除了已废弃的 GovernmentBodyExternalId 规则。

2026 年 6 月 16 日

• 将旧版政府机构架构更新为错误。

2026 年 6 月 16 日

• 添加了 Named Entity Changes 指南。

2026 年 6 月 2 日

• 将 tse-candidate-number 添加为 Candidate 的外部标识符。

2026 年 5 月 19 日

• 添加了 ResultsReportingStagesMustHaveUniqueType 验证器规则，以确保 ResultsReportingStageCollection 中的每个 ResultsReportingStage 都具有唯一的 StageType。

2026 年 5 月 18 日

• 添加了 SqsQueueNameRequiresS3SourceDirPath 验证器规则，以确保 在元数据 Feed 中设置了 SqsQueueName 时，还必须设置 SourceDirPath ，并且 必须是 S3 路径。

2026 年 5 月 7 日

• 添加了 AttributionDepthLimit 规则，以确保 <ResultsReportingStage> 下的 <Attribution> 树最多具有 3 个级别的递归/深度。
• 添加了 AttributionCyclesValidation 规则，以确保 <Attribution> 元素在节点之间不包含有向环（循环）。

2026 年 5 月 6 日

• 添加了 ValidateIncludeInAggregationBallotSelections 规则，用于检查标记为 IncludedInAggregation 的选项的票数总和是否超过 AggregateBallotSelection 票数。
• 添加了规则，以强制执行对 SpecialBallotSelection 的 CountedInTotal 限制。
• 添加了 ValidateResultsEmbargoEnd 规则，以检查 ResultsEmbargoEnd 是否不晚于 official ResultsReportingStage 的开始时间。
• 添加了 ValidateResultsExpected 规则，用于检查 ResultsExpected 是否不早于第一个 ResultsReportingStage（不包括 no-results 阶段）。
• 添加了 NotEmptyUniqueDataSourceUris、UniqueDataSourceLanguages 和 UniqueDataSourceDisplayNames 规则，用于验证 DataSourceCollection 元素。此外，还向 MultipleInternationalizedTextWithSameLanguageCode 添加了 DisplayName。

2026 年 5 月 5 日

• 添加了 ValidatePollsCloseDatetimes 规则，以检查 LatestPollsClose 是否不早于 EarliestPollsClose。
• 已删除 PartiesHaveValidColors 规则。这些值也会通过 HtmlColorString 的架构进行验证。
• 更新了 ValidateDuplicateColors 规则，以支持 DarkThemeColor 和 LightThemeColor。

2026 年 4 月 30 日

• 添加了 WinnerCountLimit 验证器规则，以检查竞赛中的获胜者或预计获胜者人数是否不超过当选席位数。
• 移除了对 ContactInformation 中 candidate-image 注释的支持。
• 添加规则，以将带有注释 candidate-image 的 ImageUri 限制为每个 Person 最多一个，并确保候选图片 URI 在不同人员之间是唯一的。

2026 年 4 月 29 日

• 向 METADATA_RULES 添加了 EmptyString 和 EmptyText 规则。

2026 年 4 月 16 日

• 向 metadata_sample_feed.xml 添加了更多示例。
• 修复了多个示例 Feed 文件，以确保它们通过验证。

2026 年 4 月 14 日

• 更新了 yearly Feed 的保留时长，现在仅允许 pre-election Feed 使用该时长。 类型为 election-results 的 Feed 必须始终为 limited。

2026 年 3 月 25 日

• 更新了元数据示例 Feed SourceDirPath 值，以符合正则表达式预期。

2026 年 3 月 19 日

• 将 IsTest 和 SqsQueueName 添加到了 Feed 中。

2026 年 3 月 18 日

• 添加了 BallotSelection 的 SpecialBallotSelection 子类型。
• 将 AggregateBallotSelection、BlankBallotSelection、NoneOfTheAboveBallotSelection 和 NullBallotSelection 添加到了 Contest。
• 向 CandidateSelection 和 PartySelection 添加了 IncludedInAggregation。
• 向 ElectionReport 添加了 Attribution 和 DataSource 元素定义以及 DataSourceCollection。
• 向 Contest 添加了 ResultsReportingStage 和 ResultsReportingStageType 定义以及 ResultsReportingStageCollection 和 CurrentResultsReportingStage。
• 向 Party 添加了 PartyColors 定义和 Colors。

2026 年 3 月 17 日

• 已将 IsNotable 添加到 Candidate、Contest 和 Party。
• 已将 PartyLabel 添加到 Candidate。
• 已将 ImageUri 添加到 Person。
• 向 Contest 添加了 ResultsExpected、ResultsEmbargoEnd、EarliestPollsClose 和 LatestPollsClose。

2026 年 3 月 11 日

• 从 EmptyString 规则中移除了对 IssuerAbbreviation 的特殊处理。

2026 年 2 月 26 日

• 将 VoteCountsCollection 限制为每 BallotSelection 一次。（这样仍允许该集合中包含多个 VoteCounts。）

2026 年 2 月 24 日

• 修复了将 OfficeholderSubFeed 错误地写为 OfficeHolderSubFeed 的引用。
• 将元数据 Feed 中的 SourceDirPath 限制为支持的文件路径类型。

2026 年 2 月 23 日

• 更新了 VoteCounts 枚举，以同时支持 seats-delta-mandate 和 seats-delta-institutional。

2026 年 2 月 18 日

• 使元数据 Feed 中 Feed 元素中的 ElectionEventCollection 和 OfficeholderSubFeed 互斥。

2026 年 2 月 12 日

• 添加了有关如何将 PartialDate 解释为范围内的最晚可能日期的简单数据类型的指南。

2026 年 2 月 11 日

• 向 OfficeHolderTenure 到 MissingStableIds CDF 验证器规则添加了 ，以确保所有公职人员任期都具有稳定的 ID。

2026 年 1 月 28 日

• 添加了 FeedElementsShouldHaveSubElementsBasedOnType CDF 验证器规则，以确保元数据 Feed 中的 Feed 条目具有适当的子元素。

2026 年 1 月 15 日

• 删除 ElectoralDistrictOcdId 规则，因为该规则已完全被更广泛的 GpUnitOcdId 规则取代。

• 在 CDF 验证器中添加了 mayor 作为行政办公室角色。

2026 年 1 月 13 日

• 添加了 EmptyString 验证器规则，用于检查字符串字段是否为空或仅包含空白字符（暂时针对 IssuerAbbreviation 发出警告）。

2025 年 12 月 10 日

• 更新了 CDF XSD，使 IssuerAbbreviation 成为可选元素。

2025 年 11 月 18 日

• 更新了 GpUnitOcdId 规则，以检查所有预期具有 OCD ID 的 GpUnit 是否具有有效的 OCD ID，并使用占位符替换了 ElectoralDistrictOcdId 规则，直到可以安全地移除该规则为止。

2025 年 11 月 12 日

• 在简单数据类型中添加了指南，强调日期需要使用公历。

October 22, 2025

• 更新了新 Office 格式的文档，包括新的 OfficeHolderTenure 元素。

2025 年 9 月 29 日

• 更新了 ElectoralCommission 名称的指南，包括 XML 示例。

2025 年 8 月 5 日

• 更新了 voter-information 的 FeedType 的 Feed 文档和验证器支持。

2025 年 7 月 23 日

• 向 VoterInformationWebsiteType 添加其他值。

2025 年 7 月 11 日

• 向可用的 Contest 类型添加了 RetentionContest。

2025 年 7 月 7 日

• 更新了元数据 Feed 文档和验证器，以明确说明在确定 Feed 不活动日期时，无需考虑已取消的选举活动。

2025 年 6 月 25 日

• 添加了 whatsapp 作为 AnnotatedUri 的平台。

2025 年 6 月 16 日

• 更新了 VoterInformationWebsite 和 ElectoralCommissionWebsite 的选民信息文档，以反映 CDF 架构中的定义。

2025 年 5 月 29 日

• 已将 NoSourceDirPathBeforeInitialDeliveryDate 验证器规则替换为 SourceDirPathMustBeSetAfterInitialDeliveryDate。

2025 年 5 月 27 日

• 为选民信息 Feed 添加了验证器支持和基本检查。

2025 年 5 月 22 日

• 发布了指南，以帮助确定公职人员的任期。

2025 年 5 月 13 日

• 更新了Feed 类型指南，添加了选民信息 Feed。

2025 年 5 月 7 日

• 添加了支持选民信息的元素，包括 VoterInformation、VoterInformationWebsite、VoterInformationWebsiteType、ElectoralCommission 和 InternationalizedUri。

• 将有关 LanguageString 的信息重构到国际注意事项指南中。

2025 年 5 月 6 日

• 更新 PersonHasOffice 规则以检查新的 OfficeHolderTenure 架构。

2025 年 4 月 18 日

• 添加了说明，指出 People 的 FullName 元素不应包含人员的职称。

2025 年 4 月 10 日

• 为公职 / 公职人员任期拆分添加了新架构。

2025 年 3 月 12 日

• 向办公角色添加了 judge、cabinet member、general purpose officer 和 special purpose officer，并在验证器中添加了逻辑，以允许以下两种角色组合：head of government 和 head of state，以及 cabinet member 和 general purpose officer。

2025 年 3 月 4 日

• 更新了 ElectionDateType，其中详细说明了如何针对 bounded 选举解读 StartDate 和 EndDate。

2025 年 2 月 26 日

• 更新了元数据Feed，添加了有关在 FeedInactiveDate 之后等待 60 天才能从元数据 Feed 中移除 Feed 的注释。

2025 年 1 月 29 日

• 创建了新的标题语法指南，以标准化选举和竞赛标题。

2025 年 1 月 27 日

• 更新了竞赛指南，以将 PassageThreshold 定义添加到 BallotMeasureContest

2025 年 1 月 15 日

• 更新了元数据 Feed 实体的 FeedInactiveDate 属性的相关准则。

2024 年 11 月 19 日

• 添加了 GovernmentBody 的相关文档

2024 年 11 月 11 日

• 添加了文档，要求 Feed 文件名保持静态

2024 年 11 月 1 日

• 更新了 EmptyText 验证器规则，以引发错误而非警告。

2024 年 8 月 26 日

• 更新 OfficeLevel 枚举以添加详细说明。

2024 年 7 月 17 日

• 添加了有关新 PartyLeadership 实体和关联的 PartyLeadershipType 枚举的文档。

2024 年 7 月 10 日

• 添加了针对“FeedInactiveDate”和 SourceDirPath 的建议

2024 年 6 月 24 日

• 更新 PartyId，以允许为候选人和个人实体设置多个 PartyId。

2024 年 6 月 21 日

• 更新了 OfficeHolderSubFeed 实体的文档，以分享详细示例。

2024 年 5 月 14 日

• 清理 PartyContest 实体，使其仅包含相关元素 PartyContest。
• 为 ElectionDateStatus 枚举值（尤其是 tentative 和 changing）添加了更新后的定义。

2024 年 5 月 1 日

• 明确了 Party 的 IsIndependent 元素的定义。

2024 年 4 月 29 日

• 更新了 FeedType 枚举和 FeedLongevity 枚举，以在其各自的参考页面中使用小写值。

2024 年 4 月 17 日

• 为 Party 参考页面添加了 IsIndependent 元素。

2024 年 2 月 12 日

• 在整个网站中添加了有关新元数据 Feed 的文档。

2024 年 1 月 9 日

• 添加对 Tiktok 账号的支持，作为 AnnotatedUri

2024 年 1 月 3 日

• 更新了内部注意事项，其中更详细地介绍了如何以及何时翻译或音译数据。

2023 年 7 月 24 日

• 为政治委员会添加了 Committee 类型和相应的 Feed 类型

2023 年 1 月 20 日

• 为派对的参考页面添加了 Slogan 元素。
• 向 Candidate 的参考页面添加了 CampaignSlogan 元素。

2022 年 11 月 17 日

• 添加了有关更新 OCD ID 的流程的指南

2021 年 12 月 30 日

• 在简单数据类型页面中添加了 PartialDate 部分，并更新了一些表格字段。

2021 年 12 月 27 日

• 修改了竞赛页面 CandidateContest 部分中的内容，以支持每个竞赛仅限一个办事处，并更新了一些 XML 示例。

2021 年 10 月 15 日

• 为 Candidate 的参考页面添加了 ExternalIdentifier 部分。

2021 年 8 月 20 日

• 创建了 OfficeSelectionMethod 页面，向Office. 元素表格添加了 SelectionMethod 元素，并更新了代码示例。

2021 年 2 月 26 日

• 在术语参考页面中添加了一个示例，说明如何在“在职官员”Feed 中表示重新当选的在职官员的任期。

2021 年 2 月 24 日

• 向当事人参考资料添加了有关 party-chair-id 的信息。

2021 年 2 月 18 日

• 在 CandidatePreElectionStatus 参考资料中添加了一个图表，用于说明状态的时间安排。

2020 年 12 月 14 日

• 添加了介绍可用 Feed 类型的“指南”页面。更新了参考页面，以提供适用于大多数实体的最佳实践。