Flux

Une entité Feed représente un flux unique de fichiers de données CDF actifs ou à venir au fil du temps, qui correspondent à un pays et à un type de flux CDF spécifiques. Pour en savoir plus, consultez Types de flux. Un FeedDeliveryReport peut contenir plusieurs entités Feed pour un pays et un type de flux donnés, à condition que leurs champs d'application ne se chevauchent pas (champ d'application géographique, période ou niveau de bureau). Voici des exemples de combinaisons valides :

  • Un même FeedDeliveryReport peut contenir à la fois un Feed pour les titulaires de fonctions publiques aux États-Unis et un Feed pour les élections américaines (toujours d'actualité).
  • Un même FeedDeliveryReport peut contenir un Feed préélectoral américain (2022) et un Feed préélectoral américain (2024).
  • Un seul FeedDeliveryReport peut contenir un Feed préélectoral américain (uniquement au niveau fédéral en 2022) et un Feed préélectoral américain (uniquement au niveau des États en 2022).
  • Un seul FeedDeliveryReport peut contenir un titulaire de fonction américain Feed et un Feed japonais avant les élections (uniquement au niveau national en 2022), mais uniquement si les deux pays sont concernés.

Une Feed a une durée limitée, car une date de fin est prévue (par exemple, 60 jours après une élection), ou elle est "permanente", ce qui signifie qu'aucune date de fin n'est prévue et qu'elle est actualisée en permanence.

Attendez 60 jours après la FeedInactiveDate d'un flux avant de le supprimer du flux de métadonnées.

Éléments

Élément Multiplicité Type Description
FeedId 1 string Identifiant unique et stable pour la durée de vie du flux. Non réutilisable dans plusieurs flux.
FeedName 1 string Brève description du flux, par exemple "Fonctionnaires américains 2023".
FeedType 1 FeedType Indique le type de flux CDF.
FeedLongevity 1 FeedLongevity Indique la durée de vie du flux.
SourceDirPath 0 ou 1 FeedSourcePathUri URI du chemin d'accès complet au fichier XML du flux source.

Les solutions d'hébergement de fichiers suivantes sont acceptées :

  • s3
  • ftp et sftp
  • http et https

Il doit être accessible via la même solution d'hébergement de fichiers que le flux de métadonnées, mais peut être vide avant que les données ne soient prêtes.
SqsQueueName 0 ou 1 string Nom de la file d'attente SQS pour les flux dont les notifications push sont activées. Pour en savoir plus, consultez le guide du développeur SQS. Si ce paramètre n'est pas défini, les mises à jour du flux seront extraites à la place.
CountryCode 0 ou 1 string Code pays ISO 3166-1 alpha-2 couvert par ce flux. Obligatoire si FeedType n'est pas election-dates ni voter-information.
FeedInactiveDate 0 ou 1 date Date au format ISO-8601 indiquant quand le flux ne sera plus mis à jour et ne devra plus être ingéré.
  • Pour les flux evergreen, ce champ ne doit probablement pas être défini, sauf si le flux est obsolète.
  • Pour les flux limited, cette valeur doit être définie sur deux semaines après la date de fin de la dernière ElectionEvent du flux ou deux semaines après la date prévue de la dernière mise à jour post-électorale. Notez que si un ElectionEvent est annulé sans mise à jour attendue, le FeedInactiveDate peut précéder le EndDate pour le ElectionEvent.
  • Pour les flux yearly, comme pour les flux limited, cette date doit être définie au moins deux semaines après la date de fin du dernier ElectionEvent, mais elle ne doit pas non plus être antérieure à deux semaines après la fin de l'année à laquelle le flux se rapporte. Par exemple, pour un flux de 2024, FeedInactiveDate doit être défini sur 2025-01-14 dans le cas général où toutes les élections se sont terminées le 2024-12-31 ou avant. Elle pourra être définie encore plus tard si les élections sont reportées, si des seconds tours ont lieu en 2025 ou si des événements électoraux se poursuivent en 2025.
IsTest 0 ou 1 boolean Indique si le flux est un flux de test pour les simulations. La valeur par défaut est false si aucune valeur n'est spécifiée.
ElectionEventCollection 0 ou 1 ElectionEvent Contient des informations sur les élections couvertes par ce flux. Cette option n'est respectée que pour les types de flux PRE_ELECTION ou ELECTION_RESULTS.
OfficeholderSubFeed 0 ou 1 OfficeholderSubFeed Contient des informations sur les titulaires de fonctions couverts par ce flux. Cette valeur n'est respectée que pour le type de flux OFFICEHOLDER.