Feed

Un'entità Feed rappresenta un singolo stream 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, a condizione che i loro ambiti non si sovrappongano, né per ambito geografico, né per periodo di tempo, né per livello di carica. Di seguito sono riportati alcuni esempi di combinazioni valide:

  • Un singolo FeedDeliveryReport può contenere sia un Feed dei titolari di cariche statunitensi 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 Feed dei titolari di cariche statunitensi e un Feed pre-elettorale giapponese (solo a livello nazionale 2022), ma solo se entrambi i paesi sono inclusi nell'ambito.

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

Attendi 60 giorni dopo la 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 tra i feed.
FeedName 1 string Una breve descrizione del feed, ad esempio "Titolari di cariche statunitensi 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 di file:

  • s3
  • ftp e sftp
  • http e https

Questo percorso deve essere accessibile tramite la stessa soluzione di hosting di file del feed di metadati, ma può essere vuoto prima che i dati siano pronti.
SqsQueueName 0 o 1 string Il nome completo della risorsa Amazon (ARN) della coda SQS per i feed con notifiche push attivate (ad esempio, arn:aws:sqs:region:account-id:queue-name). Per maggiori dettagli, consulta la Guida per gli sviluppatori di SQS. Se non è impostata, gli aggiornamenti del feed verranno recuperati.
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 in formato ISO-8601 che indica quando il feed non verrà più aggiornato e non dovrà più essere importato.
  • Per i feed evergreen, questa proprietà non deve essere impostata, a meno che il feed non sia in fase di ritiro.
  • Per i feed limited, questa proprietà deve essere impostata 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, FeedInactiveDate può precedere il EndDate per il ElectionEvent.
  • Per i feed yearly, come per i feed limited, questa proprietà deve essere impostata su almeno due settimane dopo la data di fine dell'ultimo ElectionEvent, ma non deve essere precedente a due settimane dopo la fine dell'anno a cui si riferisce il feed. Ad esempio, per un feed del 2024, FeedInactiveDate deve essere impostata su 2025-01-14 nel caso comune in cui tutte le elezioni siano terminate entro il 2024-12-31 o prima. Può essere impostata anche in un secondo momento se le elezioni vengono rinviate, se si svolgono ballottaggi nel 2025 o se gli eventi elettorali continuano in altro modo nel 2025.
IsTest 0 o 1 boolean Indica se il feed è un feed di test per le simulazioni. Se non specificato, il valore predefinito è false.
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 sui titolari di cariche coperte da questo feed. Questa proprietà viene rispettata solo per il tipo di feed OFFICEHOLDER.