Feed

Un'entità Feed rappresenta un singolo flusso attivo o imminente di file di dati CDF nel tempo che corrispondono a un paese specifico e a un tipo di feed CDF. Per maggiori dettagli, vedi Tipi di feed. Un FeedDeliveryReport può contenere più entità Feed per un determinato paese e tipo di feed, purché i loro ambiti non si sovrappongano per ambito geografico, periodo di tempo o livello di ufficio. Di seguito sono riportati alcuni esempi di combinazioni valide:

  • Un singolo FeedDeliveryReport può contenere sia un Feed di un funzionario statunitense sia un Feed pre-elettorale statunitense (sempreverde).
  • Un singolo FeedDeliveryReport può contenere un Feed pre-elettorale statunitense (2022) e un Feed pre-elettorale statunitense (2024).
  • Un singolo FeedDeliveryReport può contenere un Feed pre-elettorale statunitense (solo a livello federale 2022) e un Feed pre-elettorale statunitense (solo a livello statale 2022).
  • Un singolo FeedDeliveryReport può contenere un funzionario statunitense Feed e un pre-elettorale giapponese Feed (solo a livello nazionale nel 2022), ma solo se entrambi i paesi rientrano nell'ambito.

Un Feed ha una durata limitata, perché è prevista una data di fine (ad esempio 60 giorni dopo un'elezione), oppure è "evergreen", il che significa che non è prevista una data di fine ed è continuamente aggiornato.

Attendi 60 giorni dopo il FeedInactiveDate di un feed prima di rimuoverlo dal feed di metadati.

Elementi

Elemento Molteplicità Tipo Descrizione
FeedId 1 string Un identificatore univoco e stabile per la durata del feed. Non riutilizzabile in più feed.
FeedName 1 string Una breve descrizione del feed, ad esempio "Funzionari pubblici degli Stati Uniti 2023".
FeedType 1 FeedType Indica il tipo di feed CDF.
FeedLongevity 1 FeedLongevity Indica la durata del feed.
SourceDirPath 0 o 1 FeedSourcePathUri URI del percorso di origine completo del file XML del feed.

Sono supportate le seguenti soluzioni di hosting dei file:

  • s3
  • ftp e sftp
  • http e https

Deve essere accessibile tramite la stessa soluzione di hosting dei file del feed di metadati, ma può essere vuoto prima che i dati siano pronti.
CountryCode 0 o 1 string Il codice paese ISO 3166-1 alpha-2 coperto da questo feed. Obbligatorio se FeedType non è election-dates o voter-information.
FeedInactiveDate 0 o 1 date Una data nel formato ISO-8601 che indica quando il feed non verrà più aggiornato e non deve più essere importato.
  • Per i feed evergreen, è molto probabile che non debba essere impostato a meno che il feed non venga ritirato.
  • Per i feed limited, questo valore deve essere impostato su due settimane dopo la data di fine dell'ultimo ElectionEvent nel feed o due settimane dopo l'ultimo aggiornamento post-elettorale previsto. Tieni presente che se un ElectionEvent viene annullato senza aggiornamenti previsti, il FeedInactiveDate può precedere il EndDate per il ElectionEvent.
  • Per i feed yearly, come per i feed limited, questa data deve essere impostata almeno due settimane dopo la data di fine dell'ultimo ElectionEvent, ma non deve essere precedente di due settimane alla fine dell'anno a cui si riferisce il feed. Ad esempio, per un feed del 2024, FeedInactiveDate deve essere impostato su 2025-01-14 nel caso comune in cui tutte le elezioni si sono concluse entro il giorno 2024-12-31. Potrebbe essere impostata anche in un secondo momento se le elezioni vengono rinviate, se si verificano ballottaggi nel 2025 o se gli eventi elettorali continuano nel 2025.
ElectionEventCollection 0 o 1 ElectionEvent Contiene informazioni sulle elezioni coperte da questo feed. Questa proprietà viene rispettata solo per i tipi di feed PRE_ELECTION o ELECTION_RESULTS.
OfficeholderSubFeed 0 o 1 OfficeholderSubFeed Contiene informazioni sulle cariche coperte da questo feed. Questo valore viene rispettato solo per il tipo di feed OFFICEHOLDER.