Historia zmian

Tutaj znajdziesz zmiany w dokumentacji CDF.

12 listopada 2026 r.

  • Naprawiliśmy błąd RulesRegistry.get_all_exceptions() w bibliotece walidatora, aby zwracała zarejestrowane wyjątki zamiast None.
  • Zaktualizowano wiersz poleceń walidatora, aby kończył działanie z kodem 4, gdy znajdzie komunikaty o błędach krytycznych, zamiast 0.
  • Zaktualizowaliśmy regułę walidatora Schema, aby błędy weryfikacji schematu były zgłaszane jako błędy krytyczne, a nie zwykłe.
  • Zaktualizowano regułę walidatora MissingPartyAbbreviationTranslation, aby miała zastosowanie do wszystkich typów plików danych z wyjątkiem plików danych z metadanymi, a nie tylko do plików danych z wyborami i datami wyborów.
  • Zaktualizowano regułę walidatora MissingPartyNameTranslation, aby miała zastosowanie do wszystkich typów plików danych z wyjątkiem plików danych z metadanymi, a nie tylko do plików danych z wyborami i datami wyborów.
  • Zaktualizowano regułę walidatora DateOfBirthIsInPast, aby miała zastosowanie do wszystkich typów plików danych z wyjątkiem plików danych z metadanymi, a nie tylko do plików danych dotyczących urzędników.
  • Zaktualizowano regułę walidatora GpUnitsHaveSingleRoot, aby miała zastosowanie do wszystkich typów kanałów oprócz kanałów metadanych, a nie tylko do kanałów wyborów i dat wyborów.
  • Naprawiono regułę walidatora ElectionDatesSpanContestDates, aby zgłaszała wszystkie wybory z datami spoza wyborów, a nie tylko ostatnie.
  • Naprawiliśmy komunikat o błędzie reguły walidatora ComposingContestIdsAreValidRelatedContests, gdy nie można znaleźć konkursu na kompozycję.
  • Naprawiliśmy błąd powodujący awarię reguły walidatora SubsequentContestIdIsValidRelatedContest, gdy ani konkurs, ani wybory nie miały daty zakończenia, oraz błąd powodujący ponowne użycie daty zakończenia poprzedniego konkursu w przypadku wyborów bez daty zakończenia.

11 listopada 2026 r.

  • Zaktualizowano regułę walidatora CoalitionParties, aby miała zastosowanie do wszystkich typów plików danych z wyjątkiem plików danych metadanych, a nie tylko do plików danych dotyczących wyborów i dat wyborów.
  • Zaktualizowano regułę walidatora DuplicatedPartyAbbreviation, aby miała zastosowanie do wszystkich typów plików danych z wyjątkiem plików danych z metadanymi, a nie tylko do plików danych z wyborami i datami wyborów.
  • Zaktualizowano regułę walidatora DuplicatedPartyName, aby miała zastosowanie do wszystkich typów kanałów oprócz kanałów metadanych, a nie tylko do kanałów wyborów i dat wyborów.

10 listopada 2026 r.

  • Zaktualizowano regułę walidatora MultipleInternationalizedTextWithSameLanguageCode, aby miała zastosowanie do wszystkich typów plików danych z wyjątkiem plików danych z metadanymi, a nie tylko do plików danych z wyborami i datami wyborów.

