修訂版本記錄

CDF 說明文件的異動內容列於此處。

2026 年 9 月 24 日

  • 新增 CandidateImageInContactInformation 驗證器規則，在 ContactInformation.Uri 中設定 candidate-image 時發出警告，並建議改用 Person.ImageUri。

2026 年 9 月 14 日

  • 更新 CandidatesReferencedInRelatedContests 驗證工具規則和候選人參考文件，不再將後續競賽視為相關競賽。

2026 年 9 月 2 日

  • 新增 SqsQueueNameIsFullyQualifiedArn 驗證工具規則，確保在元資料動態饋給中設定 SqsQueueName 時，該值是有效的完整 SQS ARN。

2026 年 8 月 28 日

  • 已將 TotalSeats 新增至 Contest。
  • 更新 VoteCountValidSeatsDeltaTypes 規則，以便在 SpecialBallotSelection 元素中發生舊版 seats-delta 時產生錯誤，並支援 seats-delta-institutional，不必設定 seats-delta-mandate。

Aug 27, 2026

  • 淘汰舊版 JSON 動態饋給格式，並從開發人員指南和參考文件中移除所有 JSON 結構定義範例，改用 CDF XML。

Aug 26, 2026

  • 更新參考文件中的固定 ID 和物件 ID 範例，使用含連字號的匈牙利表示法。
  • 更新「穩定 ID 指南」，列出各實體類型的字首建議。

Aug 25, 2026

  • 已移除 HungarianStyleNotation 規則。
  • 更新穩定 ID 指南，說明匈牙利標記是最佳做法，但並非必要，並新增前置字元範例。

Aug 24, 2026

  • 更新國際考量事項指南，釐清候選人和政黨名稱的英文翻譯規定，這些名稱須來自官方來源、信譽良好的媒體或合作夥伴出版物。

Aug 22, 2026

Aug 5, 2026

  • 更新 CountedInTotal 的結構定義，允許使用 minOccurs=0，詳情請參閱說明文件。

2026 年 7 月 29 日

  • 更新 FeedInactiveDateIsLatestDate，略過檢查測試動態消息。
  • 新增 DuplicateBallotTitleSeatPair 規則，檢查競賽中是否有重複的 (BallotTitle、Seat) 配對。
  • 新增 FeedInactiveDateNotOlderThanOneYear 規則。

2026 年 7 月 17 日

  • 確認所有 Uri 元素都有有效的語言代碼 (如有指定)。

2026 年 7 月 9 日

  • 已移除已淘汰的 GovernmentBodyExternalId 規則。

2026 年 6 月 16 日

  • 已將舊版政府機構結構定義更新為錯誤。

2026 年 6 月 16 日

  • 新增 Named Entity Changes 指南。

2026 年 6 月 2 日

  • 在 Candidate 中新增 tse-candidate-number 做為外部 ID。

2026 年 5 月 19 日

  • 新增 ResultsReportingStagesMustHaveUniqueType 驗證工具規則，確保 ResultsReportingStageCollection 中的每個 ResultsReportingStage 都有專屬的 StageType。

2026 年 5 月 18 日

  • 新增 SqsQueueNameRequiresS3SourceDirPath 驗證工具規則，確保在元資料動態饋給中設定 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 規則，檢查第一個 ResultsReportingStage 前的 ResultsExpected 不是 (不含 no-results 階段)。
  • 新增 NotEmptyUniqueDataSourceUris、UniqueDataSourceLanguages 和 UniqueDataSourceDisplayNames 規則，用於驗證 DataSourceCollection 元素。此外，已將 DisplayName 新增至 MultipleInternationalizedTextWithSameLanguageCode。

2026 年 5 月 5 日

  • 新增 ValidatePollsCloseDatetimes 規則，檢查 LatestPollsClose 是否不在 EarliestPollsClose 之前。
  • 已刪除 PartiesHaveValidColors 規則。HtmlColorString 的結構定義也會驗證這些值。
  • 更新 ValidateDuplicateColors 規則，支援 DarkThemeColor 和 LightThemeColor。

