OfficeScope

Entity OfficeScope digunakan untuk menentukan kantor mana yang sesuai dengan entity ElectionEvent dan OfficeholderSubFeed.

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, atau wajib diisi. Gunakan kolom ini untuk menentukan wilayah geografis politik. Misalnya, jika negara bagiannya adalah Virginia versus Pennsylvania, atau Manitoba versus Ontario. 0 atau 1
Peran kantor OfficeRoles OfficeRole Daftar peran yang terdapat dalam set data, secara khusus terbatas pada peran yang dipilih untuk tingkat jabatan ini, ID OCD wilayah hukum, dll. 2 atau lebih
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id Daftar ID OCD dari distrik pemilu yang memberikan suara untuk posisi jabatan yang tercantum. Daftar kosong menyiratkan bahwa cakupannya mencakup semua kemungkinan distrik untuk lokasi pemilu atau pejabat tertentu yang ditentukan. 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 satu atau beberapa pemilu untuk memilih Presiden tingkat nasional, satu atau beberapa kursi Dewan Bawah, dan satu atau beberapa kursi Dewan Atas:

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

ElectionEvent dapat, jika diperlukan, berisi entitas OfficeScope yang menentukan pemilihan distrik pemilu untuk peran kantor terdaftar:

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