2 listopada 2026 r.

  • Dodano: disqualified i sub-judice do CandidatePreElectionStatus.
  • Dodano użytkowników defeated, did-not-participate, disqualified, projected-advanced-to-runoff i sub-judice do: CandidatePostElectionStatus.
  • Wycofano withdrawn w: CandidatePostElectionStatus.
  • Zaktualizowaliśmy Candidate, aby wyjaśnić, że PreElectionStatus i PostElectionStatus to ogólny ostateczny stan kandydata we wszystkich powiązanych wyborach, a stany poszczególnych wyborów należą do CandidateSelection.
  • Zaktualizowaliśmy artykuł Contest, aby doprecyzować szczegółowość danych SubUnitsReported i TotalSubUnits.
  • Dodano InheritFromComposedContest do: ResultsReportingStageCollection w: Contest.
  • Dodano regułę walidatora ValidateResultReportingStages, aby upewnić się, że ResultsReportingStageCollection nie zawiera elementów ResultsReportingStage, a jego Contest jest wymieniony w ComposingContestIds innego Contest, gdy InheritFromComposedContest to true, a w przeciwnym razie zawiera co najmniej 1 element ResultsReportingStage, oraz aby ostrzegać, jeśli nie zawiera co najmniej 2 elementów ResultsReportingStage (jednego typu no-results i co najmniej jednego typu preliminary lub official).
  • Dodano InheritFromComposedContest do: ResultsReportingStageCollection w: Contest.
  • Dodano regułę walidatora ValidateResultReportingStages, aby upewnić się, że ResultsReportingStageCollection nie zawiera elementów ResultsReportingStage, gdy InheritFromComposedContest to true, i co najmniej 1 w przeciwnym razie, oraz aby ostrzegać, jeśli nie zawiera co najmniej 2 elementów ResultsReportingStage (1 typu no-results i co najmniej 1 typu preliminary lub official).
  • Zaktualizowano regułę walidatora CandidatesReferencedInRelatedContests i dokumentację referencyjną kandydata, aby ponownie traktować kolejne wybory jako powiązane, więc Person musi być przywoływany przez ten sam Candidate w kolejnych wyborach.

28 października 2026 r.

  • Zaktualizowano Contest, aby usunąć dziedziczenie kontekstu tworzenia z: EarliestPollsClose, LatestPollsClose, ResultsEmbargoEnd i ResultsExpected.

23 października 2026 r.

  • Zaktualizowano regułę walidatora GpUnitOcdId, aby sprawdzała elementy ReportingUnit.

22 października 2026 r.

  • Dodano OutcomeDetermined do: Contest.

21 października 2026 r.

  • Zaktualizowano Contest, aby wyjaśnić, że ResultsReportingStageCollection powinien zawierać pełny zestaw oczekiwanych etapów z ich atrybucją, a nie tylko bieżący etap, który jest podany w CurrentResultsReportingStage.

16 października 2026 r.

15 października 2026 r.

13 października 2026 r.

  • Dodano: PreElectionStatus i PostElectionStatus do CandidateSelection.
  • Dodano diplomat do: OfficeRole.
  • Dodano: DiplomatSendingStateId i DiplomatReceivingStateId do Office.
  • Zaktualizowano regułę walidatora ValidIDREF, aby rozpoznawała DiplomatSendingStateId i DiplomatReceivingStateId jako elementy odwołujące się do GpUnit
  • Dodano regułę walidatora DiplomaticOfficesHaveCorrespondingGpUnitsSet, aby zapewnić, że biura z rolą diplomat mają ustawione co najmniej jedno z tych pól.

12 października 2026 r.

  • Dodano EstimatedExpectedVotePercentage do: Contest.

8 października 2026 r.

  • Usunięto ContestStage na rzecz ResultsReportingStage i ResultsReportingStageType.
  • Zaktualizowano regułę walidatora EmptyString, aby nie zgłaszała błędu w przypadku elementów z elementami podrzędnymi, gdy przed pierwszym elementem podrzędnym nie ma odstępu.

6 października 2026 r.

  • Dodano ResultsLastUpdated do: Contest.

24 września 2026 r.

  • Dodano regułę walidatora CandidateImageInContactInformation, która ostrzega, gdy parametr candidate-image jest ustawiony w ContactInformation.Uri, i zaleca użycie parametru Person.ImageUri.

14 września 2026 r.

2 września 2026 r.

  • Dodano regułę walidatora SqsQueueNameIsFullyQualifiedArn, aby mieć pewność, że jeśli w pliku danych metadanych ustawiono SqsQueueName, jest to prawidłowy, w pełni kwalifikowany SQS ARN.

28 sierpnia 2026 r.

  • Dodano TotalSeats do: Contest.
  • Zaktualizowano regułę VoteCountValidSeatsDeltaTypes, aby zgłaszała błąd w przypadku starszych elementów seats-delta w elementach SpecialBallotSelection, a także aby obsługiwała seats-delta-institutional bez konieczności ustawiania seats-delta-mandate.

