الخلاصة

يمثّل عنصر Feed مجموعة واحدة نشطة أو قادمة من ملفات بيانات CDF بمرور الوقت تتوافق مع بلد معيّن ونوع خلاصة CDF. لمزيد من التفاصيل، اطّلِع على أنواع الخلاصات. يمكن أن يحتوي FeedDeliveryReport على عدة عناصر Feed لبلد معيّن ونوع خلاصة معيّن، طالما أنّ نطاقاتها لا تتداخل، سواء من خلال النطاق الجغرافي أو الإطار الزمني أو مستوى المكتب. في ما يلي أمثلة على المجموعات الصالحة:

  • يمكن أن يحتوي FeedDeliveryReport واحد على كل من Feed خاص بالمرشحين لمنصب عام في الولايات المتحدة وFeed خاص بالانتخابات الأمريكية قبل إجرائها (دائم).
  • يمكن أن يحتوي FeedDeliveryReport واحد على Feed خاص بالانتخابات الأمريكية التمهيدية (2022) وFeed خاص بالانتخابات الأمريكية التمهيدية (2024).
  • يمكن أن يحتوي FeedDeliveryReport واحد على Feed أمريكي قبل الانتخابات (على المستوى الفيدرالي فقط في 2022) وFeed أمريكي قبل الانتخابات (على مستوى الولاية فقط في 2022).
  • يمكن أن يتضمّن FeedDeliveryReport مسؤولاً منتخَبًا في الولايات المتحدة Feed ومرشحًا في اليابان قبل الانتخابات Feed (على المستوى الوطني فقط في عام 2022)، ولكن فقط إذا كان كلا البلدين ضمن النطاق.

تكون Feed إما محدودة المدة، لأنّه من المتوقّع أن تنتهي في تاريخ محدّد (مثل 60 يومًا بعد الانتخابات)، أو تكون "دائمة"، أي ليس لها تاريخ انتهاء متوقّع ويتم تجديدها باستمرار.

يجب الانتظار حتى مرور 60 يومًا على FeedInactiveDate لإزالة الخلاصة من خلاصة البيانات الوصفية.

العناصر

العنصر التعددية النوع الوصف
FeedId 1 string معرّف فريد وثابت لمدة توفّر الخلاصة لا يمكن إعادة استخدامها في خلاصات أخرى.
FeedName 1 string تمثّل هذه السمة وصفًا موجزًا للخلاصة، مثل "شاغلو المناصب في الولايات المتحدة لعام 2023".
FeedType 1 FeedType يشير إلى نوع خلاصة CDF هذه.
FeedLongevity 1 FeedLongevity تشير هذه السمة إلى مدة صلاحية الخلاصة.
SourceDirPath 0 أو 1 FeedSourcePathUri معرّف الموارد المنتظم (URI) لمسار المصدر المؤهّل بالكامل لملف XML الخاص بالخلاصة

تتوفّر حلول استضافة الملفات التالية:

  • s3
  • ftp وsftp
  • http وhttps

يجب أن يكون هذا الملف قابلاً للوصول إليه من خلال حل استضافة الملفات نفسه الذي تستخدمه لخلاصة البيانات الوصفية، ولكن يمكن أن يكون فارغًا قبل أن تصبح البيانات جاهزة.
CountryCode 0 أو 1 string تمثّل هذه السمة رمز البلد وفقًا لمعيار ISO 3166-1 alpha-2 الذي يغطّيه هذا الخلاص. هذه السمة مطلوبة إذا لم تكن قيمة FeedType هي election-dates أو voter-information.
FeedInactiveDate 0 أو 1 date تمثّل هذه السمة تاريخًا بتنسيق ISO-8601 يشير إلى الوقت الذي سيتوقف فيه تعديل الخلاصة ولن يعود من المفترض أن يتم استيعابها.
  • بالنسبة إلى خلاصات evergreen، من غير المرجّح أن يتم ضبط هذه القيمة على الإطلاق ما لم يتم إيقاف الخلاصة نهائيًا.
  • بالنسبة إلى خلاصات limited، يجب ضبط هذا الحقل على أسبوعين بعد تاريخ انتهاء آخر ElectionEvent في الخلاصة أو أسبوعين بعد الموعد المتوقّع لآخر تعديل بعد الانتخابات. يُرجى العِلم أنّه في حال إلغاء ElectionEvent بدون أي تحديثات متوقّعة، يمكن أن يسبق FeedInactiveDate EndDate الخاص بـ ElectionEvent.
  • بالنسبة إلى خلاصات yearly، كما هو الحال مع خلاصات limited، يجب ضبط هذا التاريخ على أسبوعَين على الأقل بعد تاريخ انتهاء آخر ElectionEvent، ولكن يجب أيضًا ألا يكون قبل أسبوعَين من نهاية العام الذي تخصّه الخلاصة. على سبيل المثال، بالنسبة إلى خلاصة 2024، يجب ضبط FeedInactiveDate على 2025-01-14 في الحالة الشائعة التي تكون فيها جميع الانتخابات قد انتهت في 2024-12-31 أو قبل هذا التاريخ. ويمكن تحديدها في وقت لاحق إذا تم تأجيل الانتخابات أو إذا أجريت جولة إعادة في عام 2025 أو إذا استمرت فعاليات الانتخابات إلى عام 2025.
ElectionEventCollection 0 أو 1 ElectionEvent يحتوي على معلومات حول الانتخابات التي يغطيها هذا الخلاصة. ويتم الالتزام بهذا الإعداد لأنواع الخلاصات PRE_ELECTION أو ELECTION_RESULTS فقط.
OfficeholderSubFeed 0 أو 1 OfficeholderSubFeed يحتوي على معلومات حول المسؤولين الذين تغطيهم هذه الخلاصة. يتمّ احترام هذه السمة لنوع الخلاصة OFFICEHOLDER فقط.