OfficeScope

Entitas OfficeScope digunakan untuk menentukan kantor mana yang sesuai dengan entitas 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 yurisdiksi JurisdictionOcdId Ocd Id Opsional jika OfficeLevel adalah Country, jika tidak, wajib diisi. Gunakan kolom ini untuk menentukan geografi politik. Misalnya, jika negara bagiannya adalah Virginia versus Pennsylvania, atau Manitoba versus Ontario. 0 atau 1
Peran Office OfficeRoles OfficeRole Daftar peran yang ada dalam set data, yang secara khusus dibatasi untuk peran yang dipilih untuk tingkat jabatan ini, ID OCD yurisdiksi, dll. 1 atau lebih
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id Daftar ID OCD distrik pemilihan yang memilih untuk peran jabatan yang tercantum. Daftar kosong menunjukkan bahwa cakupan mencakup semua kemungkinan distrik untuk lokasi pemilu atau pemegang jabatan 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 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 pemilihan 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>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"
     ]
   }
 }
}