الخلاصة

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

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

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

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

العناصر

الاسم العلامة النوع ملاحظات التعددية
الرقم التعريفي للخلاصة FeedId String معرّف فريد وثابت لمدة توفّر الخلاصة لا يمكن إعادة استخدامها في خلاصات أخرى. 1
اسم الخلاصة FeedName String وصف موجز للخلاصة، مثل "المناصب الحكومية في الولايات المتحدة لعام 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
الخلاصة الفرعية للمسؤول OfficeholderSubFeed OfficeholderSubFeed يحتوي على معلومات حول المسؤولين الذين تغطيهم هذه الخلاصة. يتم الالتزام بهذا الإعداد لنوع الخلاصة OFFICEHOLDER فقط. ‫0 أو 1