Nhật ký sửa đổi

Những thay đổi đối với tài liệu CDF được liệt kê tại đây.

Ngày 24 tháng 9 năm 2026

• Thêm quy tắc trình xác thực CandidateImageInContactInformation để cảnh báo khi candidate-image được đặt trong ContactInformation.Uri và đề xuất sử dụng Person.ImageUri thay thế.

Ngày 14 tháng 9 năm 2026

• Cập nhật quy tắc trình xác thực CandidatesReferencedInRelatedContests và Tài liệu tham khảo về ứng cử viên để không còn coi các cuộc thi tiếp theo là cuộc thi có liên quan.

Ngày 2 tháng 9 năm 2026

• Thêm quy tắc trình xác thực SqsQueueNameIsFullyQualifiedArn để đảm bảo rằng nếu SqsQueueName được đặt trong nguồn cấp dữ liệu siêu dữ liệu, thì đó là ARN SQS đủ điều kiện hợp lệ.

Ngày 28 tháng 8 năm 2026

• Thêm TotalSeats vào Contest
• Đã cập nhật quy tắc VoteCountValidSeatsDeltaTypes để báo lỗi trên seats-delta cũ trong các phần tử SpecialBallotSelection và cũng để hỗ trợ seats-delta-institutional mà không cần đặt seats-delta-mandate.

Ngày 27 tháng 8 năm 2026

• Ngừng sử dụng các định dạng nguồn cấp dữ liệu JSON cũ và xoá tất cả ví dụ về giản đồ JSON trong các hướng dẫn dành cho nhà phát triển và tài liệu tham khảo để chuyển sang CDF XML.

Ngày 26 tháng 8 năm 2026

• Cập nhật các ví dụ về mã nhận dạng ổn định và mã nhận dạng đối tượng trong tài liệu tham khảo để sử dụng ký hiệu Hungary có dấu gạch ngang.
• Cập nhật Hướng dẫn về giá trị nhận dạng ổn định để liệt kê các đề xuất về tiền tố trên các loại thực thể.

Ngày 25 tháng 8 năm 2026

• Đã xoá quy tắc HungarianStyleNotation.
• Cập nhật Hướng dẫn về giá trị nhận dạng ổn định để làm rõ rằng ký hiệu Hungary là một phương pháp hay nhưng không bắt buộc, đồng thời thêm các ví dụ về tiền tố.

Ngày 24 tháng 8 năm 2026

• Cập nhật Hướng dẫn về các yếu tố quốc tế cần cân nhắc để làm rõ các yêu cầu về bản dịch tiếng Anh cho tên ứng cử viên và tên đảng từ các nguồn chính thức, báo chí uy tín hoặc ấn phẩm của đối tác.

Ngày 22 tháng 8 năm 2026

• Đã cập nhật FeedLongevity và Feed types (Các loại nguồn cấp dữ liệu) kèm theo hướng dẫn về thời điểm bạn có thể xoá các thực thể khỏi nguồn cấp dữ liệu dùng lâu dài.

Ngày 5 tháng 8 năm 2026

• Cập nhật giản đồ cho CountedInTotal để cho phép minOccurs=0 theo tài liệu.

Ngày 29 tháng 7 năm 2026

• Đã cập nhật FeedInactiveDateIsLatestDate để bỏ qua việc kiểm tra nguồn cấp dữ liệu kiểm thử.
• Thêm quy tắc DuplicateBallotTitleSeatPair mới để kiểm tra các cặp (BallotTitle, Seat) trùng lặp trong Cuộc thi.
• Đã thêm quy tắc FeedInactiveDateNotOlderThanOneYear mới.

Ngày 17 tháng 7 năm 2026

• Kiểm tra để đảm bảo rằng tất cả phần tử Uri đều có mã ngôn ngữ hợp lệ (khi được chỉ định).

Ngày 9 tháng 7 năm 2026

• Đã xoá quy tắc GovernmentBodyExternalId không dùng nữa.

Ngày 16 tháng 6 năm 2026

• Đã cập nhật giản đồ cơ quan chính phủ cũ thành một lỗi.

Ngày 16 tháng 6 năm 2026

• Đã thêm hướng dẫn Named Entity Changes.

Ngày 2 tháng 6 năm 2026

• Thêm tse-candidate-number làm giá trị nhận dạng bên ngoài vào Candidate.

Ngày 19 tháng 5 năm 2026

