الخلاصة

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