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 geografisch noch im Zeitrahmen oder auf 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 einen japanischen Kandidaten vor der Wahl 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

Name Tag Typ Hinweise Multiplizität
Feed-ID FeedId string Eine eindeutige und unveränderliche Kennung für die Lebensdauer des Feeds. Nicht in mehreren Feeds wiederverwendbar. 1
Feedname FeedName string Eine kurze Beschreibung des Feeds, z. B. „US Officeholders 2023“ (US-Amtsträger 2023). 1
Feed-Typ FeedType FeedType Gibt an, um welche Art von CDF-Feed es sich handelt. 1
Langlebigkeit von Feeds FeedLongevity FeedLongevity Gibt die Lebensdauer des Feeds an. 1
Feed-Speicherort SourceDirPath string Vollständig qualifizierte URI der XML-Datei des Feeds (nur ftp und http werden unterstützt). Muss über dieselbe Dateihostinglösung wie der Metadatenfeed zugänglich sein (kann aber leer sein, bevor die Daten verfügbar sind). 0 oder 1
Ländercode CountryCode 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. 0 oder 1
Datum der Inaktivierung des Feeds FeedInactiveDate 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 Wahlereignisse anderweitig bis ins Jahr 2025 andauern.
0 oder 1
Erhebung von Wahldaten ElectionEventCollection 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. 0 oder 1
Unterfeed für Amtsinhaber OfficeholderSubFeed OfficeholderSubFeed Enthält Informationen zu den Amtsträgern, die in diesem Feed enthalten sind. Dies wird nur für den Feedtyp OFFICEHOLDER berücksichtigt. 0 oder 1