OfficeScope

As entidades OfficeScope são usadas para especificar a quais cargos uma entidade ElectionEvent e OfficeholderSubFeed corresponde.

Elementos

Elemento Multiplicidade Tipo Descrição
DebugName 0 ou 1 string Nome descritivo usado para o cargo.
OfficeLevel 1 OfficeLevel Especifica o nível dos cargos nesse escopo: Country para nacional, Administrative Area 1 para um estado ou província etc.
JurisdictionOcdId 0 ou 1 string O ID de OCD da jurisdição dos cargos.
OfficeRoles 1 ou mais OfficeRole Uma lista dos papéis contidos no conjunto de dados, especificamente limitada aos que estão sendo eleitos para esse nível de cargo, ID de OCD de jurisdição, etc.
ElectoralDistrictCollection 0 ou 1 N/A Elemento wrapper para a lista de IDs de OCD dos distritos eleitorais que votam nos papéis de cargo listados. Uma lista vazia implica que o escopo inclui todos os distritos possíveis para o local de eleição ou titular de cargo especificado.

Exemplos

O exemplo a seguir é um Feed que contém um ElectionEvent com OfficeScope. Ele indica que o Feed contém (ou deve conter) dados sobre um conjunto de uma ou mais eleições para eleger o presidente nacional, um ou mais assentos da Câmara dos Deputados e um ou mais assentos do Senado:

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>

O mesmo ElectionEvent pode conter outras entidades OfficeScope que indicam várias eleições estaduais na Virgínia e na Pensilvânia para diferentes papéis estaduais:

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>

O ElectionEvent pode, se necessário, conter entidades OfficeScope que especificam os distritos eleitorais que votam no papel de cargo listado:

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>