• Thêm quy tắc trình xác thực ResultsReportingStagesMustHaveUniqueType để đảm bảo rằng mỗi ResultsReportingStage trong một ResultsReportingStageCollection có một StageType riêng biệt.

Ngày 18 tháng 5 năm 2026

• Đã thêm quy tắc trình xác thực SqsQueueNameRequiresS3SourceDirPath để đảm bảo rằng nếu SqsQueueName được đặt trong nguồn cấp dữ liệu siêu dữ liệu, thì SourceDirPath cũng phải được đặt và phải là đường dẫn s3.

Ngày 7 tháng 5 năm 2026

• Thêm quy tắc AttributionDepthLimit để đảm bảo cây <Attribution> trong <ResultsReportingStage> có tối đa 3 cấp đệ quy/độ sâu.
• Đã thêm quy tắc AttributionCyclesValidation để đảm bảo các phần tử <Attribution> không chứa các chu kỳ có hướng (vòng lặp) giữa các nút.

Ngày 6 tháng 5 năm 2026

• Đã thêm quy tắc ValidateIncludeInAggregationBallotSelections để kiểm tra nhằm đảm bảo rằng tổng số phiếu bầu cho các lựa chọn được đánh dấu là IncludedInAggregation không vượt quá số phiếu bầu AggregateBallotSelection.
• Thêm quy tắc để thực thi các quy tắc ràng buộc CountedInTotal trên SpecialBallotSelection.
• Thêm quy tắc ValidateResultsEmbargoEnd để kiểm tra xem ResultsEmbargoEnd có phải sau khi bắt đầu official ResultsReportingStage hay không.
• Thêm quy tắc ValidateResultsExpected để kiểm tra xem ResultsExpected có phải là không trước ResultsReportingStage đầu tiên (không bao gồm giai đoạn no-results) hay không.
• Đã thêm các quy tắc NotEmptyUniqueDataSourceUris, UniqueDataSourceLanguages và UniqueDataSourceDisplayNames để xác minh các phần tử DataSourceCollection. Ngoài ra, đã thêm DisplayName vào MultipleInternationalizedTextWithSameLanguageCode.

Ngày 5 tháng 5 năm 2026

• Thêm quy tắc ValidatePollsCloseDatetimes để kiểm tra xem LatestPollsClose có phải là trước EarliestPollsClose hay không.
• Đã xoá quy tắc PartiesHaveValidColors. Các giá trị này cũng được lược đồ xác thực cho HtmlColorString.
• Cập nhật quy tắc ValidateDuplicateColors để hỗ trợ DarkThemeColor và LightThemeColor.

Ngày 30 tháng 4 năm 2026

• Đã thêm quy tắc trình xác thực WinnerCountLimit để kiểm tra xem số người chiến thắng hoặc số người chiến thắng dự kiến trong một cuộc thi có vượt quá số ghế được bầu hay không.
• Xoá tính năng hỗ trợ chú thích candidate-image trong ContactInformation.
• Thêm các quy tắc để hạn chế ImageUri có chú thích candidate-image tối đa một lần cho mỗi Person, đồng thời đảm bảo URI hình ảnh đề xuất là duy nhất đối với mỗi người.

Ngày 29 tháng 4 năm 2026

• Thêm các quy tắc EmptyString và EmptyText vào METADATA_RULES.

Ngày 16 tháng 4 năm 2026

• Thêm các ví dụ khác vào metadata_sample_feed.xml.
• Đã sửa nhiều tệp nguồn cấp dữ liệu mẫu để đảm bảo các tệp này vượt qua quy trình xác thực.

Ngày 14 tháng 4 năm 2026

• Cập nhật thời gian tồn tại của nguồn cấp dữ liệu yearly để chỉ cho phép nguồn cấp dữ liệu pre-election. Nguồn cấp dữ liệu thuộc loại election-results phải luôn là limited.

Ngày 25 tháng 3 năm 2026

• Cập nhật giá trị SourceDirPath của nguồn cấp dữ liệu mẫu siêu dữ liệu để khớp với kỳ vọng về biểu thức chính quy.

Ngày 19 tháng 3 năm 2026

• Thêm IsTest và SqsQueueName vào Feed.

Ngày 18 tháng 3 năm 2026

