OfficeScope

Entitas OfficeScope digunakan untuk menentukan kantor mana yang sesuai dengan entitas ElectionEvent dan OfficeholderSubFeed.

Elemen

Elemen Keanekaragaman Jenis Deskripsi
DebugName 0 atau 1 string Nama deskriptif yang digunakan untuk kantor.
OfficeLevel 1 OfficeLevel Menentukan tingkat kantor dalam cakupan ini: Country untuk nasional, Administrative Area 1 untuk negara bagian atau provinsi, dll.
JurisdictionOcdId 0 atau 1 string ID OCD ID yurisdiksi kantor.
OfficeRoles 1 atau lebih OfficeRole Daftar peran yang ada dalam set data, khususnya terbatas pada peran yang dipilih untuk tingkat jabatan ini, ID OCD yurisdiksi, dll.
ElectoralDistrictCollection 0 atau 1 T/A Elemen wrapper untuk daftar ID OCD distrik pemilihan yang memilih peran jabatan yang tercantum. Daftar kosong menyiratkan bahwa cakupan mencakup semua kemungkinan distrik untuk lokasi pemilu atau pemegang jabatan yang ditentukan.

Contoh

Contoh berikut adalah Feed yang berisi ElectionEvent dengan OfficeScope. Hal ini menunjukkan bahwa Feed berisi (atau diharapkan berisi) data tentang serangkaian satu atau beberapa pemilu untuk memilih Presiden tingkat nasional, satu atau beberapa kursi Dewan Rendah, dan satu atau beberapa kursi Dewan Tinggi:

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 yang sama dapat berisi entitas OfficeScope tambahan yang menunjukkan beberapa pemilu tingkat negara bagian di Virginia dan Pennsylvania untuk berbagai peran tingkat negara bagian:

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 dapat, jika diperlukan, berisi entitas OfficeScope yang menentukan distrik pemilihan yang memberikan suara untuk peran jabatan yang tercantum:

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>

JSON

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