Nguồn cấp dữ liệu

Thực thể Feed đại diện cho một luồng tệp dữ liệu CDF đang hoạt động hoặc sắp tới theo thời gian, tương ứng với một quốc gia cụ thể và loại nguồn cấp dữ liệu CDF. Để biết thêm thông tin chi tiết, hãy xem bài viết Các loại nguồn cấp dữ liệu. Một FeedDeliveryReport có thể chứa nhiều thực thể Feed cho một quốc gia và loại nguồn cấp dữ liệu nhất định, miễn là phạm vi của các thực thể đó không trùng lặp, cho dù là theo phạm vi địa lý, khung thời gian hay cấp văn phòng. Sau đây là ví dụ về các tổ hợp hợp lệ:

  • Một FeedDeliveryReport có thể chứa cả Feed của quan chức Hoa Kỳ và Feed trước bầu cử ở Hoa Kỳ (không thay đổi).
  • Một FeedDeliveryReport có thể chứa một Feed trước bầu cử ở Hoa Kỳ (2022) và một Feed trước bầu cử ở Hoa Kỳ (2024).
  • Một FeedDeliveryReport có thể chứa Feed trước bầu cử ở Hoa Kỳ (Chỉ ở cấp liên bang năm 2022) và chứa Feed trước bầu cử ở Hoa Kỳ (Chỉ ở cấp tiểu bang năm 2022).
  • Một FeedDeliveryReport có thể chứa một chức vụ công Feed ở Hoa Kỳ và một chức vụ công Feed trước bầu cử ở Nhật Bản (Chỉ ở cấp quốc gia năm 2022), nhưng chỉ khi cả hai quốc gia đều thuộc phạm vi.

Feed có thời hạn giới hạn vì có ngày kết thúc dự kiến (chẳng hạn như 60 ngày sau một cuộc bầu cử) hoặc là "thường xanh", tức là không có ngày kết thúc dự kiến và được làm mới liên tục.

Chờ đến 60 ngày sau FeedInactiveDate của một nguồn cấp dữ liệu rồi mới xoá nguồn cấp dữ liệu đó khỏi nguồn cấp dữ liệu siêu dữ liệu.

Thành phần

Phần tử Số bội Loại Mô tả
FeedId 1 string Giá trị nhận dạng duy nhất và cố định trong suốt thời gian tồn tại của nguồn cấp dữ liệu. Không thể sử dụng lại trên nhiều nguồn cấp dữ liệu.
FeedName 1 string Nội dung mô tả ngắn cho nguồn cấp dữ liệu, chẳng hạn như "Quan chức Hoa Kỳ năm 2023".
FeedType 1 FeedType Cho biết loại nguồn cấp dữ liệu CDF này.
FeedLongevity 1 FeedLongevity Cho biết thời gian tồn tại của nguồn cấp dữ liệu.
SourceDirPath 0 hoặc 1 FeedSourcePathUri URI đường dẫn nguồn đủ điều kiện của tệp XML trong nguồn cấp dữ liệu.

Chúng tôi hỗ trợ các giải pháp lưu trữ tệp sau đây:

  • s3
  • ftp và sftp
  • http và https

Bạn phải truy cập được vào tệp này thông qua cùng một giải pháp lưu trữ tệp như nguồn cấp dữ liệu siêu dữ liệu, nhưng có thể để trống trước khi dữ liệu sẵn sàng.
CountryCode 0 hoặc 1 string Mã quốc gia theo ISO 3166-1 alpha-2 mà nguồn cấp dữ liệu này bao gồm. Bắt buộc nếu FeedType không phải là election-dates hoặc voter-information.
FeedInactiveDate 0 hoặc 1 date Ngày ở định dạng ISO-8601 cho biết thời điểm nguồn cấp dữ liệu sẽ không còn được cập nhật và không nên được nhập nữa.
  • Đối với nguồn cấp dữ liệu evergreen, bạn không nên đặt thuộc tính này trừ phi nguồn cấp dữ liệu đang bị ngừng sử dụng.
  • Đối với limited nguồn cấp dữ liệu, bạn nên đặt giá trị này thành 2 tuần sau ngày kết thúc của ElectionEvent gần đây nhất trong nguồn cấp dữ liệu hoặc 2 tuần sau khi có bản cập nhật cuối cùng sau bầu cử. Xin lưu ý rằng nếu một ElectionEvent bị huỷ mà không có nội dung cập nhật dự kiến, thì FeedInactiveDate có thể đi trước EndDate cho ElectionEvent.
  • Đối với nguồn cấp dữ liệu yearly, giống như nguồn cấp dữ liệu limited, bạn nên đặt giá trị này thành ít nhất 2 tuần sau ngày kết thúc của ElectionEvent gần nhất, nhưng cũng không được sớm hơn 2 tuần sau khi kết thúc năm mà nguồn cấp dữ liệu dành cho. Ví dụ: đối với nguồn cấp dữ liệu năm 2024, bạn nên đặt FeedInactiveDate thành 2025-01-14 trong trường hợp thông thường khi tất cả cuộc bầu cử đã kết thúc vào hoặc trước ngày 2024-12-31. Ngày này có thể được đặt muộn hơn nữa nếu cuộc bầu cử bị hoãn, nếu có vòng bầu cử thứ hai vào năm 2025 hoặc nếu các sự kiện bầu cử tiếp tục diễn ra vào năm 2025.
ElectionEventCollection 0 hoặc 1 ElectionEvent Chứa thông tin về các cuộc bầu cử được đề cập trong nguồn cấp dữ liệu này. Yêu cầu này chỉ được tuân thủ đối với các loại nguồn cấp dữ liệu PRE_ELECTION hoặc ELECTION_RESULTS.
OfficeholderSubFeed 0 hoặc 1 OfficeholderSubFeed Chứa thông tin về các quan chức được đề cập trong nguồn cấp dữ liệu này. Yêu cầu này chỉ được tuân thủ đối với loại nguồn cấp dữ liệu OFFICEHOLDER.