Flux

Une entité Feed représente un seul flux actif ou à venir de fichiers de données CDF 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, que ce soit au niveau géographique, de la période ou du 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 (permanent).
  • 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 même FeedDeliveryReport peut contenir un Feed américain 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

Nom Tag Type Remarques Multiplicité
ID du flux FeedId String Identifiant unique et stable pour la durée de vie du flux. Non réutilisable dans plusieurs flux. 1
Nom du flux FeedName String Brève description du flux, par exemple "Fonctionnaires américains 2023". 1
Type de flux FeedType FeedType Indique le type de flux CDF. 1
Longévité du flux FeedLongevity FeedLongevity Indique la durée de vie du flux. 1
Emplacement du flux SourceDirPath String URI complet du fichier XML du flux (seuls ftp et http sont acceptés). 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). 0 ou 1
Code de pays CountryCode String Code pays ISO 3166-1 alpha-2 couvert par ce flux. Obligatoire si FeedType n'est pas election-dates ni voter-information. 0 ou 1
Date de désactivation du flux FeedInactiveDate xs:date Date et heure au format ISO-8601 indiquant quand le flux ne sera plus mis à jour et ne devra plus être ingéré.
  • Pour les flux evergreen, il est préférable de ne pas définir ce champ, 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, la valeur FeedInactiveDate doit être définie 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.
0 ou 1
Collecte d'événements électoraux ElectionEventCollection 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. 0 ou 1
Sous-flux des titulaires de postes OfficeholderSubFeed 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. 0 ou 1