OfficeScope

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

Elementos

Nombre Etiqueta Tipo Notas Multiplicidad
Nombre de depuración DebugName string Es el nombre descriptivo que se usa para la oficina. 0 o 1
Nivel de la oficina OfficeLevel 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. 1
ID de OCD de la jurisdicción JurisdictionOcdId Ocd Id Es opcional si OfficeLevel es Country; de lo contrario, es obligatorio. Usa este campo para especificar la ubicación geográfica política. Por ejemplo, si el estado es Virginia en lugar de Pensilvania, o Manitoba en lugar de Ontario. 0 o 1
Roles de oficina OfficeRoles 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 de OCD de jurisdicción, etcétera. 1 o más
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id Es la lista de IDs de OCD de los distritos electorales que votan para el cargo de la oficina que se indica 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. 0 o 1

Ejemplos

El siguiente ejemplo es un Feed que contiene un ElectionEvent con OfficeScope. Indica que el objeto 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 escaños de la Cámara Baja y uno o más escaños 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 roles 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>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"
     ]
   }
 }
}