Kanał

Feed Encja 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:

  • Pojedynczy FeedDeliveryReport może zawierać zarówno Feed dotyczące urzędników w USA, jak i Feed przedwyborcze w USA (bezterminowe).
  • Pojedynczy FeedDeliveryReport może zawierać informacje o wyborach w USA Feed (2022) i o wyborach w USA Feed (2024).
  • Pojedynczy FeedDeliveryReport może zawierać informacje o Feedprzedwyborczych w USAFeed (tylko na poziomie federalnym w 2022 r.) i Feedprzedwyborczych w USAFeed (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 metadanych, odczekaj 60 dni od FeedInactiveDate.

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 wartość FeedType nie jest równa election-dates ani voter-information. 0 lub 1
Data dezaktywacji pliku danych FeedInactiveDate date Data w formacie ISO-8601, która wskazuje, kiedy plik danych nie będzie już aktualizowany i nie powinien być już przetwarzany.
  • W przypadku plików danych evergreen to ustawienie najprawdopodobniej nie powinno być włączone, chyba że plik danych jest wycofywany.
  • W przypadku plików danych limited powinna to być data 2 tygodnie po dacie zakończenia ostatniego ElectionEvent w pliku danych lub 2 tygodnie po oczekiwanej dacie 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 ważności 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 roku 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 zdarzeniach 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