27 sierpnia 2026 r.

  • Wycofaliśmy starsze formaty plików danych JSON i usunęliśmy wszystkie przykłady schematów JSON z przewodników dla programistów i dokumentacji referencyjnej na rzecz formatu CDF XML.

26 sierpnia 2026 r.

  • Zaktualizowaliśmy przykłady stałych identyfikatorów i identyfikatorów obiektów w dokumentacji referencyjnej, aby używać notacji węgierskiej z łącznikami.
  • Zaktualizowaliśmy przewodnik po stabilnych identyfikatorach, aby uwzględnić zalecenia dotyczące prefiksów w przypadku różnych typów elementów.

25 sierpnia 2026 r.

  • Usunięto HungarianStyleNotation regułę.
  • Zaktualizowaliśmy przewodnik po stabilnych identyfikatorach, aby wyjaśnić, że notacja węgierska jest sprawdzoną metodą, ale nie jest wymagana, i dodaliśmy przykłady prefiksów.

24 sierpnia 2026 r.

  • Zaktualizowaliśmy przewodnik po kwestiach międzynarodowych, aby wyjaśnić wymagania dotyczące tłumaczeń na język angielski nazwisk kandydatów i nazw partii z oficjalnych źródeł, renomowanej prasy lub publikacji partnerów.

22 sierpnia 2026 r.

  • Zaktualizowano sekcje FeedLongevity i Feed types, dodając wskazówki dotyczące tego, kiedy można usunąć encje z kanałów evergreen.

5 sierpnia 2026 r.

  • Zaktualizowaliśmy schemat CountedInTotal, aby umożliwić minOccurs=0 zgodnie z dokumentacją.

29 lipca 2026 r.

  • Zaktualizowano FeedInactiveDateIsLatestDate, aby pominąć sprawdzanie kanałów testowych.
  • Dodano nową regułę DuplicateBallotTitleSeatPair, która sprawdza, czy w konkursach nie ma zduplikowanych par (BallotTitle, Seat).
  • Dodano nową regułę FeedInactiveDateNotOlderThanOneYear.

17 lipca 2026 r.

  • Sprawdź, czy wszystkie elementy Uri mają prawidłowy kod języka (jeśli jest określony).

9 lipca 2026 r.

  • Usunięto wycofaną regułę GovernmentBodyExternalId.

16 czerwca 2026 r.

  • Zaktualizowano starszy schemat organu państwowego do błędu.

16 czerwca 2026 r.

  • Dodano prowadnicę – Named Entity Changes.

2 czerwca 2026 r.

  • Dodano tse-candidate-number jako identyfikator zewnętrzny do Candidate.

19 maja 2026 r.

  • Dodano regułę walidatora ResultsReportingStagesMustHaveUniqueType, aby mieć pewność, że każdy element ResultsReportingStage w ResultsReportingStageCollection ma unikalny StageType.

18 maja 2026 r.

  • Dodano regułę walidatora SqsQueueNameRequiresS3SourceDirPath, aby upewnić się, że jeśli w pliku danych metadanych ustawiono SqsQueueName, musi być też ustawione SourceDirPath i musi to być ścieżka s3.

7 maja 2026 r.

  • Dodano regułę AttributionDepthLimit, aby drzewa <Attribution> w <ResultsReportingStage> miały maksymalnie 3 poziomy rekurencji/głębokości.
  • Dodano regułę AttributionCyclesValidation, aby elementy <Attribution> nie zawierały cykli skierowanych (pętli) między węzłami.

6 maja 2026 r.

  • Dodano regułę ValidateIncludeInAggregationBallotSelections, aby sprawdzić, czy suma głosów oddanych na opcje oznaczone jako IncludedInAggregation nie przekracza liczby głosów AggregateBallotSelection.
  • Dodano regułę wymuszającą ograniczenia CountedInTotal na SpecialBallotSelection.
  • Dodano regułę ValidateResultsEmbargoEnd, aby sprawdzić, czy ResultsEmbargoEnd nie przypada po rozpoczęciu official ResultsReportingStage.
  • Dodano regułę ValidateResultsExpected, aby sprawdzić, czy ResultsExpected nie występuje przed pierwszym ResultsReportingStage (z wyłączeniem etapu no-results).
  • Dodano reguły NotEmptyUniqueDataSourceUris, UniqueDataSourceLanguages i UniqueDataSourceDisplayNames, aby zweryfikować elementy DataSourceCollection. Dodano też DisplayName do: MultipleInternationalizedTextWithSameLanguageCode.

