Feed

Uma entidade Feed representa um único fluxo ativo ou futuro de arquivos de dados da CDF ao longo do tempo que correspondem a um país específico e a um tipo de feed da CDF. Para mais detalhes, consulte Tipos de feed. Um FeedDeliveryReport pode conter várias entidades Feed para um determinado país e tipo de feed, desde que os escopos não se sobreponham por escopo geográfico, período ou nível de escritório. Confira alguns exemplos de combinações válidas:

  • Um único FeedDeliveryReport pode conter um Feed de ocupantes de cargos públicos dos EUA e um Feed pré-eleitoral dos EUA (permanente).
  • Um único FeedDeliveryReport pode conter uma Feed pré-eleitoral dos EUA (2022) e uma Feed pré-eleitoral dos EUA (2024).
  • Um único FeedDeliveryReport pode conter uma Feed pré-eleitoral dos EUA (somente nível federal de 2022) e uma Feed pré-eleitoral dos EUA (somente nível estadual de 2022).
  • Um único FeedDeliveryReport pode conter um Feed de um cargo público dos EUA e um Feed pré-eleitoral do Japão (somente nível nacional de 2022), mas apenas se os dois países estiverem no escopo.

Um Feed tem duração limitada, porque há uma data de término esperada (como 60 dias após uma eleição), ou é "permanente", o que significa que não há uma data de término esperada e ele é atualizado continuamente.

Aguarde 60 dias após a FeedInactiveDate de um feed antes de removê-lo do feed de metadados.

Elementos

Nome Tag Tipo Observações Multiplicidade
ID de feed FeedId String Um identificador exclusivo e estável para o ciclo de vida do feed. Não pode ser reutilizado em vários feeds. 1
Nome do feed FeedName String Uma breve descrição do feed, como "Autoridades dos EUA 2023". 1
Tipo de feed FeedType FeedType Indica o tipo de feed de CDF. 1
Longevidade do feed FeedLongevity FeedLongevity Indica a vida útil do feed. 1
Local do feed SourceDirPath String URI totalmente qualificado do arquivo XML do feed. Somente ftp e http são compatíveis. Precisa estar acessível pela mesma solução de hospedagem de arquivos que o feed de metadados, mas pode estar vazio antes que os dados estejam prontos. 0 ou 1
Código do país CountryCode String O código do país ISO 3166-1 alfa-2 que este feed abrange. Obrigatório se FeedType não for election-dates ou voter-information. 0 ou 1
Data de inatividade do feed FeedInactiveDate xs:date É uma data e hora no formato ISO-8601 que indica quando o feed não será mais atualizado e não deverá mais ser ingerido.
  • Para feeds evergreen, provavelmente isso não será definido, a menos que o feed esteja sendo descontinuado.
  • Para feeds de limited, isso deve ser definido como duas semanas após a data de término do último ElectionEvent no feed ou duas semanas após a previsão da última atualização pós-eleição. Se um ElectionEvent for cancelado sem atualizações esperadas, o FeedInactiveDate poderá preceder o EndDate para o ElectionEvent.
  • Para feeds yearly, assim como os feeds limited, isso precisa ser definido para pelo menos duas semanas após a data de término do último ElectionEvent, mas também não pode ser antes de duas semanas após o fim do ano a que o feed se refere. Por exemplo, para um feed de 2024, o FeedInactiveDate precisa ser definido como 2025-01-14 no caso comum em que todas as eleições terminaram em ou antes de 2024-12-31. Ele pode ser definido ainda mais tarde se as eleições forem adiadas, se houver segundo turno em 2025 ou se os eventos eleitorais continuarem em 2025.
0 ou 1
Coleta de eventos eleitorais ElectionEventCollection ElectionEvent Contém informações sobre as eleições cobertas por este feed. Isso só é respeitado para os tipos de feed PRE_ELECTION ou ELECTION_RESULTS. 0 ou 1
Subfeed de titulares de cargos OfficeholderSubFeed OfficeholderSubFeed Contém informações sobre os ocupantes de cargos cobertos por este feed. Isso só é respeitado para o tipo de feed OFFICEHOLDER. 0 ou 1