Kanał

Encja Feed 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. Element FeedDeliveryReport może zawierać wiele encji Feed dla danego kraju i typu pliku danych, o ile ich zakresy nie nakładają się na siebie pod względem geograficznym zakresu, czasowym lub poziomu urzędu. Oto przykłady prawidłowych kombinacji:

  • Pojedynczy element FeedDeliveryReport może zawierać zarówno plik danych Feed dotyczący urzędników w Stanach Zjednoczonych, jak i plik danych Feed dotyczący wyborów w Stanach Zjednoczonych (stały).
  • Pojedynczy element FeedDeliveryReport może zawierać plik danych Feed dotyczący wyborów w Stanach Zjednoczonych (2022) i plik danych Feed dotyczący wyborów w Stanach Zjednoczonych (2024).
  • Pojedynczy element FeedDeliveryReport może zawierać plik danych Feed dotyczący wyborów w Stanach Zjednoczonych (2022, tylko na poziomie federalnym) i plik danych Feed dotyczący wyborów w Stanach Zjednoczonych (2022, tylko na poziomie stanowym).
  • Pojedynczy FeedDeliveryReport może zawierać plik danych Feed dotyczący urzędników w Stanach Zjednoczonych i plik danych Feed dotyczący wyborów w Japonii (2022, tylko na poziomie krajowym), ale tylko wtedy, gdy oba kraje są w zakresie.

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

Przed usunięciem pliku danych z pliku danych metadanych poczekaj 60 dni od daty FeedInactiveDate.

Elementy

Element Mnogość Typ Opis
FeedId 1 string Unikalny i niezmienny identyfikator przez cały okres istnienia pliku danych. Nie można go ponownie użyć w innych plikach danych.
FeedName 1 string Krótki opis pliku danych, np. „Urzędnicy w Stanach Zjednoczonych 2023”.
FeedType 1 FeedType Wskazuje, jaki to typ pliku danych CDF.
FeedLongevity 1 FeedLongevity Wskazuje okres istnienia 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 za pomocą tego samego rozwiązania do hostowania plików co plik danych metadanych, ale przed przygotowaniem danych może być pusty.
SqsQueueName 0 lub 1 string Pełna i jednoznaczna nazwa zasobu Amazon (ARN) kolejki SQS w przypadku plików danych z włączonymi powiadomieniami push (np. arn:aws:sqs:region:account-id:queue-name). Więcej informacji znajdziesz w przewodniku dla programistów SQS. Jeśli nie zostanie ustawiona, aktualizacje pliku danych będą pobierane.
CountryCode 0 lub 1 string Kod kraju w formacie ISO 3166-1 alpha-2, którego dotyczy ten plik danych. Wymagany, jeśli FeedType nie jest równy 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ż importowany.
  • W przypadku plików danych evergreen nie należy jej ustawiać, chyba że plik danych jest wycofywany.
  • W przypadku plików danych limited należy ją ustawić na 2 tygodnie po dacie zakończenia ostatniego elementu ElectionEvent w pliku danych lub 2 tygodnie po oczekiwanej ostatniej aktualizacji po wyborach. Jeśli element ElectionEvent zostanie anulowany bez oczekiwanych aktualizacji, element FeedInactiveDate może poprzedzać element EndDate elementu ElectionEvent.
  • W przypadku plików danych yearly (podobnie jak w przypadku plików danych limited ) należy ją ustawić na co najmniej 2 tygodnie po dacie zakończenia ostatniego elementu 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 w typowym przypadku, gdy wszystkie wybory zakończyły się 2024-12-31 lub wcześniej. Może być ustawiona jeszcze później, jeśli wybory zostaną przełożone, jeśli w 2025 r. odbędą się dogrywki lub jeśli wydarzenia wyborcze będą kontynuowane w 2025 r.
IsTest 0 lub 1 boolean Określa, czy plik danych jest plikiem testowym na potrzeby symulacji. Jeśli nie określono inaczej, przyjmuje się wartość false.
ElectionEventCollection 0 lub 1 ElectionEvent Zawiera informacje o wyborach objętych tym plikiem danych. Jest uwzględniany tylko w przypadku typów plików danych PRE_ELECTION lub ELECTION_RESULTS.
OfficeholderSubFeed 0 lub 1 OfficeholderSubFeed Zawiera informacje o urzędnikach objętych tym plikiem danych. Jest uwzględniany tylko w przypadku typu pliku danych OFFICEHOLDER.