OfficeScope

Elementy OfficeScope służą do określania, którym biuram odpowiada element ElectionEvent i OfficeholderSubFeed.

Elementy

Nazwa Oznacz Typ Uwagi Mnogość
Nazwa debugowania DebugName String Opisowa nazwa biura. 0 lub 1
Poziom biurowy OfficeLevel OfficeLevel Określa poziom urzędów wchodzących w skład tego zakresu: Country – krajowy, Administrative Area 1 – stan lub prowincja itp. 1
Identyfikator OCD jurysdykcji JurisdictionOcdId Ocd Id Opcjonalne, jeśli OfficeLevel ma wartość Country. W przeciwnym razie jest wymagane. Użyj tego pola, aby określić geografia polityczną. Na przykład w przypadku stanów Wirginia vs. Pensylwania lub Manitoba kontra Ontario. 0 lub 1
Role pakietu Office OfficeRoles OfficeRole Lista ról zawartych w zbiorze danych, w szczególności ograniczona do osób wybranych na ten poziom biurowy, identyfikator OCD w jurysdykcji itp. 1 lub więcej
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id lista identyfikatorów OCD w okręgach wyborczych głosujących na dane stanowisko. Pusta lista oznacza, że zakres obejmuje wszystkie możliwe okręgi wyborcze w przypadku określonej lokalizacji wyborczej lub osoby sprawującej dany urząd. 0 lub 1

Przykłady

Ten przykład to obiekt Feed zawierający element ElectionEvent z atrybutem OfficeScope. Wskazuje on, że dokument Feed zawiera (lub powinien zawierać) dane dotyczące co najmniej 1 wyboru prezydenckiego, co najmniej jednego mandatu na szczeblu krajowym oraz co najmniej jednego miejsca w Dolnej Izbie Wyborczej:

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

Ten sam atrybut ElectionEvent może zawierać dodatkowe jednostki OfficeScope wskazujące kilka wyborów stanowych w Wirginii i Pensylwanii dla różnych ról na szczeblu stanowym:

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

Pole ElectionEvent może w razie potrzeby zawierać elementy (OfficeScope), które określają okręgi wyborcze na dane stanowisko:

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