Histórico de revisões

As mudanças na documentação do CDF estão listadas aqui.

28 de outubro de 2026

• Atualizamos Contest para remover a herança de contexto de composição de EarliestPollsClose, LatestPollsClose, ResultsEmbargoEnd e ResultsExpected.

23 de outubro de 2026

• Atualizamos a regra do validador GpUnitOcdId para verificar os elementos ReportingUnit.

22 de outubro de 2026

• Adicionamos OutcomeDetermined a Contest.

21 de outubro de 2026

• Atualizamos Contest para esclarecer que ResultsReportingStageCollection precisa conter o conjunto completo de etapas esperadas com a atribuição delas, em vez de apenas a etapa atual, que vai para CurrentResultsReportingStage.

16 de outubro de 2026

• Adicionamos ContestDateType a Contest.
• Adicionamos NoResultsProvided a ResultsReportingStage.

15 de outubro de 2026

• Adicionamos Alias a Person.

13 de outubro de 2026

• PreElectionStatus e PostElectionStatus foram adicionados a CandidateSelection.
• Adicionamos diplomat a OfficeRole.
• DiplomatSendingStateId e DiplomatReceivingStateId foram adicionados a Office.
• Atualizamos a regra do validador ValidIDREF para reconhecer DiplomatSendingStateId e DiplomatReceivingStateId como elementos GpUnit de referência.
• Adicionamos a regra de validação DiplomaticOfficesHaveCorrespondingGpUnitsSet para garantir que os escritórios com o papel diplomat tenham pelo menos um desses campos definidos.

12 de outubro de 2026

• A EstimatedExpectedVotePercentage foi adicionada a Contest.

8 de outubro de 2026

• ContestStage foi removido em favor de ResultsReportingStage e ResultsReportingStageType.
• Atualização da regra do validador EmptyString para não gerar um erro em elementos com elementos filhos quando nenhum espaço em branco precede o primeiro elemento filho.

6 de outubro de 2026

• A ResultsLastUpdated foi adicionada a Contest.

24 de setembro de 2026

• Adição da regra de validação CandidateImageInContactInformation para avisar quando candidate-image é definido em ContactInformation.Uri e recomendar o uso de Person.ImageUri.

14 de setembro de 2026

• Atualizamos a regra do validador CandidatesReferencedInRelatedContests e a documentação de referência do candidato para que as disputas subsequentes não sejam mais tratadas como relacionadas.

2 de setembro de 2026

• Adicionamos a regra de validação SqsQueueNameIsFullyQualifiedArn para garantir que, se SqsQueueName estiver definido em um feed de metadados, ele seja um ARN do SQS totalmente qualificado e válido.

28 de agosto de 2026

• A TotalSeats foi adicionada a Contest.
• Atualizamos a regra VoteCountValidSeatsDeltaTypes para gerar um erro em seats-delta legados em elementos SpecialBallotSelection e também para oferecer suporte a seats-delta-institutional sem precisar definir seats-delta-mandate.

27 de agosto de 2026

• Os formatos legados de feed JSON foram descontinuados, e todos os exemplos de esquema JSON foram removidos dos guias para desenvolvedores e da documentação de referência em favor do CDF XML.

26 de agosto de 2026

• Atualizamos os exemplos de IDs estáveis e de objetos na documentação de referência para usar a notação húngara com hifens.
• Atualizamos o guia de identificadores estáveis para listar recomendações de prefixo em todos os tipos de entidade.

25 de agosto de 2026

• A regra HungarianStyleNotation foi removida.
• Atualizamos o guia de identificadores estáveis para esclarecer que a notação húngara é uma prática recomendada, mas não obrigatória, e adicionamos exemplos de prefixos.

24 de agosto de 2026

• Atualizamos o guia de considerações internacionais para esclarecer os requisitos de traduções para o inglês de nomes de candidatos e partidos de fontes oficiais, imprensa de boa reputação ou publicações de parceiros.

22 de agosto de 2026

• Atualizamos FeedLongevity e Feed types com orientações sobre quando as entidades podem ser removidas de feeds permanentes.

5 de agosto de 2026

• Atualizamos o esquema de CountedInTotal para permitir minOccurs=0 de acordo com a documentação.

29 de julho de 2026

• Atualizamos FeedInactiveDateIsLatestDate para pular a verificação de feeds de teste.
• Adicionamos uma nova regra DuplicateBallotTitleSeatPair para verificar se há pares duplicados (BallotTitle, Seat) em Contests.
• Adicionamos uma nova regra FeedInactiveDateNotOlderThanOneYear.

