Feed

Uma entidade Feed representa um único stream 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 nos 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 ambos os países estiverem no escopo.

Um Feed tem uma 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

Elemento Multiplicidade Tipo Descrição
FeedId 1 string Um identificador exclusivo e estável para o ciclo de vida do feed. Não pode ser reutilizado em vários feeds.
FeedName 1 string Uma breve descrição do feed, como "Autoridades dos EUA 2023".
FeedType 1 FeedType Indica o tipo de feed de CDF.
FeedLongevity 1 FeedLongevity Indica o ciclo de vida do feed.
SourceDirPath 0 ou 1 FeedSourcePathUri URI do caminho de origem totalmente qualificado do arquivo XML do feed.

As seguintes soluções de hospedagem de arquivos são compatíveis:

  • s3
  • ftp e sftp
  • http e https

Ele 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.
CountryCode 0 ou 1 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.
FeedInactiveDate 0 ou 1 date Uma data 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 não será necessário definir esse campo, 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 da última 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. Ela pode ser definida ainda mais tarde se as eleições forem adiadas, se houver segundo turno em 2025 ou se os eventos eleitorais continuarem em 2025.
ElectionEventCollection 0 ou 1 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.
OfficeholderSubFeed 0 ou 1 OfficeholderSubFeed Contém informações sobre os ocupantes de cargos cobertos por este feed. Isso só é respeitado para o tipo de feed OFFICEHOLDER.