Feed

Uma entidade Feed representa um único stream ativo ou futuro de arquivos de dados da CDF ao longo do tempo que corresponde 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 (conteúdo atemporal) de pré-eleição nos EUA.
  • 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

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 a vida útil 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.
SqsQueueName 0 ou 1 string O nome da fila do SQS para feeds com notificações push ativadas. Para mais detalhes, consulte o guia do desenvolvedor do SQS. Se não for definido, as atualizações do feed serão extraídas.
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 é 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 do último ElectionEvent no feed ou duas semanas após a previsão da última atualização pós-eleição. Observe que, se um ElectionEvent for cancelado sem atualizações esperadas, o FeedInactiveDate poderá preceder o EndDate do 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.
IsTest 0 ou 1 boolean Indica se o feed é de teste para simulações. O padrão é false se não for especificado.
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.