OfficeScope

ملاحظة: يتم استخدام هذا الكيان فقط في خلاصات البيانات الوصفية. ولا تُستخدم هذه المعلومات مع خلاصات الانتخابات التمهيدية أو الانتخابات أو مسؤوليات المناصب.

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

العناصر

الاسم	العلامة	النوع	Notes	التعددية
اسم تصحيح الأخطاء	DebugName	String	تمثّل هذه السمة الاسم الوصفي المستخدَم للمكتب.	0 أو 1
مستوى المكتب	OfficeLevel	OfficeLevel	يتم تحديد مستوى المكاتب ضمن هذا النطاق: Country للمستوى الوطني، وAdministrative Area 1 للولاية أو المقاطعة، وما إلى ذلك.	1
رقم تعريف OCD في نطاق السلطة	JurisdictionOcdId	Ocd Id	وتكون اختيارية إذا كانت السمة OfficeLevel هي Country، أو تكون مطلوبة في الحالات الأخرى. استخدِم هذا الحقل لتحديد الجغرافيا السياسية. على سبيل المثال، إذا كانت الولاية هي فيرجينيا مقابل بنسلفانيا أو مانيتوبا مقابل أونتاريو.	0 أو 1
الأدوار المكتبية	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"
     ]
   }
 }
}