Kanał

FeedEncja reprezentuje pojedynczy aktywny lub nadchodzący strumień plików danych CDF w czasie, które odpowiadają konkretnemu krajowi i typowi pliku danych CDF. Więcej informacji znajdziesz w artykule Typy plików danych. FeedDeliveryReport może zawierać wiele elementów Feed dla danego kraju i typu pliku danych, o ile ich zakresy nie nakładają się na siebie pod względem zakresu geograficznego, przedziału czasowego lub poziomu biura. Oto przykłady prawidłowych kombinacji:

  • Pojedyncza FeedDeliveryReport może zawierać zarówno Feed dotyczące urzędników w Stanach Zjednoczonych, jak i Feed przedwyborcze (stałe).
  • Pojedynczy FeedDeliveryReport może zawierać informacje o wyborach w USA Feed (2022) i o wyborach w USA Feed (2024).
  • Jeden plik FeedDeliveryReport może zawierać informacje o wyborach w USA przed głosowaniem Feed (tylko na poziomie federalnym w 2022 r.) i informacje o wyborach w USA przed głosowaniem Feed (tylko na poziomie stanowym w 2022 r.).
  • Pojedynczy FeedDeliveryReport może zawierać Feed urzędnika w Stanach Zjednoczonych i Feed kandydata w Japonii przed wyborami (tylko na poziomie krajowym w 2022 r.), ale tylko wtedy, gdy oba kraje są objęte zakresem.

Feed ma ograniczony czas trwania, ponieważ ma oczekiwaną datę zakończenia (np. 60 dni po wyborach), lub jest „wiecznie zielona”, co oznacza, że nie ma oczekiwanej daty zakończenia i jest stale odświeżana.

Zanim usuniesz plik danych z pliku danych z metadanymi, odczekaj 60 dni od FeedInactiveDate pliku danych.

Elementy

Nazwa Tag Typ Uwagi Mnogość
Identyfikator kanału RSS FeedId String Unikalny i stały identyfikator przez cały okres istnienia pliku danych. Nie można ich używać w różnych plikach danych. 1
Nazwa pliku danych FeedName String Krótki opis pliku danych, np. „US Officeholders 2023”. 1
Typ pliku danych FeedType FeedType Określa typ pliku danych CDF. 1
Okres ważności pliku danych FeedLongevity FeedLongevity Wskazuje okres ważności pliku danych. 1
Lokalizacja pliku danych SourceDirPath String W pełni kwalifikowany identyfikator URI pliku XML pliku danych (obsługiwane są tylko ftp i http). Musi być dostępny w tym samym rozwiązaniu do hostowania plików co plik danych metadanych (ale przed przygotowaniem danych może być pusty). 0 lub 1
Kod kraju CountryCode String Kod kraju w formacie ISO 3166-1 alfa-2, którego dotyczy ten plik danych. Wymagany, jeśli FeedType nie ma wartości election-dates lub voter-information. 0 lub 1
Data dezaktywacji pliku danych FeedInactiveDate xs:date Data i godzina w formacie ISO-8601, które wskazują, kiedy plik danych nie będzie już aktualizowany i nie powinien być już przetwarzany.
  • W przypadku plików danych evergreen to ustawienie nie powinno być włączone, chyba że plik danych jest wycofywany.
  • W przypadku plików danych limited powinna to być data o 2 tygodnie późniejsza od daty zakończenia ostatniego ElectionEvent w pliku danych lub o 2 tygodnie późniejsza od daty ostatniej aktualizacji po wyborach. Pamiętaj, że jeśli ElectionEvent zostanie anulowane bez oczekiwanych aktualizacji, FeedInactiveDate może poprzedzać EndDate w przypadku ElectionEvent.
  • W przypadku plików danych yearly, podobnie jak w przypadku plików danych limited, data ta powinna przypadać co najmniej 2 tygodnie po dacie zakończenia ostatniego ElectionEvent, ale nie wcześniej niż 2 tygodnie po zakończeniu roku, którego dotyczy plik danych. Na przykład w przypadku pliku danych z 2024 r. element FeedInactiveDate powinien mieć wartość 2025-01-14, jeśli wszystkie wybory zakończyły się najpóźniej 2024-12-31. Może ona zostać ustalona jeszcze później, jeśli wybory zostaną przełożone, jeśli w 2025 r. odbędą się dogrywki lub jeśli wydarzenia związane z wyborami będą trwały w 2025 r.
0 lub 1
Zbieranie danych o wydarzeniach związanych z wyborami ElectionEventCollection ElectionEvent Zawiera informacje o wyborach, których dotyczy ten plik danych. Jest to uwzględniane tylko w przypadku typów plików danych PRE_ELECTION lub ELECTION_RESULTS. 0 lub 1
Podrzędny plik danych o urzędnikach OfficeholderSubFeed OfficeholderSubFeed Zawiera informacje o osobach pełniących funkcje publiczne, których dotyczy ten plik danych. Jest to uwzględniane tylko w przypadku plików danych typu OFFICEHOLDER. 0 lub 1