17 de julho de 2026

• Verifique se todos os elementos Uri têm um código de idioma válido (quando especificado).

9 de julho de 2026

• A regra GovernmentBodyExternalId descontinuada foi removida.

16 de junho de 2026

• O esquema legado de órgão governamental foi atualizado para um erro.

16 de junho de 2026

• Adicionamos o guia Named Entity Changes.

2 de junho de 2026

• Adicionamos tse-candidate-number como um identificador externo a Candidate.

19 de maio de 2026

• Adição da regra de validação ResultsReportingStagesMustHaveUniqueType para garantir que cada ResultsReportingStage em um ResultsReportingStageCollection tenha um StageType exclusivo.

18 de maio de 2026

• Adicionamos a regra de validação SqsQueueNameRequiresS3SourceDirPath para garantir que, se SqsQueueName estiver definido em um feed de metadados, SourceDirPath também esteja definido e seja um caminho do S3.

7 de maio de 2026

• Adicionamos a regra AttributionDepthLimit para garantir que as árvores <Attribution> em <ResultsReportingStage> tenham no máximo três níveis de recursão/profundidade.
• Adicionamos a regra AttributionCyclesValidation para garantir que os elementos <Attribution> não contenham ciclos direcionados (loops) entre nós.

6 de maio de 2026

• Adicionamos a regra ValidateIncludeInAggregationBallotSelections para verificar se a soma das contagens de votos para seleções marcadas como IncludedInAggregation não excede a contagem de votos AggregateBallotSelection.
• Adicionamos uma regra de anúncio para aplicar restrições de CountedInTotal em SpecialBallotSelections.
• Adicionamos a regra ValidateResultsEmbargoEnd para verificar se ResultsEmbargoEnd não está após o início de official ResultsReportingStage.
• Adicionamos a regra ValidateResultsExpected para verificar se ResultsExpected não está antes do primeiro ResultsReportingStage (excluindo o estágio no-results).
• Adição das regras NotEmptyUniqueDataSourceUris, UniqueDataSourceLanguages e UniqueDataSourceDisplayNames para verificar elementos DataSourceCollection. Além disso, adicionamos DisplayName ao MultipleInternationalizedTextWithSameLanguageCode.

5 de maio de 2026

• Adicionamos a regra ValidatePollsCloseDatetimes para verificar se LatestPollsClose não está antes de EarliestPollsClose.
• A regra PartiesHaveValidColors foi excluída. Esses valores também são validados pelo esquema de HtmlColorString.
• Atualização da regra ValidateDuplicateColors para oferecer suporte a DarkThemeColor e LightThemeColor.

30 de abril de 2026

• Adicionamos a regra de validação WinnerCountLimit para verificar se o número de vencedores ou vencedores projetados em uma disputa não excede o número de assentos eleitos.
• O suporte à anotação candidate-image em ContactInformation foi removido.
• Adicione regras para restringir ImageUri com a anotação candidate-image a no máximo um por Person e também para garantir que os URIs de imagem candidatos sejam exclusivos entre as pessoas.

29 de abril de 2026

• Adicionamos as regras EmptyString e EmptyText a METADATA_RULES.

16 de abril de 2026

• Adicionamos mais exemplos a metadata_sample_feed.xml.
• Correção de vários arquivos de feed de amostra para garantir que eles passem na validação.

14 de abril de 2026

• Atualização da longevidade do feed yearly para que seja permitida apenas para feeds pre-election. Os feeds do tipo election-results precisam ser sempre limited.

25 de março de 2026

• Atualização do valor SourceDirPath do feed de amostra de metadados para corresponder à expectativa de expressão regular.

19 de março de 2026

• IsTest e SqsQueueName foram adicionados a Feed.

18 de março de 2026

• Adicionamos o subtipo SpecialBallotSelection de BallotSelection.
• AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection e NullBallotSelection foram adicionados a Contest.
• Adição de IncludedInAggregation a CandidateSelection e PartySelection.
• Adicionamos as definições de elementos Attribution e DataSource e DataSourceCollection a ElectionReport.
• Adição das definições de ResultsReportingStage e ResultsReportingStageType e de ResultsReportingStageCollection e CurrentResultsReportingStage a Contest.
• Adicionamos a definição de PartyColors e Colors a Party.

17 de março de 2026

• IsNotable foi adicionado a Candidate, Contest e Party.
• A PartyLabel foi adicionada a Candidate.
• A ImageUri foi adicionada a Person.
• Adicionamos ResultsExpected, ResultsEmbargoEnd, EarliestPollsClose e LatestPollsClose a Contest.

