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 Nombre descriptivo utilizado para la oficina. 0 o 1
Nivel de oficina OfficeLevel OfficeLevel Especifica el nivel de las oficinas dentro de este alcance: Country para el país, Administrative Area 1 para un estado o una provincia, etcétera. 1
ID de TOC de jurisdicción JurisdictionOcdId Ocd Id Opcional si OfficeLevel es Country; de lo contrario, es obligatorio. Usa este campo para especificar la geografía política. Por ejemplo, si el estado es Virginia frente a Pensilvania o Manitoba frente a Ontario. 0 o 1
Puestos de oficina OfficeRoles OfficeRole Una lista de los roles incluidos en el conjunto de datos, que se limitan de forma específica a los que se eligen para este nivel de cargo, el ID de OCD de jurisdicción, etcétera. 1 o más
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id La lista de ID de OCD de los distritos electorales que votan por el rol de cargo indicado. Una lista vacía implica que el alcance incluye todos los distritos posibles para la ubicación electoral o el funcionario público especificados. 0 o 1

Ejemplos

El siguiente ejemplo es un Feed que contiene un ElectionEvent con OfficeScope. Indica que Feed contiene (o se espera que contenga) datos sobre un conjunto de una o más elecciones para elegir al presidente de nivel nacional, uno o más cargos en la Cámara baja y uno o más cargos en 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 funciones 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"
 ]
 }
}

Si es necesario, ElectionEvent puede contener entidades OfficeScope que especifiquen los distritos electorales que votan para el rol de cargo indicado:

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