5 maja 2026 r.

  • Dodano regułę ValidatePollsCloseDatetimes, aby sprawdzić, czy LatestPollsClose nie jest przed EarliestPollsClose.
  • Usunięto PartiesHaveValidColors regułę. Te wartości są też sprawdzane przez schemat HtmlColorString.
  • Zaktualizowano regułę ValidateDuplicateColors, aby obsługiwała DarkThemeColor i LightThemeColor.

30 kwietnia 2026 r.

  • Dodano regułę walidatora WinnerCountLimit, która sprawdza, czy liczba zwycięzców lub przewidywanych zwycięzców w konkursie nie przekracza liczby wybranych miejsc.
  • Usunięto obsługę adnotacji candidate-image w ContactInformation.
  • Dodaj reguły, aby ograniczyć liczbę elementów ImageUri z adnotacją candidate-image do maksymalnie 1 na Person, a także aby zapewnić unikalność identyfikatorów URI obrazów kandydatów dla poszczególnych osób.

29 kwietnia 2026 r.

  • Dodano reguły EmptyString i EmptyText do METADATA_RULES.

16 kwietnia 2026 r.

  • Dodaliśmy więcej przykładów do sekcji metadata_sample_feed.xml.
  • Poprawiliśmy kilka przykładowych plików danych, aby przechodziły weryfikację.

14 kwietnia 2026 r.

  • Zaktualizowano czas ważności pliku danych yearly, aby był dozwolony tylko w przypadku plików danych pre-election. Pliki danych typu election-results muszą zawsze mieć wartość limited.

25 marca 2026 r.

  • Aktualizuję wartość SourceDirPath w przykładowym pliku danych metadanych, aby odpowiadała oczekiwanemu wyrażeniu regularnemu.

19 marca 2026 r.

  • Dodano IsTest i SqsQueueName do: Feed.

18 marca 2026 r.

  • Dodano podtyp SpecialBallotSelection elementu BallotSelection.
  • Dodano użytkowników AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection i NullBallotSelection do albumu Contest.
  • Dodano: IncludedInAggregation do CandidateSelection i PartySelection.
  • Dodano definicje elementów Attribution i DataSource oraz DataSourceCollection do ElectionReport.
  • Dodano definicje ResultsReportingStage i ResultsReportingStageType oraz ResultsReportingStageCollection i CurrentResultsReportingStage do Contest.
  • Dodano definicję PartyColors i Colors do Party.

17 marca 2026 r.

  • Dodano IsNotable do: Candidate, Contest i Party.
  • Dodano PartyLabel do: Candidate.
  • Dodano ImageUri do: Person.
  • Dodano użytkowników ResultsExpected, ResultsEmbargoEnd, EarliestPollsClose i LatestPollsClose do albumu Contest.

11 marca 2026 r.

  • Usunięto specjalne traktowanie IssuerAbbreviation z reguły EmptyString.

26 lutego 2026 r.

  • Ograniczono liczbę VoteCountsCollection do 1 na BallotSelection. (Nadal możesz mieć wiele elementów VoteCounts w tej kolekcji).

24 lutego 2026 r.

  • Poprawiono odwołania do OfficeholderSubFeed, które były nieprawidłowo zapisane jako OfficeHolderSubFeed.
  • Ograniczono SourceDirPath w pliku danych metadanych do obsługiwanych typów ścieżek plików.

23 lutego 2026 r.

  • Zaktualizowano wyliczenia VoteCounts, aby obsługiwały zarówno seats-delta-mandate, jak i seats-delta-institutional.

18 lutego 2026 r.

  • Wprowadziliśmy wzajemne wykluczanie się elementów ElectionEventCollection i OfficeholderSubFeed w elemencie Feed w plikach danych z metadanymi.

12 lutego 2026 r.

  • Dodaliśmy wskazówki dotyczące prostych typów danych, aby wartość PartialDate była interpretowana jako najpóźniejsza możliwa data w zakresie.