• Đã thêm loại phụ SpecialBallotSelection của BallotSelection.
• Thêm AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection và NullBallotSelection vào Contest.
• Thêm IncludedInAggregation vào CandidateSelection và PartySelection.
• Thêm định nghĩa phần tử Attribution và DataSource, đồng thời thêm DataSourceCollection vào ElectionReport.
• Thêm các định nghĩa ResultsReportingStage và ResultsReportingStageType, ResultsReportingStageCollection và CurrentResultsReportingStage vào Contest.
• Thêm định nghĩa PartyColors và Colors vào Party.

Ngày 17 tháng 3 năm 2026

• Thêm IsNotable vào Candidate, Contest và Party.
• Thêm PartyLabel vào Candidate
• Thêm ImageUri vào Person
• Thêm ResultsExpected, ResultsEmbargoEnd, EarliestPollsClose và LatestPollsClose vào Contest.

Ngày 11 tháng 3 năm 2026

• Xoá cách xử lý đặc biệt đối với IssuerAbbreviation khỏi quy tắc EmptyString.

Ngày 26 tháng 2 năm 2026

• VoteCountsCollection bị hạn chế ở mức một lần mỗi BallotSelection. (Cách này vẫn cho phép có nhiều VoteCounts trong bộ sưu tập đó.)

Ngày 24 tháng 2 năm 2026

• Sửa các tham chiếu đến OfficeholderSubFeed được viết không chính xác là OfficeHolderSubFeed.
• Hạn chế SourceDirPath trong nguồn cấp dữ liệu siêu dữ liệu đối với các loại đường dẫn tệp được hỗ trợ.

Ngày 23 tháng 2 năm 2026

• Cập nhật các giá trị liệt kê VoteCounts để hỗ trợ cả seats-delta-mandate và seats-delta-institutional.

Ngày 18 tháng 2 năm 2026

• Đặt ElectionEventCollection và OfficeholderSubFeed loại trừ lẫn nhau trong phần tử Feed trong nguồn cấp dữ liệu siêu dữ liệu.

Ngày 12 tháng 2 năm 2026

• Thêm hướng dẫn vào Các kiểu dữ liệu đơn giản cho PartialDate được diễn giải là ngày muộn nhất có thể trong phạm vi.

Ngày 11 tháng 2 năm 2026

• Đã thêm OfficeHolderTenure vào quy tắc Trình xác thực CDF MissingStableIds để đảm bảo tất cả nhiệm kỳ của người giữ chức vụ đều có mã nhận dạng ổn định.

Ngày 28 tháng 1 năm 2026

• Đã thêm quy tắc Trình xác thực CDF FeedElementsShouldHaveSubElementsBasedOnType để đảm bảo các mục Feed trong Nguồn cấp dữ liệu siêu dữ liệu có các phần tử phụ phù hợp.

Ngày 15 tháng 1 năm 2026

• Xoá quy tắc ElectoralDistrictOcdId vì quy tắc này đã được thay thế hoàn toàn bằng quy tắc GpUnitOcdId rộng hơn.

• Thêm mayor làm vai trò trong Văn phòng điều hành trong Trình xác thực CDF.

Ngày 13 tháng 1 năm 2026

• Đã thêm quy tắc trình xác thực EmptyString để kiểm tra xem các trường chuỗi có trống hay không hoặc chỉ chứa khoảng trắng (tạm thời là cảnh báo cho IssuerAbbreviation).

Ngày 10 tháng 12 năm 2025

• Cập nhật CDF XSD để đặt IssuerAbbreviation là không bắt buộc.

Ngày 18 tháng 11 năm 2025

• Đã cập nhật quy tắc GpUnitOcdId để kiểm tra xem tất cả GpUnit dự kiến có mã nhận dạng OCD đều có mã nhận dạng OCD hợp lệ và thay thế quy tắc ElectoralDistrictOcdId bằng một phần giữ chỗ cho đến khi có thể xoá.

Ngày 12 tháng 11 năm 2025

• Thêm hướng dẫn vào Các loại dữ liệu đơn giản, trong đó nêu bật nhu cầu sử dụng lịch Gregorian cho ngày.

Ngày 22 tháng 10 năm 2025

• Cập nhật tài liệu cho định dạng Office mới, bao gồm cả phần tử OfficeHolderTenure mới.

Ngày 29 tháng 9 năm 2025

• Cập nhật nguyên tắc cho ElectoralCommission Tên, bao gồm cả ví dụ về XML.

Ngày 5 tháng 8 năm 2025

