OfficeScope

موجودیت‌های OfficeScope برای مشخص کردن اینکه موجودیت‌های ElectionEvent و OfficeholderSubFeed مربوط به کدام دفاتر هستند، استفاده می‌شوند.

عناصر

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

جی‌سون 

{
 "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>

جی‌سون 

{
 "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>

جی‌سون 

{
 "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"
     ]
   }
 }
}