11 lutego 2026 r.

  • Dodano regułę OfficeHolderTenure do MissingStableIds w walidatorze CDF, aby zapewnić, że wszystkie kadencje urzędników mają stabilne identyfikatory.

28 stycznia 2026 r.

  • Dodano regułę walidatora CDF FeedElementsShouldHaveSubElementsBasedOnType, aby mieć pewność, że wpisy Feed w pliku danych metadanych mają odpowiednie podelementy.

15 stycznia 2026 r.

  • Usuń regułę ElectoralDistrictOcdId, ponieważ została ona w pełni zastąpiona przez szerszą regułę GpUnitOcdId.

  • Dodano mayor jako rolę biura wykonawczego w walidatorze CDF.

13 stycznia 2026 r.

  • Dodano regułę walidatora EmptyString, która sprawdza, czy pola ciągów znaków nie są puste ani nie zawierają tylko spacji (tymczasowo ostrzeżenie dla IssuerAbbreviation).

10 grudnia 2025 r.

  • Zaktualizowaliśmy plik XSD CDF, aby pole IssuerAbbreviation było opcjonalne.

18 listopada 2025 r.

  • Zaktualizowano regułę GpUnitOcdId, aby sprawdzać, czy wszystkie obiekty GpUnit, które powinny mieć identyfikatory OCD, mają prawidłowe identyfikatory OCD, i zastąpiono regułę ElectoralDistrictOcdId obiektem zastępczym, dopóki nie będzie można jej bezpiecznie usunąć.

12 listopada 2025 r.

  • Dodaliśmy do sekcji Proste typy danych wskazówki dotyczące konieczności używania kalendarza gregoriańskiego w przypadku dat.

22 października 2025 r.

29 września 2025 r.

  • Zaktualizowane wytyczne dotyczące nazw ElectoralCommission, w tym przykładowy kod XML.

5 sierpnia 2025 r.

  • Zaktualizowano dokumentację Feed i obsługę walidatora w przypadku FeedType z voter-information.

23 lipca 2025 r.

  • Dodaj dodatkowe wartości do VoterInformationWebsiteType.

11 lipca 2025 r.

  • Dodano RetentionContest do dostępnych typów Contest.

7 lipca 2025 r.

  • Zaktualizowaliśmy dokumentację i walidator metadanych Feed, aby wyjaśnić, że anulowane zdarzenia wyborcze nie muszą być brane pod uwagę przy określaniu daty nieaktywności kanału.

25 czerwca 2025 r.

  • Dodano platformę whatsapp dla aplikacji AnnotatedUri.

16 czerwca 2025 r.

  • Zaktualizowaliśmy dokumentację dotyczącą informacji o wyborcach w VoterInformationWebsite i ElectoralCommissionWebsite, aby odzwierciedlić definicje w schemacie CDF.

29 maja 2025 r.

  • Zastąpiono regułę walidatora NoSourceDirPathBeforeInitialDeliveryDate regułą SourceDirPathMustBeSetAfterInitialDeliveryDate.

27 maja 2025 r.

  • Dodano obsługę walidatora i podstawowe testy plików danych z informacjami dla wyborców.

22 maja 2025 r.

  • Opublikowaliśmy przewodnik, który ułatwia określanie dat kadencji urzędników.

13 maja 2025 r.

7 maja 2025 r.

6 maja 2025 r.

  • Zaktualizuj regułę PersonHasOffice, aby sprawdzić nowy schemat OfficeHolderTenure.

18 kwietnia 2025 r.

  • Dodaliśmy wyjaśnienie, że elementy FullName typu People nie powinny zawierać tytułu osoby.

10 kwietnia 2025 r.

  • Dodano nowy schemat podziału kadencji urzędu/urzędnika.

12 marca 2025 r.

  • Dodano role judge, cabinet member, general purpose officer i special purpose officer do ról biurowych oraz dodano logikę w walidatorze, aby umożliwić 2 kombinacje ról: head of government i head of state oraz cabinet member i general purpose officer.

4 marca 2025 r.

  • Zaktualizowaliśmy artykuł ElectionDateType, dodając informacje o tym, jak będziemy interpretować zasady dotyczące StartDate i EndDate w przypadku wyborów w bounded.

