Nguồn cấp dữ liệu

Một 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 của giai đoạn 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 quan chức Hoa Kỳ Feed và một 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 xuyên", 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

Tên Thẻ Loại Ghi chú Số bội
ID nguồn cấp dữ liệu FeedId 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. 1
Tên nguồn cấp dữ liệu FeedName 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". 1
Loại nguồn cấp dữ liệu FeedType FeedType Cho biết loại nguồn cấp dữ liệu CDF này. 1
Độ bền lâu của nguồn cấp dữ liệu FeedLongevity FeedLongevity Cho biết thời gian tồn tại của nguồn cấp dữ liệu. 1
Vị trí của nguồn cấp dữ liệu SourceDirPath String URI đủ điều kiện của tệp xml trong nguồn cấp dữ liệu (chỉ hỗ trợ ftphttp). Phải truy cập được 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). 0 hoặc 1
Mã quốc gia CountryCode String Mã quốc gia gồm 2 chữ cái theo tiêu chuẩn ISO 3166-1 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. 0 hoặc 1
Ngày nguồn cấp dữ liệu không hoạt động FeedInactiveDate xs:date Ngày giờ ở đị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 còn được nhập.
  • Đố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 đây 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 phổ biến khi tất cả cá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ử bổ sung 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.
0 hoặc 1
Bộ sưu tập sự kiện bầu cử ElectionEventCollection 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. 0 hoặc 1
Nguồn cấp dữ liệu phụ của quan chức OfficeholderSubFeed 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. 0 hoặc 1