11 de março de 2026

• O tratamento especial de IssuerAbbreviation foi removido da regra EmptyString.

26 de fevereiro de 2026

• Restringimos VoteCountsCollection a um por BallotSelection. Isso ainda permite vários VoteCounts nessa coleção.

24 de fevereiro de 2026

• Correção de referências a OfficeholderSubFeed que foram escritas incorretamente como OfficeHolderSubFeed.
• Restringimos SourceDirPath no feed de metadados aos tipos de caminho de arquivo compatíveis.

23 de fevereiro de 2026

• Atualizamos as enumerações de VoteCounts para oferecer suporte a seats-delta-mandate e seats-delta-institutional.

18 de fevereiro de 2026

• Tornamos ElectionEventCollection e OfficeholderSubFeed mutuamente exclusivos no elemento Feed em feeds de metadados.

12 de fevereiro de 2026

• Adicionamos orientações aos tipos de dados simples para que PartialDate seja interpretado como a data mais recente possível no período.

11 de fevereiro de 2026

• Adicionamos OfficeHolderTenure à regra do validador do CDF de MissingStableIds para garantir que todos os mandatos de funcionários públicos tenham IDs estáveis.

28 de janeiro de 2026

• Adicionamos a regra do validador do CDF FeedElementsShouldHaveSubElementsBasedOnType para garantir que as entradas Feed no feed de metadados tenham subelementos apropriados.

15 de janeiro de 2026

• Exclua a regra ElectoralDistrictOcdId agora que ela foi totalmente substituída pela regra GpUnitOcdId, que é mais ampla.

• Adicionamos mayor como um papel de escritório executivo no validador do CDF.

13 de janeiro de 2026

• Adicionamos a regra de validação EmptyString para verificar se os campos de string não estão vazios ou se contêm apenas espaços em branco (temporariamente um aviso para IssuerAbbreviation).

10 de dezembro de 2025

• Atualizamos o XSD do CDF para tornar IssuerAbbreviation opcional.

18 de novembro de 2025

• Atualizamos a regra GpUnitOcdId para verificar se todos os GpUnits que devem ter IDs de DCO têm IDs válidos e substituímos a regra ElectoralDistrictOcdId por um marcador de posição até que seja seguro removê-la.

12 de novembro de 2025

• Adicionamos orientações aos tipos de dados simples destacando a necessidade de usar o calendário gregoriano para datas.

22 de outubro de 2025

• Atualizamos a documentação do novo formato Office, incluindo o novo elemento OfficeHolderTenure.

29 de setembro de 2025

• Atualizamos as diretrizes para nomes de ElectoralCommission, incluindo um exemplo de XML.

5 de agosto de 2025

• Atualização da documentação de Feed e do suporte do Validator para FeedType de voter-information.

23 de julho de 2025

• Adicione outros valores a VoterInformationWebsiteType.

11 de julho de 2025

• Adição de RetentionContest aos tipos de Contest disponíveis.

7 de julho de 2025

• Atualizamos a documentação e o validador de metadados Feed para esclarecer que os eventos de eleição cancelados não precisam ser considerados ao determinar uma data de inatividade do feed.

25 de junho de 2025

• Adicionamos whatsapp como uma plataforma para AnnotatedUri.

16 de junho de 2025

• Atualizamos a documentação de informações para eleitores de VoterInformationWebsite e ElectoralCommissionWebsite para refletir as definições no esquema do CDF.

29 de maio de 2025

• A regra do validador NoSourceDirPathBeforeInitialDeliveryDate foi substituída por SourceDirPathMustBeSetAfterInitialDeliveryDate.

27 de maio de 2025

• Adicionamos suporte ao Validator e verificações básicas para feeds de informações do eleitor.

22 de maio de 2025

• Publicamos um guia para ajudar a determinar as datas de mandato de funcionários públicos.

13 de maio de 2025

• Atualizamos o guia de tipos de feed para incluir feeds de informações para eleitores.

7 de maio de 2025

• Adicionamos elementos para oferecer suporte às informações do eleitor, incluindo VoterInformation, VoterInformationWebsite, VoterInformationWebsiteType, ElectoralCommission e InternationalizedUri.

• Refatoramos as informações sobre LanguageString no guia de considerações internacionais.

6 de maio de 2025

• Atualize a regra PersonHasOffice para verificar o novo esquema OfficeHolderTenure.

18 de abril de 2025

• Adicionamos um esclarecimento de que os elementos FullName de Pessoas não podem conter o título da pessoa.

