OfficeScope

موجودیت های OfficeScope برای تعیین دفاتر ElectionEvent و OfficeholderSubFeed مورد استفاده قرار می گیرند.

عناصر

نام برچسب بزنید تایپ کنید یادداشت ها کثرت
نام اشکال زدایی DebugName String نام توصیفی مورد استفاده برای دفتر. 0 یا 1
سطح اداری OfficeLevel OfficeLevel سطح دفاتر را در این محدوده مشخص می کند: Country برای ملی، Administrative Area 1 برای یک ایالت یا استان و غیره. 1
شناسه OCD حوزه قضایی JurisdictionOcdId Ocd Id اگر OfficeLevel Country باشد اختیاری است، در غیر این صورت لازم است. از این فیلد برای تعیین جغرافیای سیاسی استفاده کنید. برای مثال، اگر ایالت ویرجینیا در مقابل پنسیلوانیا یا مانیتوبا در مقابل انتاریو باشد. 0 یا 1
نقش های اداری OfficeRoles OfficeRole فهرستی از نقش‌های موجود در مجموعه داده‌ها، به‌ویژه محدود به افرادی که برای این سطح اداری انتخاب می‌شوند، شناسه OCD حوزه قضایی و غیره. 1 یا بیشتر
مجموعه حوزه انتخاباتی 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"
     ]
   }
 }
}