Flux

Une entité Feed représente un flux unique, actif ou à venir, de fichiers de données CDF au fil du temps, qui correspond à un pays spécifique et à un type de flux CDF. Pour en savoir plus, consultez la section 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 fonction). Voici des exemples de combinaisons valides :

  • Un seul FeedDeliveryReport peut contenir à la fois un Feed de titulaires de fonctions aux États-Unis et un Feed de pré-élection aux États-Unis (permanent).
  • Un seul FeedDeliveryReport peut contenir un Feed de pré-élection aux États-Unis (2022) et un Feed de pré-élection aux États-Unis (2024).
  • Un seul FeedDeliveryReport peut contenir un Feed de pré-élection aux États-Unis (2022, niveau fédéral uniquement) et un Feed de pré-élection aux États-Unis (2022, niveau de l'État uniquement).
  • Un seul FeedDeliveryReport peut contenir un Feed de titulaires de fonctions aux États-Unis et un Feed de pré-élection au Japon (2022, niveau national uniquement), mais seulement si les deux pays sont inclus dans le champ d'application.

Un Feed a une durée limitée, car une date de fin est prévue (par exemple, 60 jours après une élection), ou il est "permanent", ce qui signifie qu'aucune date de fin n'est prévue et qu'il est actualisé 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 les flux.
FeedName 1 string Brève description du flux, par exemple "Titulaires de fonctions aux États-Unis en 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.

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 il peut être vide avant que les données ne soient prêtes.
SqsQueueName 0 ou 1 string Nom de ressource Amazon (ARN) complet de la file d'attente SQS pour les flux pour lesquels les notifications push sont activées (par exemple, arn:aws:sqs:region:account-id:queue-name). Pour en savoir plus, consultez le guide du développeur SQS. Si cette option n'est pas définie, 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 ou 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, cette option ne doit probablement pas être définie, sauf si le flux est abandonné.
  • Pour les flux limited, cette option doit être définie sur deux semaines après la date de fin du dernier ElectionEvent du flux ou deux semaines après la dernière mise à jour post-électorale prévue. Notez que si un ElectionEvent est annulé sans mise à jour prévue, alors la FeedInactiveDate peut précéder la EndDate pour le ElectionEvent.
  • Pour les flux yearly, comme pour les flux limited, cette option doit être définie sur au moins deux semaines après la date de fin du dernier ElectionEvent, mais elle ne doit pas être antérieure à deux semaines après la fin de l'année pour laquelle le flux est destiné. Par exemple, pour un flux de 2024, le FeedInactiveDate doit être défini sur 2025-01-14 dans le cas courant où toutes les élections se sont terminées au plus tard le 2024-12-31. Elle peut ê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 elle n'est pas 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 option n'est respectée que pour le type de flux OFFICEHOLDER.