修訂版本記錄

CDF 說明文件的變更內容列於此處。

2026 年 6 月 2 日

• 已將 tse-candidate-number 新增為 Candidate 的外部 ID。

2026 年 5 月 19 日

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

2026 年 5 月 18 日

• 新增 SqsQueueNameRequiresS3SourceDirPath 驗證工具規則，確保在元資料動態饋給中設定 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 規則，檢查第一個 ResultsReportingStage 前的 ResultsExpected 不是 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 註解支援。
• 新增規則，將附註 candidate-image 的 ImageUri 限制為每 Person 最多一個，並確保候選人圖片 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 日

• 新增 BallotSelection 的 SpecialBallotSelection 子類型。
• 已將 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 日

• 新增引導說明，指出 Simple data types 中的 PartialDate 會解讀為範圍內最晚的可能日期。

2026 年 2 月 11 日

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

2026 年 1 月 28 日

• 新增 FeedElementsShouldHaveSubElementsBasedOnType CDF 驗證工具規則，確保中繼資料動態饋給中的 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 元素。

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 日

• 新增元素，支援選民資訊，包括 VoterInformation、VoterInformationWebsite、VoterInformationWebsiteType、ElectoralCommission 和 InternationalizedUri。

• 將 LanguageString 相關資訊重構為國際考量事項指南。

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 日

• 建立新的標題語法指南，統一選舉和競賽標題。

2025 年 1 月 27 日

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

2025 年 1 月 15 日

• 更新中繼資料 Feed 實體的 FeedInactiveDate 屬性指南。

2024 年 11 月 19 日

• 新增 GovernmentBody 說明文件

2024 年 11 月 11 日

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

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」PartyContest。
• 新增 ElectionDateStatus 列舉值的更新定義，尤其是 tentative 和 changing。

2024 年 5 月 1 日

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

2024 年 4 月 29 日

• 更新 FeedType 列舉和 FeedLongevity 列舉，在各自的參照頁面中使用小寫值。

2024 年 4 月 17 日

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

2024 年 2 月 12 日

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

2024 年 1 月 9 日

• 新增對 Tiktok 帳戶的支援，做為 AnnotatedUri

2024 年 1 月 3 日

• 更新內部考量事項，更詳細說明何時及如何翻譯或音譯資料。

2023 年 7 月 24 日

• 新增政治委員會的 Committee 類型，以及對應的動態消息類型

2023 年 1 月 20 日

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

2022 年 11 月 17 日

• 新增更新 OCD ID 的程序指南

2021 年 12 月 30 日

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

2021 年 12 月 27 日

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

2021 年 10 月 15 日

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

2021 年 8 月 20 日

• 建立 OfficeSelectionMethod 頁面、在「元素」Office.表格中新增 SelectionMethod 元素，並更新程式碼範例。

2021 年 2 月 26 日

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

2021 年 2 月 24 日

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

2021 年 2 月 18 日

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

2020 年 12 月 14 日

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