خوراک

یک موجودیت Feed یک جریان واحد فعال یا آتی از فایل های داده CDF را در طول زمان نشان می دهد که با یک کشور خاص و نوع فید CDF مطابقت دارد. برای جزئیات بیشتر، به انواع فید مراجعه کنید. یک FeedDeliveryReport می‌تواند حاوی چندین نهاد Feed برای یک کشور و نوع فید باشد، تا زمانی که دامنه آنها بر اساس محدوده جغرافیایی، بازه زمانی یا سطح اداری همپوشانی نداشته باشد. در زیر نمونه هایی از ترکیبات معتبر آورده شده است:

  • یک FeedDeliveryReport می‌تواند هم یک Feed صاحبان دفتر ایالات متحده و هم یک Feed قبل از انتخابات ایالات متحده (همیشه سبز) داشته باشد.
  • یک FeedDeliveryReport می‌تواند حاوی یک Feed قبل از انتخابات ایالات متحده (2022) و یک Feed قبل از انتخابات ایالات متحده (2024) باشد.
  • یک FeedDeliveryReport می‌تواند حاوی یک Feed قبل از انتخابات ایالات متحده (فقط در سطح فدرال ۲۰۲۲) و یک Feed قبل از انتخابات ایالات متحده (فقط در سطح ایالت ۲۰۲۲) باشد.
  • یک FeedDeliveryReport می‌تواند حاوی یک Feed صاحب منصب ایالات متحده و یک Feed قبل از انتخابات JP باشد (فقط در سطح ملی 2022)، اما فقط در صورتی که هر دو کشور در محدوده باشند.

یک Feed یا مدت زمان محدودی دارد، زیرا تاریخ پایان مورد انتظاری وجود دارد (مانند 60 روز پس از انتخابات)، یا "همیشه سبز" است، به این معنی که تاریخ پایان مورد انتظاری وجود ندارد و به طور مداوم به روز می شود.

قبل از حذف آن از فید فراداده، تا 60 روز پس از FeedInactiveDate صبر کنید.

عناصر

نام برچسب بزنید تایپ کنید یادداشت ها کثرت
شناسه فید FeedId String یک شناسه منحصر به فرد و پایدار برای طول عمر خوراک. غیر قابل استفاده مجدد در فیدها 1
نام فید FeedName String توضیح کوتاهی برای فید، مانند "US Officeholders 2023". 1
نوع خوراک FeedType FeedType نشان می دهد که این کدام نوع خوراک CDF است. 1
طول عمر تغذیه FeedLongevity FeedLongevity طول عمر خوراک را نشان می دهد. 1
محل تغذیه SourceDirPath String URI کاملا واجد شرایط فایل xml فید (فقط ftp و http پشتیبانی می شوند). باید از طریق همان راه حل میزبانی فایل مانند فید ابرداده قابل دسترسی باشد (اما قبل از آماده شدن داده ها می تواند خالی باشد). 0 یا 1
کد کشور CountryCode String کد کشور ISO 3166-1 alpha-2 که این فید پوشش می دهد. اگر FeedType election-dates یا voter-information نباشد، ضروری است. 0 یا 1
تاریخ غیرفعال خوراک FeedInactiveDate xs:date یک تاریخ در قالب ISO-8601 که نشان می‌دهد چه زمانی فید دیگر به‌روزرسانی نمی‌شود و دیگر نباید مصرف شود.
  • برای فیدهای evergreen ، این به احتمال زیاد نباید به هیچ وجه تنظیم شود، مگر اینکه خوراک در حال منسوخ شدن باشد.
  • برای فیدهای limited ، این باید روی دو هفته پس از تاریخ پایان آخرین ElectionEvent در فید یا دو هفته پس از آخرین به‌روزرسانی پس از انتخابات تنظیم شود. توجه داشته باشید که اگر یک ElectionEvent بدون به‌روزرسانی مورد انتظار لغو شود، FeedInactiveDate می‌تواند قبل از EndDate برای ElectionEvent باشد.
  • برای فیدهای yearly ، مانند فیدهای limited ، این باید حداقل دو هفته پس از تاریخ پایان آخرین ElectionEvent تنظیم شود، اما نباید زودتر از دو هفته پس از پایان سالی که فید برای آن در نظر گرفته شده باشد. به عنوان مثال، برای فید 2024، FeedInactiveDate باید روی 2025-01-14 تنظیم شود، در حالت معمولی که در آن همه انتخابات در یا قبل از 2024-12-31 پایان یافته است. اگر انتخابات به تعویق بیفتد، اگر دور دوم در سال 2025 اتفاق بیفتد، یا اگر رویدادهای انتخاباتی در غیر این صورت تا سال 2025 ادامه یابد، ممکن است حتی دیرتر تعیین شود.
 0 یا 1
مجموعه رویدادهای انتخاباتی ElectionEventCollection ElectionEvent حاوی اطلاعاتی درباره انتخابات تحت پوشش این فید است. این فقط برای انواع فید PRE_ELECTION یا ELECTION_RESULTS رعایت می شود. 0 یا 1
فید فرعی Officeholder OfficeholderSubFeed OfficeholderSubFeed حاوی اطلاعاتی در مورد صاحبان دفتر تحت پوشش این فید است. این فقط برای نوع خوراک OFFICEHOLDER قابل احترام است. 0 یا 1