Feed

Eine Feed-Einheit stellt einen einzelnen aktiven oder bevorstehenden Stream von CDF-Datendateien im Zeitverlauf dar, der einem bestimmten Land und CDF-Feedtyp entspricht. Weitere Informationen finden Sie unter Feedtypen. Ein FeedDeliveryReport kann mehrere Feed-Entitäten für ein bestimmtes Land und einen bestimmten Feedtyp enthalten, sofern sich ihre Bereiche nicht überschneiden, weder nach geografischem Bereich, Zeitraum noch Büroebe. Hier einige Beispiele für gültige Kombinationen:

  • Eine einzelne FeedDeliveryReport kann sowohl eine Feed für Amtsinhaber in den USA als auch eine Feed für die Vorwahl in den USA (immer aktuell) enthalten.
  • Ein einzelnes FeedDeliveryReport kann eine Feed für die Vorwahlen in den USA (2022) und eine Feed für die Vorwahlen in den USA (2024) enthalten.
  • Ein einzelner FeedDeliveryReport kann eine Feed für die Vorwahl in den USA (nur auf Bundesebene 2022) und eine Feed für die Vorwahl in den USA (nur auf Bundesstaatsebene 2022) enthalten.
  • Ein einzelnes FeedDeliveryReport kann einen US-Amtsinhaber Feed und eine japanische Vorwahl Feed (nur auf nationaler Ebene 2022) enthalten, aber nur, wenn beide Länder im Geltungsbereich liegen.

Ein Feed hat entweder eine begrenzte Dauer, da es ein erwartetes Enddatum gibt (z. B. 60 Tage nach einer Wahl), oder es ist „immergrün“, d. h., es gibt kein erwartetes Enddatum und es wird kontinuierlich aktualisiert.

Warten Sie 60 Tage nach dem FeedInactiveDate eines Feeds, bevor Sie ihn aus dem Metadatenfeed entfernen.

Elemente

Element Multiplizität Typ Beschreibung
FeedId 1 string Eine eindeutige und unveränderliche Kennung für die Lebensdauer des Feeds. Nicht in mehreren Feeds wiederverwendbar.
FeedName 1 string Eine kurze Beschreibung des Feeds, z. B. „US Officeholders 2023“ (US-Amtsträger 2023).
FeedType 1 FeedType Gibt an, um welche Art von CDF-Feed es sich handelt.
FeedLongevity 1 FeedLongevity Gibt die Lebensdauer des Feeds an.
SourceDirPath 0 oder 1 FeedSourcePathUri Vollständig qualifizierter Quellpfad-URI der XML-Datei des Feeds.

Die folgenden Dateihosting-Lösungen werden unterstützt:

  • s3
  • ftp und sftp
  • http und https

Diese muss über dieselbe Dateihostinglösung wie der Metadatenfeed zugänglich sein, kann aber leer sein, bevor die Daten bereit sind.
CountryCode 0 oder 1 string Der ISO 3166-1-Alpha-2-Ländercode, der in diesem Feed enthalten ist. Erforderlich, wenn FeedType nicht election-dates oder voter-information ist.
FeedInactiveDate 0 oder 1 date Ein Datum im ISO 8601-Format, das angibt, wann der Feed nicht mehr aktualisiert wird und nicht mehr aufgenommen werden sollte.
  • Bei evergreen-Feeds sollte dieser Wert in der Regel nicht festgelegt werden, es sei denn, der Feed wird eingestellt.
  • Bei limited-Feeds sollte dieser Wert auf zwei Wochen nach dem Enddatum des letzten ElectionEvent im Feed oder zwei Wochen nach dem erwarteten Datum des letzten Updates nach der Wahl festgelegt werden. Wenn ein ElectionEvent ohne erwartete Updates storniert wird, kann das FeedInactiveDate dem EndDate für das ElectionEvent vorangehen.
  • Bei yearly-Feeds sollte dieser Wert wie bei limited-Feeds mindestens zwei Wochen nach dem Enddatum des letzten ElectionEvent liegen, aber auch nicht vor zwei Wochen nach dem Ende des Jahres, für das der Feed bestimmt ist. Bei einem Feed für 2024 sollte FeedInactiveDate beispielsweise auf 2025-01-14 festgelegt werden, wenn alle Wahlen am oder vor dem 2024-12-31 beendet wurden. Das Datum kann sich auch noch weiter nach hinten verschieben, wenn Wahlen verschoben werden, wenn 2025 Stichwahlen stattfinden oder wenn Wahlveranstaltungen anderweitig bis ins Jahr 2025 andauern.
ElectionEventCollection 0 oder 1 ElectionEvent Enthält Informationen zu Wahlen, die in diesem Feed behandelt werden. Dies wird nur für die Feedtypen PRE_ELECTION oder ELECTION_RESULTS berücksichtigt.
OfficeholderSubFeed 0 oder 1 OfficeholderSubFeed Enthält Informationen zu den Amtsträgern, die in diesem Feed enthalten sind. Dies wird nur für den Feedtyp OFFICEHOLDER berücksichtigt.