OfficeScope

As entidades OfficeScope são usadas para especificar a quais escritórios uma entidade ElectionEvent e OfficeholderSubFeed correspondem.

Elementos

Nome Tag Tipo Observações Multiplicidade
Nome de depuração DebugName string Nome descritivo usado para o escritório. 0 ou 1
Nível do escritório OfficeLevel OfficeLevel Especifica o nível dos escritórios dentro desse escopo: Country para nacional, Administrative Area 1 para um estado ou província etc. 1
ID da OCD da jurisdição JurisdictionOcdId Ocd Id Opcional se OfficeLevel for Country, caso contrário, é obrigatório. Use esse campo para especificar a região geográfica política. Por exemplo, se o estado for Virgínia em vez de Pensilvânia, ou Manitoba em vez de Ontário. 0 ou 1
Funções do Office OfficeRoles OfficeRole Uma lista dos papéis contidos no conjunto de dados, limitada especificamente àqueles que estão sendo eleitos para este nível de cargo, ID do OCD da jurisdição etc. 1 ou mais
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id A lista de IDs do TOC dos distritos eleitorais que votam para o cargo listado. Uma lista vazia implica que o escopo inclui todos os distritos possíveis para o local ou ocupante do cargo especificado. 0 ou 1

Exemplos

O exemplo a seguir é um Feed que contém um ElectionEvent com OfficeScope. Isso 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 baixa e um ou mais assentos da 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"
   ]
 }
}

O mesmo ElectionEvent pode conter outras entidades OfficeScope que indicam várias eleições estaduais na Virgínia e na Pensilvânia para diferentes funções 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>

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

Se necessário, o ElectionEvent pode conter entidades OfficeScope que especificam os distritos eleitorais que votam para o cargo listado:

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