26 lutego 2025 r.

  • Zaktualizowano plik danych metadanych, aby dodać informację o tym, że po usunięciu pliku danych z pliku danych metadanych należy odczekać 60 dni od FeedInactiveDate.

29 stycznia 2025 r.

27 stycznia 2025 r.

  • Zaktualizowaliśmy wytyczne dotyczące konkursów, aby dodać definicję PassageThreshold do BallotMeasureContest

15 stycznia 2025 r.

  • Zaktualizowaliśmy wytyczne dotyczące właściwości FeedInactiveDate encji metadanych Feed.

19 listopada 2024 r.

11 listopada 2024 r.

  • Dodaliśmy dokumentację, która wymaga, aby nazwy plików danych były statyczne.

1 listopada 2024 r.

  • Zaktualizuj regułę walidatora EmptyText, aby wyświetlała błąd zamiast ostrzeżenia.

26 sierpnia 2024 r.

  • Zaktualizuj typ wyliczeniowy OfficeLevel, aby dodać szczegółowe opisy.

17 lipca 2024 r.

10 lipca 2024 r.

  • Dodawanie rekomendacji dotyczących atrybutów 'FeedInactiveDate' i SourceDirPath

24 czerwca 2024 r.

  • Zaktualizuj PartyId, aby umożliwić używanie wielu PartyId w przypadku encji Candidate i Person.

21 czerwca 2024 r.

  • Zaktualizuj dokumentację encji OfficeHolderSubFeed, aby udostępnić szczegółowy przykład.

14 maja 2024 r.

  • Wyczyść element PartyContest, aby zawierał tylko odpowiednie elementy PartyContest.
  • Dodano zaktualizowane definicje wartości typu wyliczeniowego ElectionDateStatus, w szczególności tentative i changing.

1 maja 2024 r.

  • Sprecyzowano definicję elementu IsIndependent dla Party.

29 kwietnia 2024 r.

  • Zaktualizuj typy wyliczeniowe FeedType i FeedLongevity, aby używać wartości pisanych małymi literami na odpowiednich stronach referencyjnych.

17 kwietnia 2024 r.

  • Dodaliśmy element IsIndependent do strony referencyjnej Party.

12 lutego 2024 r.

  • Dodaliśmy w witrynie dokumentację dotyczącą nowego kanału metadanych.

9 stycznia 2024 r.

3 stycznia 2024 r.

  • Zaktualizowaliśmy sekcję Uwagi wewnętrzne, dodając więcej szczegółów na temat tego, jak i kiedy tłumaczyć lub transliterować dane.

24 lipca 2023 r.

  • Dodano typ Committee dla komitetów politycznych i odpowiadający mu typ pliku danych.

20 stycznia 2023 r.

  • Dodaliśmy element Slogan do strony referencyjnej Party.
  • Dodaliśmy element CampaignSlogan do strony referencyjnej Candidate.

17 listopada 2022 r.

30 grudnia 2021 r.

  • Dodano sekcję PartialDate na stronie Proste typy danych oraz zaktualizowano niektóre pola tabeli.

27 grudnia 2021 r.

  • Zmodyfikowano treść w sekcji CandidateContest na stronie Konkurs, aby obsługiwać tylko jeden urząd na konkurs, a także zaktualizowano niektóre przykłady XML.

15 października 2021 r.

  • Dodano sekcję ExternalIdentifier do strony referencyjnej Candidate.

20 sierpnia 2021 r.

26 lutego 2021 r.

  • Do strony referencyjnej Term dodaliśmy przykład pokazujący, jak przedstawić kadencję ponownie wybranych urzędników w pliku danych Officeholder.

24 lutego 2021 r.

  • Dodaliśmy informacje o party-chair-id do materiałów referencyjnych dotyczących strony.

18 lutego 2021 r.

  • Dodaliśmy diagram do materiałów referencyjnych CandidatePreElectionStatus, który ilustruje czas trwania stanów.

14 grudnia 2020 r.

  • Dodaliśmy strony przewodników, które opisują dostępne typy plików danych. Zaktualizowaliśmy strony referencyjne, aby udostępnić sprawdzone metody dotyczące większości encji.