الخلاصة

يمثّل عنصر 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

يجب أن يكون هذا الملف متاحًا من خلال خدمة استضافة الملفات نفسها التي تستضيف خلاصة البيانات الوصفية، ولكن يمكن أن يكون فارغًا قبل أن تصبح البيانات جاهزة.
SqsQueueName 0 أو 1 string اسم قائمة انتظار SQS للخلاصات التي تم تفعيل الإشعارات الفورية فيها لمزيد من التفاصيل، يُرجى الاطّلاع على دليل المطوّرين في SQS. في حال عدم ضبط هذا الإعداد، سيتم استرداد تحديثات الخلاصة بدلاً من ذلك.
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.
IsTest 0 أو 1 boolean تُستخدَم لتحديد ما إذا كانت الخلاصة تجريبية خاصة بمحاكاة. يتم ضبط القيمة تلقائيًا على false في حال عدم تحديد أي قيمة.
ElectionEventCollection 0 أو 1 ElectionEvent يحتوي على معلومات حول الانتخابات التي يغطيها هذا الخلاصة. ويتم الالتزام بهذا الإعداد لأنواع الخلاصات PRE_ELECTION أو ELECTION_RESULTS فقط.
OfficeholderSubFeed 0 أو 1 OfficeholderSubFeed يحتوي على معلومات حول المسؤولين الذين تغطيهم هذه الخلاصة. يتم الالتزام بهذا الإعداد لنوع الخلاصة OFFICEHOLDER فقط.