修订历史记录

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

2026 年 6 月 16 日

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

2026 年 6 月 16 日

• 添加了 Named Entity Changes 指南。

2026 年 6 月 2 日

• 向 Candidate 添加了 tse-candidate-number 作为外部标识符。

2026 年 5 月 19 日

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

2026 年 5 月 18 日

• 添加了 SqsQueueNameRequiresS3SourceDirPath 验证器规则，以确保如果在元数据 Feed 中设置了 SqsQueueName，则还必须设置 SourceDirPath，并且 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 子类型。
• 向 Contest 添加了 AggregateBallotSelection、BlankBallotSelection、NoneOfTheAboveBallotSelection 和 NullBallotSelection。
• 向 CandidateSelection 和 PartySelection 添加了 IncludedInAggregation。
• 向 ElectionReport 添加了 Attribution 和 DataSource 元素定义以及 DataSourceCollection。
• 向 Contest 添加了 ResultsReportingStage 和 ResultsReportingStageType 定义以及 ResultsReportingStageCollection 和 CurrentResultsReportingStage。
• 向 Party 添加了 PartyColors 定义和 Colors。

2026 年 3 月 17 日

• 向 Candidate、Contest 和 Party 添加了 IsNotable。
• 已将 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 日

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

2026 年 1 月 28 日

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

2026 年 1 月 15 日

• 现在 ElectoralDistrictOcdId 规则已完全被更广泛的 GpUnitOcdId 规则取代，因此请删除 ElectoralDistrictOcdId 规则。

• 在 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 元素。
• 为候选人的参考页面添加了 CampaignSlogan 元素。

2022 年 11 月 17 日

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

2021 年 12 月 30 日

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

2021 年 12 月 27 日

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

2021 年 10 月 15 日

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

2021 年 8 月 20 日

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

2021 年 2 月 26 日

• 在 Term 参考页面中添加了一个示例，说明如何在 Officeholder Feed 中表示连任的公职人员的任期。

2021 年 2 月 24 日

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

2021 年 2 月 18 日

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

2020 年 12 月 14 日

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