10 de abril de 2025

• Adicionamos um novo esquema para a divisão de mandato de cargo / titular de cargo.

12 de março de 2025

• Adicionamos judge, cabinet member, general purpose officer e special purpose officer às funções de escritório e adicionamos lógica no validador para permitir duas combinações de funções: head of government e head of state e cabinet member e general purpose officer.

4 de março de 2025

• Atualizamos o artigo ElectionDateType com detalhes sobre como StartDate e EndDate serão interpretados para as eleições de bounded.

26 de fevereiro de 2025

• Atualizamos o feed de metadados para adicionar uma observação sobre esperar 60 dias após FeedInactiveDate para remover um feed do feed de metadados.

29 de janeiro de 2025

• Criamos um novo guia de sintaxe de títulos para padronizar os títulos de eleições e concursos.

27 de janeiro de 2025

• Atualizamos as diretrizes de concursos para adicionar a definição de PassageThreshold a BallotMeasureContest.

15 de janeiro de 2025

• Atualizamos as diretrizes para a propriedade FeedInactiveDate da entidade Feed de metadados.

19 de novembro de 2024

• Adicionamos a documentação para GovernmentBody.

11 de novembro de 2024

• Adicionamos uma documentação exigindo que os nomes de arquivos de feed permaneçam estáticos.

1º de novembro de 2024

• Atualize a regra do validador EmptyText para gerar um erro em vez de um aviso.

26 de agosto de 2024

• Atualize o tipo enumerado OfficeLevel para adicionar descrições detalhadas.

17 de julho de 2024

• Adicionamos documentação para novas entidades PartyLeadership e o tipo enumerado PartyLeadershipType associado.

10 de julho de 2024

• Adicionamos recomendações para "FeedInactiveDate" e SourceDirPath.

24 de Junho de 2024

• Atualização de PartyId para permitir vários PartyIds para as entidades Candidate e Person.

21 de junho de 2024

• Atualize a documentação da entidade OfficeHolderSubFeed para compartilhar um exemplo detalhado.

14 de maio de 2024

• Limpe a entidade PartyContest para incluir apenas os elementos relevantes PartyContest.
• Adicionamos definições atualizadas para os valores do tipo enumerado ElectionDateStatus, principalmente tentative e changing.

1º de maio de 2024

• Esclarecemos a definição do elemento IsIndependent para Party.

29 de abril de 2024

• Atualize os tipos enumerados FeedType e FeedLongevity para usar valores em letras minúsculas nas respectivas páginas de referência.

17 de abril de 2024

• Adicionamos um elemento IsIndependent à página de referência de Party.

12 de fevereiro de 2024

• Adicionamos documentação em todo o site para o novo feed de metadados.

9 de janeiro de 2024

• Adição de suporte para contas Tiktok como um AnnotatedUri

3 de janeiro de 2024

• Atualização das Considerações internas com um pouco mais de nuances sobre como e quando traduzir ou transliterar dados.

July 24, 2023

• Adicionamos o tipo Committee para comitês políticos e um tipo de feed correspondente.

20 de janeiro de 2023

• Adicionamos um elemento Slogan à página de referência de Party.
• Adicionamos um elemento CampaignSlogan à página de referência de Candidate.

17 de novembro de 2022

• Adicionamos um guia para o processo de atualização de IDs da OCD.

30 de dezembro de 2021

• Adicionamos uma seção PartialDate à página Tipos de dados simples e atualizamos alguns campos da tabela.

27 de dezembro de 2021

• Modificamos o conteúdo na seção CandidateContest da página Contest para aceitar apenas um cargo por disputa, além de atualizar alguns dos exemplos de XML.

15 de outubro de 2021

• Adicionamos a seção ExternalIdentifier à página de referência de Candidate.

20 de agosto de 2021

• Criamos uma página OfficeSelectionMethod, adicionamos o elemento SelectionMethod à tabela de elementos Office. e atualizamos os exemplos de código.

26 de fevereiro de 2021

• Adicionamos um exemplo à página de referência Term sobre como representar o mandato de funcionários públicos reeleitos em um feed de funcionários públicos.

24 de fevereiro de 2021

• Adicionamos informações sobre party-chair-id ao material de referência de Party.

18 de fevereiro de 2021

• Adicionamos um diagrama ao material de referência do CandidatePreElectionStatus que ilustra o momento dos status.

14 de dezembro de 2020

• Adicionamos páginas de guias que descrevem os tipos de feed disponíveis. Atualizamos as páginas de referência para fornecer as práticas recomendadas para a maioria das entidades.