OfficeScope

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

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

العناصر

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

أمثلة

المثال التالي هو 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>National</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": "National",
   "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"
     ]
   }
 }
}