OfficeScope

Las entidades OfficeScope se usan para especificar a qué oficinas corresponden las entidades ElectionEvent y OfficeholderSubFeed.

Elementos

Elemento Multiplicidad Tipo Descripción
DebugName 0 o 1 string Es el nombre descriptivo que se usa para la oficina.
OfficeLevel 1 OfficeLevel Especifica el nivel de las oficinas dentro de este alcance: Country para nivel nacional, Administrative Area 1 para un estado o provincia, etcétera.
JurisdictionOcdId 0 o 1 string El ID de OCD de la jurisdicción de las oficinas.
OfficeRoles 1 o más OfficeRole Es una lista de los roles incluidos en el conjunto de datos, específicamente limitada a los que se eligen para este nivel de cargo, ID del OCD de la jurisdicción, etcétera.
ElectoralDistrictCollection 0 o 1 N/A Es el elemento wrapper de la lista de IDs de OCD de los distritos electorales que votan por los cargos de la oficina que se indican en la lista. Una lista vacía implica que el alcance incluye todos los distritos posibles para la ubicación de la elección o el funcionario especificados.

Ejemplos

El siguiente ejemplo es un Feed que contiene un ElectionEvent con OfficeScope. Indica que el Feed contiene (o se espera que contenga) datos sobre un conjunto de una o más elecciones para elegir al presidente a nivel nacional, uno o más bancas de la Cámara Baja y uno o más bancas de la Cámara Alta:

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

El mismo ElectionEvent puede contener entidades OfficeScope adicionales que indican varias elecciones a nivel estatal en Virginia y Pensilvania para diferentes cargos a nivel estatal:

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

El ElectionEvent puede contener, si es necesario, entidades OfficeScope que especifiquen los distritos electorales que votan para el cargo de funcionario electoral que se indica:

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>

JSON

{
 "OfficeScope": {
   "DebugName" : "US general election scope",
   "OfficeLevel": "Country",
   "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"
     ]
   }
 }
}