修訂版本記錄

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

2026 年 11 月 12 日

• 修正驗證工具程式庫中的 RulesRegistry.get_all_exceptions()，傳回記錄的例外狀況，而非 None。
• 更新驗證工具指令列，在發現嚴重訊息時，以代碼 4 結束，而非 0。
• 更新 Schema 驗證工具規則，將結構定義驗證失敗回報為嚴重錯誤，而非一般錯誤。
• 更新 MissingPartyAbbreviationTranslation 驗證工具規則，套用至中繼資料動態饋給以外的所有動態饋給類型，而非僅限選舉和選舉日期動態饋給。
• 更新 MissingPartyNameTranslation 驗證工具規則，套用至中繼資料動態饋給以外的所有動態饋給類型，而非僅限選舉和選舉日期動態饋給。
• 更新 DateOfBirthIsInPast 驗證工具規則，套用至所有動態饋給類型 (中繼資料動態饋給除外)，而非僅限公職人員動態饋給。
• 更新 GpUnitsHaveSingleRoot 驗證工具規則，套用至所有動態饋給類型 (中繼資料動態饋給除外)，而非僅限選舉和選舉日期動態饋給。
• 修正 ElectionDatesSpanContestDates 驗證工具規則，回報日期不在選舉範圍內的所有競選活動，而非僅回報最後一項。
• 修正找不到撰寫競賽時，ComposingContestIdsAreValidRelatedContests 驗證工具規則的錯誤訊息。
• 修正 SubsequentContestIdIsValidRelatedContest 驗證工具規則在競選和選舉都沒有結束日期時會當機的問題，以及在選舉沒有結束日期時重複使用先前競選結束日期的問題。

2026 年 11 月 11 日

• 更新 CoalitionParties 驗證工具規則，套用至除了中繼資料動態饋給以外的所有動態饋給類型，而非僅限選舉和選舉日期動態饋給。
• 更新 DuplicatedPartyAbbreviation 驗證工具規則，套用至中繼資料動態饋給以外的所有動態饋給類型，而非僅限選舉和選舉日期動態饋給。
• 更新 DuplicatedPartyName 驗證工具規則，套用至所有動態饋給類型 (中繼資料動態饋給除外)，而非僅限選舉和選舉日期動態饋給。

2026 年 11 月 10 日

• 更新 MultipleInternationalizedTextWithSameLanguageCode 驗證工具規則，套用至中繼資料動態饋給以外的所有動態饋給類型，而非僅限選舉和選舉日期動態饋給。

2026 年 11 月 2 日

• 在 CandidatePreElectionStatus 中新增 disqualified 和 sub-judice。
• 在 CandidatePostElectionStatus 中新增 defeated、did-not-participate、disqualified、projected-advanced-to-runoff 和 sub-judice。
• 淘汰 CandidatePostElectionStatus 中的 withdrawn。
• 更新 Candidate，明確指出 PreElectionStatus 和 PostElectionStatus 是候選人在相關競選活動中的整體最終狀態，而各競選活動的狀態則屬於 CandidateSelection。
• 更新 Contest，釐清 SubUnitsReported 和 TotalSubUnits 的精細程度。
• 已將 InheritFromComposedContest 新增至 Contest 中的 ResultsReportingStageCollection。
• 新增 ValidateResultReportingStages 驗證工具規則，確保 ResultsReportingStageCollection 不含 ResultsReportingStage 元素，且當 InheritFromComposedContest 為 true 時，其 Contest 會列在另一個 Contest 的 ComposingContestIds 中，否則至少包含一個 ResultsReportingStage，並在不含至少兩個 ResultsReportingStage 元素 (一個類型為 no-results，至少一個類型為 preliminary 或 official) 時發出警告。
• 已將 InheritFromComposedContest 新增至 Contest 中的 ResultsReportingStageCollection。
• 新增 ValidateResultReportingStages 驗證工具規則，確保 ResultsReportingStageCollection 在 InheritFromComposedContest 為 true 時不含 ResultsReportingStage 元素，否則至少包含一個元素，並在不含至少兩個 ResultsReportingStage 元素 (一個類型為 no-results，至少一個類型為 preliminary 或 official) 時發出警告。
• 更新 CandidatesReferencedInRelatedContests 驗證工具規則和候選人參考文件，再次將後續競選活動視為相關競選活動，因此後續競選活動中的 Person 必須由同一個 Candidate 參照。

2026 年 10 月 28 日

• 更新 Contest，移除 EarliestPollsClose、LatestPollsClose、ResultsEmbargoEnd 和 ResultsExpected 的撰寫內容繼承。