2026 年 4 月 30 日

  • 新增 WinnerCountLimit 驗證器規則，檢查競賽中的獲獎者或預計獲獎者人數是否超過當選席位數。
  • 已移除 ContactInformation 中的 candidate-image 註解支援。
  • 新增規則，限制每個 Person 最多只能有一個附註解 candidate-image 的 ImageUri，並確保候選圖片 URI 在不同人之間是獨一無二的。

2026 年 4 月 29 日

  • 已將 EmptyString 和 EmptyText 規則新增至 METADATA_RULES。

2026 年 4 月 16 日

  • 已在 metadata_sample_feed.xml 中新增更多範例。
  • 修正多個範例動態饋給檔案，確保通過驗證。

2026 年 4 月 14 日

  • 更新「yearly」動態饋給的保留時間，僅允許「pre-election」動態饋給使用。 類型為 election-results 的動態饋給一律為 limited。

2026 年 3 月 25 日

  • 更新中繼資料範例動態饋給 SourceDirPath 值，以符合規則運算式預期。

2026 年 3 月 19 日

  • 將 IsTest 和 SqsQueueName 新增至 Feed。

2026 年 3 月 18 日

  • 新增 SpecialBallotSelection 子類型 BallotSelection。
  • 已將 AggregateBallotSelection、BlankBallotSelection、NoneOfTheAboveBallotSelection 和 NullBallotSelection 新增至「Contest」。
  • 已將 IncludedInAggregation 新增至 CandidateSelection 和 PartySelection。
  • 在 ElectionReport 中新增 Attribution 和 DataSource 元素定義和 DataSourceCollection。
  • 已將 ResultsReportingStage 和 ResultsReportingStageType 定義，以及 ResultsReportingStageCollection 和 CurrentResultsReportingStage 新增至 Contest。
  • 在 Party 中新增 PartyColors 定義和 Colors。

2026 年 3 月 17 日

  • 已將 IsNotable 新增至 Candidate、Contest 和 Party。
  • 已將 PartyLabel 新增至 Candidate。
  • 已將 ImageUri 新增至 Person。
  • 已將 ResultsExpected、ResultsEmbargoEnd、EarliestPollsClose 和 LatestPollsClose 新增至「Contest」。

2026 年 3 月 11 日

  • 從 EmptyString 規則中移除 IssuerAbbreviation 的特殊處理方式。

2026 年 2 月 26 日

  • 每個BallotSelection只能有 1 個VoteCountsCollection。(但仍允許該集合內有多個 VoteCounts)。

2026 年 2 月 24 日

  • 修正錯誤寫成 OfficeHolderSubFeed 的 OfficeholderSubFeed 參照。
  • 中繼資料動態饋給中的 SourceDirPath 僅限支援的檔案路徑類型。

2026 年 2 月 23 日

  • 更新 VoteCounts 列舉，同時支援 seats-delta-mandate 和 seats-delta-institutional。

2026 年 2 月 18 日

  • 在元資料動態饋給的 Feed 元素中，將 ElectionEventCollection 和 OfficeholderSubFeed 設為互斥。

2026 年 2 月 12 日

  • 新增簡單資料類型的引導說明，說明如何將 PartialDate 解讀為範圍內最晚的可能日期。

2026 年 2 月 11 日

  • 在 MissingStableIds CDF 驗證工具規則中新增 OfficeHolderTenure，確保所有在職者任期都有穩定的 ID。

2026 年 1 月 28 日

  • 新增 FeedElementsShouldHaveSubElementsBasedOnType CDF 驗證工具規則，確保中繼資料動態饋給中的 Feed 項目含有適當的子元素。

2026 年 1 月 15 日

  • 現在 規則已完全由 範圍更廣的 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

September 29, 2025

  • 更新ElectoralCommission 名稱的相關規範，包括 XML 範例。

2025 年 8 月 5 日

  • 更新 Feed 說明文件，並支援 voter-information 的 FeedType 驗證工具。

2025 年 7 月 23 日

  • 在 VoterInformationWebsiteType 中新增其他值。

2025 年 7 月 11 日

  • 在可用的 Contest 類型中新增 RetentionContest。

2025 年 7 月 7 日

  • 更新中繼資料 Feed 說明文件和驗證工具，明確指出判斷動態饋給停用日期時，不需要考慮取消的選舉活動事件。