• Cập nhật tài liệu Feed và hỗ trợ Trình xác thực cho FeedType của voter-information.

Ngày 23 tháng 7 năm 2025

• Thêm các giá trị khác vào VoterInformationWebsiteType.

Ngày 11 tháng 7 năm 2025

• Thêm RetentionContest vào Contest các loại hiện có.

Ngày 7 tháng 7 năm 2025

• Cập nhật tài liệu và trình xác thực Feed siêu dữ liệu để làm rõ rằng bạn không cần phải xem xét các sự kiện bầu cử bị huỷ khi xác định ngày Nguồn cấp dữ liệu không hoạt động.

Ngày 25 tháng 6 năm 2025

• Thêm whatsapp làm nền tảng cho AnnotatedUri.

Ngày 16 tháng 6 năm 2025

• Cập nhật tài liệu Thông tin cử tri cho VoterInformationWebsite và ElectoralCommissionWebsite để phản ánh các định nghĩa trong giản đồ CDF.

Ngày 29 tháng 5 năm 2025

• Thay thế quy tắc trình xác thực NoSourceDirPathBeforeInitialDeliveryDate bằng SourceDirPathMustBeSetAfterInitialDeliveryDate.

Ngày 27 tháng 5 năm 2025

• Đã thêm tính năng hỗ trợ Trình xác thực và các bước kiểm tra cơ bản cho nguồn cấp dữ liệu thông tin cử tri.

Ngày 22 tháng 5 năm 2025

• Xuất bản một hướng dẫn để hỗ trợ việc xác định ngày bắt đầu và kết thúc nhiệm kỳ của quan chức.

Ngày 13 tháng 5 năm 2025

• Cập nhật hướng dẫn về các loại nguồn cấp dữ liệu để thêm nguồn cấp dữ liệu thông tin cử tri.

Ngày 7 tháng 5 năm 2025

• Thêm các phần tử để hỗ trợ Thông tin cử tri, bao gồm VoterInformation, VoterInformationWebsite, VoterInformationWebsiteType, ElectoralCommission và InternationalizedUri.

• Tái cấu trúc thông tin về LanguageString thành Hướng dẫn về các yếu tố cần cân nhắc khi nhắm mục tiêu quốc tế.

Ngày 6 tháng 5 năm 2025

• Cập nhật quy tắc PersonHasOffice để kiểm tra giản đồ OfficeHolderTenure mới.

Ngày 18 tháng 4 năm 2025

• Thêm nội dung làm rõ rằng các phần tử FullName của People (Người) không được chứa danh hiệu của người đó.

Ngày 10 tháng 4 năm 2025

• Thêm giản đồ mới cho khoảng thời gian nắm giữ chức vụ / văn phòng.

Ngày 12 tháng 3 năm 2025

• Đã thêm judge, cabinet member, general purpose officer và special purpose officer vào vai trò văn phòng và thêm logic trong trình xác thực để cho phép 2 tổ hợp vai trò: head of government và head of state, cabinet member và general purpose officer.

Ngày 4 tháng 3 năm 2025

• Cập nhật ElectionDateType để cung cấp thông tin chi tiết về cách StartDate và EndDate sẽ được diễn giải cho các cuộc bầu cử bounded.

Ngày 26 tháng 2 năm 2025

• Cập nhật nguồn cấp dữ liệu siêu dữ liệu để thêm ghi chú về việc đợi 60 ngày sau FeedInactiveDate để xoá một nguồn cấp dữ liệu khỏi nguồn cấp dữ liệu siêu dữ liệu.

Ngày 29 tháng 1 năm 2025

• Tạo hướng dẫn mới về cú pháp Tiêu đề để chuẩn hoá tiêu đề của cuộc bầu cử và cuộc thi.

Ngày 27 tháng 1 năm 2025

• Cập nhật nguyên tắc về Cuộc thi để thêm định nghĩa về PassageThreshold vào BallotMeasureContest

Ngày 15 tháng 1 năm 2025

• Đã cập nhật nguyên tắc cho thuộc tính FeedInactiveDate của thực thể siêu dữ liệu Nguồn cấp dữ liệu.

Ngày 19 tháng 11 năm 2024

• Thêm tài liệu cho GovernmentBody

Ngày 11 tháng 11 năm 2024

• Thêm tài liệu yêu cầu tên tệp nguồn cấp dữ liệu phải giữ nguyên

Ngày 1 tháng 11 năm 2024

