OfficeScope

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

Elemen

Nama Tag Jenis Catatan Keanekaragaman
Nama debug DebugName String Nama deskriptif yang digunakan untuk kantor. 0 atau 1
Tingkat kantor OfficeLevel OfficeLevel Menentukan tingkat kantor dalam cakupan ini: Country untuk nasional, Administrative Area 1 untuk negara bagian atau provinsi, dll. 1
ID OCD Wilayah Hukum JurisdictionOcdId Ocd Id Opsional jika OfficeLevel adalah Country, jika tidak diperlukan. Gunakan kolom ini untuk menentukan geografi politik. Misalnya, jika negara bagian adalah Virginia versus Pennsylvania, atau Manitoba versus Ontario. 0 atau 1
Peran kantor OfficeRoles OfficeRole Daftar peran yang terdapat dalam set data, yang secara khusus dibatasi pada mereka yang dipilih untuk tingkat jabatan ini, ID OCD wilayah hukum, dll. 1 atau lebih
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id Daftar ID OCD dari daerah pemilihan suara untuk daftar yang tercantum di kantor. Daftar kosong menyiratkan bahwa ruang lingkup mencakup semua kemungkinan distrik untuk lokasi atau pemegang jabatan tertentu. 0 atau 1

Contoh

Contoh berikut adalah Feed yang berisi ElectionEvent dengan OfficeScope. Hal ini menunjukkan bahwa Feed berisi (atau diharapkan berisi) data tentang serangkaian dari satu atau lebih pemilu untuk memilih Presiden tingkat nasional, satu atau beberapa kursi Majelis Rendah, dan satu atau beberapa kursi Majelis 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 peran tingkat negara bagian yang berbeda:

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

Jika diperlukan, ElectionEvent dapat berisi entitas OfficeScope yang menentukan distrik pemilu yang memberikan suara untuk jabatan jabatan yang tercantum:

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