2025 年 6 月 25 日

  • 新增 whatsapp 做為 AnnotatedUri 的平台。

2025 年 6 月 16 日

  • 更新 VoterInformationWebsite 和 ElectoralCommissionWebsite 的「選民資訊」說明文件，以反映 CDF 架構中的定義。

2025 年 5 月 29 日

  • 已將 NoSourceDirPathBeforeInitialDeliveryDate 驗證器規則替換為 SourceDirPathMustBeSetAfterInitialDeliveryDate。

2025 年 5 月 27 日

  • 新增驗證器支援，並對選民資訊動態饋給進行基本檢查。

2025 年 5 月 22 日

  • 發布指南，協助判斷在職期間日期。

2025 年 5 月 13 日

2025 年 5 月 7 日

2025 年 5 月 6 日

  • 更新 PersonHasOffice 規則，檢查新的 OfficeHolderTenure 結構定義。

2025 年 4 月 18 日

  • 新增說明，指出「使用者」的 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，詳細說明如何解讀 StartDate 和 EndDate 的 bounded 選舉。

2025 年 2 月 26 日

  • 更新中繼資料動態消息，新增附註：如要從中繼資料動態消息移除動態消息，請在 FeedInactiveDate 後等待 60 天。

2025 年 1 月 29 日

  • 建立新的「Title」語法 guide，以標準化「election」和「contest」標題。

2025 年 1 月 27 日

  • 更新競賽指南，在 BallotMeasureContest 中新增 PassageThreshold 定義

2025 年 1 月 15 日

  • 更新中繼資料 Feed 實體的 FeedInactiveDate 屬性規範。

2024 年 11 月 19 日

2024 年 11 月 11 日

  • 新增說明文件，規定動態饋給檔案名稱必須保持不變

2024 年 11 月 1 日

  • 更新 EmptyText 驗證器規則，將警告改為引發錯誤。

2024 年 8 月 26 日

2024 年 7 月 17 日

2024 年 7 月 10 日

  • 新增「FeedInactiveDate」和 SourceDirPath 的最佳化建議

2024 年 6 月 24 日

  • 更新 PartyId，允許「候選人」和「人員」實體有多個 PartyId。

2024 年 6 月 21 日

2024 年 5 月 14 日

  • 清除 PartyContest 實體，只保留相關元素「PartyContest」PartyContest。
  • 新增 ElectionDateStatus 列舉值的更新定義，尤其是 tentative 和 changing。

2024 年 5 月 1 日

  • 清楚說明 Party 的 IsIndependent 元素定義。

2024 年 4 月 29 日

2024 年 4 月 17 日

  • 在「Party」的參考頁面中加入 IsIndependent 元素。

2024 年 2 月 12 日

  • 在整個網站中新增有關新中繼資料動態消息的說明文件。

2024 年 1 月 9 日

2024 年 1 月 3 日

2023 年 7 月 24 日

2023 年 1 月 20 日

  • 在「Party」的參考頁面中加入 Slogan 元素。
  • 在「候選人」的參考頁面中加入 CampaignSlogan 元素。

2022 年 11 月 17 日

2021 年 12 月 30 日

  • 在「簡單資料型別」頁面中新增 PartialDate 區段，並更新部分表格欄位。

2021 年 12 月 27 日

  • 修改「競賽」頁面 CandidateContest 部分的內容，每個競賽僅支援一個辦公室，並更新部分 XML 範例。

2021 年 10 月 15 日

  • 在「Candidate」的參考頁面中新增 ExternalIdentifier 區段。

2021 年 8 月 20 日

2021 年 2 月 26 日

  • 在「Term」參考頁面中新增範例，說明如何在 Officeholder 動態饋給中表示連任官員的任期。

2021 年 2 月 24 日

  • 在「Party」參考資源中新增 party-chair-id 的相關資訊。

2021 年 2 月 18 日

  • 在 CandidatePreElectionStatus 參考資源中新增圖表，說明狀態的時間。

2020 年 12 月 14 日

  • 新增說明可用動態饋給類型的「指南」頁面。更新了「參考」頁面，提供適用於大多數實體的最佳做法。