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 zeitlich oder auf Büroebe). Hier einige Beispiele für gültige Kombinationen:

  • Ein einzelnes FeedDeliveryReport kann sowohl ein Feed für Amtsinhaber in den USA als auch ein Feed für die Vorwahl in den USA (immergrün) 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.

Eine Feed hat entweder eine begrenzte Dauer, weil es ein erwartetes Enddatum gibt (z. B. 60 Tage nach einer Wahl), oder sie ist „immergrün“, d. h., es gibt kein erwartetes Enddatum und sie wird fortlaufend 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 stabile 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 welchen Typ 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. 1
Datum der Inaktivierung des Feeds FeedInactiveDate xs:date Ein Datum und eine Uhrzeit im ISO 8601-Format, die angibt, wann der Feed nicht mehr aktualisiert wird und nicht mehr aufgenommen werden sollte.
  • Bei evergreen-Feeds sollte dieser Wert in den meisten Fällen 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 auf 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 dieses Feld wie bei limited-Feeds mindestens zwei Wochen nach dem Enddatum des letzten ElectionEvent liegen, aber auch nicht früher als zwei Wochen nach dem Ende des Jahres, für das der Feed bestimmt ist. Für einen 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
Erfassung 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