OfficeScope

Encje OfficeScope służą do określania, których urzędów dotyczą encje ElectionEvent i OfficeholderSubFeed.

Elementy

Element Mnogość Typ Opis
DebugName 0 lub 1 string Nazwa opisowa używana w przypadku urzędu.
OfficeLevel 1 OfficeLevel Określa poziom urzędów w tym zakresie: Country – krajowy, Administrative Area 1 – stan lub prowincja itp.
JurisdictionOcdId 0 lub 1 string Identyfikator OCD jurysdykcji urzędów.
OfficeRoles 1 lub więcej OfficeRole Lista ról zawartych w zbiorze danych, ograniczona do tych, które są wybierane na tym poziomie urzędu, identyfikatorze OCD jurysdykcji, itp.
ElectoralDistrictCollection 0 lub 1 Nie dotyczy Element opakowujący listę identyfikatorów OCD okręgów wyborczych głosujących na wymienione role urzędów. Pusta lista oznacza, że zakres obejmuje wszystkie możliwe okręgi dla określonego miejsca wyborów lub urzędnika.

Przykłady

Poniższy przykład to Feed, który zawiera ElectionEvent z OfficeScope. Wskazuje, że Feed zawiera (lub ma zawierać) dane o zbiorze co najmniej 1 wyborów na prezydenta na poziomie krajowym, co najmniej 1 mandatu w Izbie Niższej i co najmniej 1 mandatu w Izbie Wyższej:

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>

Ten sam ElectionEvent może zawierać dodatkowe encje OfficeScope, które wskazują kilka wyborów na poziomie stanowym w Wirginii i Pensylwanii na różne role na poziomie 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>

W razie potrzeby ElectionEvent może zawierać encje OfficeScope, które określają okręgi wyborcze głosujące na wymienioną rolę urzędu:

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>