OfficeScope

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

Elementos

Elemento Multiplicidad Tipo Descripción
DebugName 0 o 1 string Es un nombre descriptivo que se usa para el cargo.
OfficeLevel 1 OfficeLevel Especifica el nivel de los cargos dentro de este alcance: Country para el 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 los cargos.
OfficeRoles 1 o más OfficeRole Es una lista de los roles que contiene el conjunto de datos, específicamente limitada a los que se eligen para este nivel de cargo, ID de OCD de la jurisdicción, etcétera.
ElectoralDistrictCollection 0 o 1 N/A Es un elemento contenedor para la lista de IDs de OCD de los distritos electorales que votan por los roles de cargos enumerados. Una lista vacía implica que el alcance incluye todos los distritos posibles para la ubicación de la elección o el titular del cargo especificados.

Ejemplos

En el siguiente ejemplo, se muestra 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 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>

El mismo ElectionEvent puede contener entidades OfficeScope adicionales que indiquen 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>

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

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>