OfficeScope

ملاحظة: لا يتم استخدام هذا العنصر إلا في خلاصات البيانات الوصفية. ولا يتم استخدامه مع خلاصات ما قبل الانتخابات أو الانتخابات أو شاغلي المناصب.

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

العناصر

العنصر	التعددية	النوع	الوصف
DebugName	0 أو 1	string	اسم وصفي مستخدَم للمكتب.
OfficeLevel	1	OfficeLevel	تحدّد هذه السمة مستوى المكاتب ضمن هذا النطاق: Country للمكاتب الوطنية، وAdministrative Area 1 للمكاتب على مستوى الولاية أو المقاطعة، وما إلى ذلك.
JurisdictionOcdId	0 أو 1	string	تمثّل هذه السمة معرّف OCD للمنطقة الجغرافية التي تقع فيها المكاتب. ملاحظة: هذا الحقل اختياري إذا كانت قيمة OfficeLevel هي Country، وإلا يكون مطلوبًا، مثلاً إذا كانت المكاتب تخضع لولاية قضائية في إحدى الولايات.
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>

JSON

{
 "OfficeScope": {
   "DebugName": "Scope of US general election",
   "OfficeLevel": "Country",
   "JurisdictionOcdId": "ocd-division/country:us",
   "OfficeRoles": [
     "president",
     "lower house",
     "upper house"
   ]
 }
}
    

يمكن أن يحتوي 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>

JSON

{
 "OfficeScope": {
 "DebugName": "Virginia election scope",
 "OfficeLevel": "Administrative Area 1",
 "JurisdictionOcdId": "ocd-division/country:us/state:va",
 "OfficeRoles": [
   "attorney general",
   "state executive"
 ]
 }
}
{
 "OfficeScope": {
 "DebugName": "Pennsylvania election scope",
 "OfficeLevel": "Administrative Area 1",
 "JurisdictionOcdId": "ocd-division/country:us/state:pa",
 "OfficeRoles": [
   "state lower house",
   "state upper house",
   "state executive"
 ]
 }
}
    

يمكن أن يحتوي 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>

JSON

{
 "OfficeScope": {
   "DebugName" : "US general election scope",
   "OfficeLevel": "Country",
   "JurisdictionOcdId": "ocd-division/country:us",
   "OfficeRoles": "upper house",
   "ElectoralDistrictCollection": {
     "OcdId" : [
     "ocd-division/country:us/state:ar",
     "ocd-division/country:us/state:ca",
     "ocd-division/country:us/state:ct",
     "ocd-division/country:us/state:de",
     "ocd-division/country:us/state:fl"
     ]
   }
 }
}