OfficeScope

يتم استخدام عناصر OfficeScope لتحديد المكاتب التي تتوافق مع العنصرين ElectionEvent وOfficeholderSubFeed.

العناصر

العنصر التعددية النوع الوصف
DebugName 0 أو 1 string اسم وصفي مستخدَم للمكتب.
OfficeLevel 1 OfficeLevel تحدّد هذه السمة مستوى المكاتب ضمن هذا النطاق: Country للمستوى الوطني، وAdministrative Area 1 للمستوى الإقليمي أو مستوى الولاية، وما إلى ذلك.
JurisdictionOcdId 0 أو 1 string تمثّل هذه السمة معرّف OCD للمنطقة القضائية التي تقع فيها المكاتب.
OfficeRoles ‫1 أو أكثر OfficeRole قائمة بالأدوار المضمّنة في مجموعة البيانات، والتي تقتصر تحديدًا على الأدوار التي يتم اختيارها لهذا المستوى من المنصب، ومعرّف OCD الخاص بنطاق السلطة، وما إلى ذلك
ElectoralDistrictCollection 0 أو 1 لا ينطبق العنصر الحاوي لقائمة معرّفات OCD الخاصة بالدوائر الانتخابية التي تصوّت لأدوار المناصب المدرَجة. تشير القائمة الفارغة إلى أنّ النطاق يشمل جميع الدوائر الانتخابية الممكنة للموقع الجغرافي أو شاغل المنصب المحدّد.

أمثلة

المثال التالي هو Feed يحتوي على ElectionEvent مع OfficeScope. يشير ذلك إلى أنّ Feed يتضمّن (أو من المتوقّع أن يتضمّن) بيانات حول مجموعة من انتخابات واحدة أو أكثر لانتخاب الرئيس على المستوى الوطني، ومقعد واحد أو أكثر في مجلس النواب، ومقعد واحد أو أكثر في مجلس الشيوخ:

XML

<OfficeScope>
  <DebugName>Scope of US general election</DebugName>
  <OfficeLevel>Country</OfficeLevel>
  <JurisdictionOcdId>ocd-division/country:us</JurisdictionOcdId>
  <OfficeRoles>president</OfficeRoles>
  <OfficeRoles>lower house</OfficeRoles>
  <OfficeRoles>upper house</OfficeRoles>
</OfficeScope>

يمكن أن يحتوي ElectionEvent نفسه على عناصر OfficeScope إضافية تشير إلى عدة انتخابات على مستوى الولاية في فيرجينيا وبنسلفانيا لأدوار مختلفة على مستوى الولاية:

XML

<OfficeScope>
  <DebugName>Virginia election scope</DebugName>
  <OfficeLevel>Administrative Area 1</OfficeLevel>
  <JurisdictionOcdId>ocd-division/country:us/state:va</JurisdictionOcdId>
  <OfficeRoles>attorney general</OfficeRoles>
  <OfficeRoles>state executive</OfficeRoles>
</OfficeScope>
<OfficeScope>
  <DebugName>Pennsylvania election scope</DebugName>
  <OfficeLevel>Administrative Area 1</OfficeLevel>
  <JurisdictionOcdId>ocd-division/country:us/state:pa</JurisdictionOcdId>
  <OfficeRoles>state lower house</OfficeRoles>
  <OfficeRoles>state upper house</OfficeRoles>
  <OfficeRoles>state executive</OfficeRoles>
</OfficeScope>

يمكن أن يحتوي ElectionEvent، إذا لزم الأمر، على عناصر OfficeScope تحدّد الدوائر الانتخابية التي تصوّت لشغل الدور الوظيفي المُدرَج:

XML

<OfficeScope>
  <DebugName>US general election scope</DebugName>
  <OfficeLevel>Country</OfficeLevel>
  <JurisdictionOcdId>ocd-division/country:us</JurisdictionOcdId>
  <OfficeRoles>upper house</OfficeRoles>
  <ElectoralDistrictCollection>
    <OcdId>ocd-division/country:us/state:ar</OcdId>
    <OcdId>ocd-division/country:us/state:ca</OcdId>
    <OcdId>ocd-division/country:us/state:ct</OcdId>
    <OcdId>ocd-division/country:us/state:de</OcdId>
    <OcdId>ocd-division/country:us/state:fl</OcdId>
  </ElectoralDistrictCollection>
</OfficeScope>