Kanał

Feed Encja reprezentuje pojedynczy aktywny lub nadchodzący strumień plików danych CDF w czasie, który odpowiada 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 czasu lub poziomu biura. Oto przykłady prawidłowych kombinacji:

  • Pojedynczy FeedDeliveryReport może zawierać zarówno Feed dotyczącą urzędników w USA, jak i Feed dotyczącą wyborów w USA (bezterminową).
  • Pojedynczy FeedDeliveryReport może zawierać Feed przed wyborami w USA (2022) i Feed przed wyborami w USA (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.).
  • Jeden 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

Element Mnogość Typ Opis
FeedId 1 string Unikalny i stały identyfikator przez cały okres istnienia pliku danych. Nie można ich używać w różnych plikach danych.
FeedName 1 string Krótki opis pliku danych, np. „US Officeholders 2023”.
FeedType 1 FeedType Określa typ pliku danych CDF.
FeedLongevity 1 FeedLongevity Wskazuje okres ważności pliku danych.
SourceDirPath 0 lub 1 FeedSourcePathUri Pełna i jednoznaczna ścieżka źródłowa identyfikatora URI pliku XML pliku danych.

Obsługiwane są te rozwiązania do hostowania plików:

  • s3
  • ftp i sftp
  • http i https

Musi być dostępny w tym samym rozwiązaniu do hostowania plików co plik danych o metadanych, ale przed przygotowaniem danych może być pusty.
SqsQueueName 0 lub 1 string Nazwa kolejki SQS dla plików danych z włączonymi powiadomieniami push. Więcej informacji znajdziesz w przewodniku dla programistów SQS. Jeśli nie zostanie skonfigurowana, zamiast tego zostaną pobrane aktualizacje pliku danych.
CountryCode 0 lub 1 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.
FeedInactiveDate 0 lub 1 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 ogóle ustawione, 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.
IsTest 0 lub 1 boolean Określa, czy plik danych jest plikiem testowym dla symulacji. Jeśli nie określono inaczej, przyjmuje wartość false.
ElectionEventCollection 0 lub 1 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.
OfficeholderSubFeed 0 lub 1 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.