2026 年 10 月 23 日

• 更新 GpUnitOcdId 驗證工具規則，檢查 ReportingUnit 元素。

2026 年 10 月 22 日

• 已將 OutcomeDetermined 新增至 Contest。

2026 年 10 月 21 日

• 更新 Contest，說明 ResultsReportingStageCollection 應包含一組完整的預期階段及其歸因，而非僅包含 CurrentResultsReportingStage 中的目前階段。

2026 年 10 月 16 日

• 已將 ContestDateType 新增至 Contest。
• 已將 NoResultsProvided 新增至 ResultsReportingStage。

2026 年 10 月 15 日

• 已將 Alias 新增至 Person。

2026 年 10 月 13 日

• 在 CandidateSelection 中新增 PreElectionStatus 和 PostElectionStatus。
• 已將 diplomat 新增至 OfficeRole。
• 在 Office 中新增 DiplomatSendingStateId 和 DiplomatReceivingStateId。
• 更新 ValidIDREF 驗證工具規則，將 DiplomatSendingStateId 和 DiplomatReceivingStateId 視為參照 GpUnit 元素
• 新增 DiplomaticOfficesHaveCorrespondingGpUnitsSet 驗證工具規則，確保角色為 diplomat 的辦公室至少設定其中一個欄位。

2026 年 10 月 12 日

• 將 EstimatedExpectedVotePercentage 新增至 Contest。

2026 年 10 月 8 日

• 移除 ContestStage，改用 ResultsReportingStage 和 ResultsReportingStageType。
• 更新 EmptyString 驗證工具規則，在第一個子元素前沒有空白字元時，不對含有子元素的元素引發錯誤。

2026 年 10 月 6 日

• 將 ResultsLastUpdated 新增至 Contest。

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。

2026 年 8 月 27 日

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

2026 年 8 月 26 日

• 更新參考文件中固定 ID 和物件 ID 的範例，改用匈牙利命名法並加上連字號。
• 更新穩定 ID 指南，列出各實體類型的前置字元建議。

2026 年 8 月 25 日

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

2026 年 8 月 24 日

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

2026 年 8 月 22 日

• 更新 FeedLongevity 和動態饋給類型，並提供何時可從常態動態饋給中移除實體的指南。

2026 年 8 月 5 日

• 根據說明文件，更新 CountedInTotal 的結構定義，允許 minOccurs=0。

2026 年 7 月 29 日

• 已更新 FeedInactiveDateIsLatestDate，略過檢查測試動態饋給。
• 新增 DuplicateBallotTitleSeatPair 規則，檢查 Contests 中是否有重複的 (BallotTitle, Seat) 組合。
• 新增 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 的外部 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 規則，檢查 ResultsExpected 是否不在第一個 ResultsReportingStage 之前 (不含 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 日

• 在 METADATA_RULES 中新增 EmptyString 和 EmptyText 規則。

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。
• 在 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。
• 已將 ResultsExpected、ResultsEmbargoEnd、EarliestPollsClose 和 LatestPollsClose 新增至 Contest。

2026 年 3 月 11 日

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

2026 年 2 月 26 日

• 每個BallotSelection只能有一個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 日

• 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 元素。

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，詳細說明 bounded 選舉中 StartDate 和 EndDate 的解讀方式。

2025 年 2 月 26 日

• 更新中繼資料動態饋給，新增附註，說明在 FeedInactiveDate 後等待 60 天，再從中繼資料動態饋給中移除動態饋給。

2025 年 1 月 29 日

• 建立新的標題語法指南，標準化選舉和競選標題。

2025 年 1 月 27 日

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

2025 年 1 月 15 日

• 更新中繼資料動態饋給實體的 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。
• 新增 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 元素。
• 在 Candidate 的參考資料頁面中加入 CampaignSlogan 元素。

2022 年 11 月 17 日

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

2021 年 12 月 30 日

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

2021 年 12 月 27 日

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

2021 年 10 月 15 日

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

2021 年 8 月 20 日

• 建立 OfficeSelectionMethod 頁面，將 SelectionMethod 元素新增至 Office.元素表格，並更新程式碼範例。

2021 年 2 月 26 日

• 在任期參考頁面中新增範例，說明如何在公職人員動態饋給中表示連任公職人員的任期。

2021 年 2 月 24 日

• 在實體參考資料中新增 party-chair-id 的相關資訊。

2021 年 2 月 18 日

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

2020 年 12 月 14 日

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