خوراک

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

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

یک Feed یا مدت زمان محدودی دارد، زیرا یک تاریخ پایان مورد انتظار وجود دارد (مانند ۶۰ روز پس از انتخابات)، یا "همیشه سبز" است، به این معنی که هیچ تاریخ پایان مورد انتظاری وجود ندارد و دائماً به‌روزرسانی می‌شود.

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

عناصر

عنصر چندگانگی نوع توضیحات
FeedId ۱ string یک شناسه منحصر به فرد و پایدار برای طول عمر فید. غیرقابل استفاده مجدد در فیدهای مختلف.
FeedName ۱ string توضیح کوتاهی برای فید، مانند «دارندگان دفتر ایالات متحده ۲۰۲۳».
FeedType ۱ FeedType نشان می‌دهد که این از کدام نوع خوراک CDF است.
FeedLongevity ۱ FeedLongevity طول عمر خوراک را نشان می‌دهد.
SourceDirPath ۰ یا ۱ FeedSourcePathUri آدرس اینترنتی (URI) مسیر منبع کاملاً واجد شرایط فایل XML فید.

راهکارهای میزبانی فایل زیر پشتیبانی می‌شوند:

  • s3
  • ftp و sftp
  • http و https

این باید از طریق همان راهکار میزبانی فایل که فید فراداده را ارائه می‌دهد، قابل دسترسی باشد، اما می‌تواند قبل از آماده شدن داده‌ها خالی باشد.

CountryCode ۰ یا ۱ string کد کشوری که این فید پوشش می‌دهد (ISO 3166-1 alpha-2). در صورتی که FeedType برابر election-dates یا voter-information نباشد، الزامی است.
FeedInactiveDate ۰ یا ۱ date تاریخی با فرمت ISO-8601 که نشان می‌دهد چه زمانی فید دیگر به‌روزرسانی نخواهد شد و دیگر نباید مصرف شود.
  • برای فیدهای evergreen ، به احتمال زیاد این مورد اصلاً نباید تنظیم شود، مگر اینکه فید منسوخ شده باشد.
  • برای فیدهای limited ، این باید روی دو هفته پس از تاریخ پایان آخرین ElectionEvent در فید یا دو هفته پس از آخرین به‌روزرسانی مورد انتظار پس از انتخابات تنظیم شود. توجه داشته باشید که اگر ElectionEvent بدون هیچ به‌روزرسانی مورد انتظاری لغو شود، FeedInactiveDate می‌تواند قبل از EndDate برای ElectionEvent قرار گیرد.
  • برای فیدهای yearly ، مانند فیدهای limited ، این باید حداقل دو هفته پس از تاریخ پایان آخرین ElectionEvent تنظیم شود، اما همچنین نباید زودتر از دو هفته پس از پایان سالی که فید برای آن است، باشد. به عنوان مثال، برای یک فید 2024، FeedInactiveDate باید در حالت معمول که همه انتخابات در تاریخ 2024-12-31 یا قبل از آن پایان یافته‌اند، روی 2025-01-14 تنظیم شود. اگر انتخابات به تعویق بیفتد، اگر دور دوم در سال 2025 رخ دهد، یا اگر رویدادهای انتخاباتی به هر نحوی تا سال 2025 ادامه یابد، می‌توان آن را حتی دیرتر تنظیم کرد.
ElectionEventCollection ۰ یا ۱ ElectionEvent حاوی اطلاعاتی درباره انتخابات تحت پوشش این فید است. این اطلاعات فقط برای انواع فید PRE_ELECTION یا ELECTION_RESULTS معتبر است.
OfficeholderSubFeed ۰ یا ۱ OfficeholderSubFeed شامل اطلاعاتی دربارهٔ صاحب‌منصبان تحت پوشش این فید است. این اطلاعات فقط برای نوع فید OFFICEHOLDER معتبر است.