OfficeScope

يتم استخدام كيانات OfficeScope لتحديد المكاتب ElectionEvent كيان OfficeholderSubFeed.

العناصر

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