OfficeScope

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

عناصر

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