• Cập nhật quy tắc trình xác thực EmptyText để đưa ra lỗi thay vì cảnh báo.

Ngày 26 tháng 8 năm 2024

• Cập nhật enum OfficeLevel để thêm nội dung mô tả chi tiết.

Ngày 17 tháng 7 năm 2024

• Thêm tài liệu cho các thực thể PartyLeadership mới và enum PartyLeadershipType được liên kết.

Ngày 10 tháng 7 năm 2024

• Thêm đề xuất cho "FeedInactiveDate" và SourceDirPath

Ngày 24 tháng 6 năm 2024

• Cập nhật PartyId để cho phép dùng nhiều PartyId cho các thực thể Ứng cử viên và Người.

Ngày 21 tháng 6 năm 2024

• Cập nhật tài liệu cho thực thể OfficeHolderSubFeed để chia sẻ một ví dụ chi tiết.

Ngày 14 tháng 5 năm 2024

• Xoá thực thể PartyContest để chỉ bao gồm các phần tử có liên quan PartyContest.
• Thêm các định nghĩa mới cho giá trị enum ElectionDateStatus, đặc biệt là tentative và changing.

Ngày 1 tháng 5 năm 2024

• Làm rõ định nghĩa cho phần tử IsIndependent đối với Bên.

Ngày 29 tháng 4 năm 2024

• Cập nhật enum FeedType và enum FeedLongevity để sử dụng các giá trị chữ thường trong các trang tham chiếu tương ứng.

Ngày 17 tháng 4 năm 2024

• Đã thêm một phần tử IsIndependent vào trang tham khảo cho Party.

Ngày 12 tháng 2 năm 2024

• Thêm tài liệu trên toàn bộ trang web cho nguồn cấp dữ liệu Siêu dữ liệu mới.

Ngày 9 tháng 1 năm 2024

• Thêm tính năng hỗ trợ cho tài khoản Tiktok dưới dạng AnnotatedUri

Ngày 3 tháng 1 năm 2024

• Cập nhật Những điểm cần cân nhắc nội bộ với một chút sắc thái hơn về cách thức và thời điểm dịch hoặc chuyển tự dữ liệu.

Ngày 24 tháng 7 năm 2023

• Thêm kiểu Committee cho Uỷ ban chính trị và kiểu nguồn cấp dữ liệu tương ứng

Ngày 20 tháng 1 năm 2023

• Đã thêm một phần tử Slogan vào trang tham khảo cho Party (Bữa tiệc).
• Đã thêm một phần tử CampaignSlogan vào trang tham khảo cho Candidate (Đề xuất).

Ngày 17 tháng 11 năm 2022

• Thêm hướng dẫn về Quy trình cập nhật mã nhận dạng OCD

Ngày 30 tháng 12 năm 2021

• Đã thêm một mục PartialDate vào trang Các kiểu dữ liệu đơn giản, cũng như cập nhật một số trường trong bảng.

Ngày 27 tháng 12 năm 2021

• Nội dung đã sửa đổi trong phần CandidateContest của trang Cuộc thi để chỉ hỗ trợ một văn phòng cho mỗi cuộc thi, cũng như cập nhật một số ví dụ về XML.

Ngày 15 tháng 10 năm 2021

• Đã thêm phần ExternalIdentifier vào trang tham chiếu cho Candidate.

Ngày 20 tháng 8 năm 2021

• Tạo trang OfficeSelectionMethod, thêm phần tử SelectionMethod vào bảng Office. Phần tử và cập nhật ví dụ về mã.

Ngày 26 tháng 2 năm 2021

• Thêm một ví dụ vào trang tham chiếu Thuật ngữ về cách trình bày nhiệm kỳ của những người được bầu lại trong nguồn cấp dữ liệu Người nắm giữ chức vụ.

Ngày 24 tháng 2 năm 2021

• Đã thêm thông tin về party-chair-id vào tài liệu đối chiếu về Bên.

Ngày 18 tháng 2 năm 2021

• Đã thêm một sơ đồ vào tài liệu tham khảo CandidatePreElectionStatus minh hoạ thời gian của các trạng thái.

Ngày 14 tháng 12 năm 2020

• Đã thêm các trang Hướng dẫn mô tả các loại nguồn cấp dữ liệu hiện có. Cập nhật các trang Tham chiếu để cung cấp các phương pháp hay nhất cần tuân thủ đối với hầu hết các thực thể.