الخلاصة

يمثّل كيان 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 تمثّل هذه السمة اسم مورد Amazon (ARN) المؤهّل بالكامل لقائمة انتظار SQS الخاصة بالخلاصات التي تم تفعيل الإشعارات الفورية فيها (مثلاً، arn:aws:sqs:region:account-id:queue-name). لمزيد من التفاصيل، يُرجى الاطّلاع على دليل مطوّر 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 فقط.