OfficeScope

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

Elementos

Nome Tag Tipo Observações Multiplicidade
Nome da 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 neste escopo: Country para nacional, Administrative Area 1 para um estado ou província etc. 1
ID de TOC da jurisdição JurisdictionOcdId Ocd Id Opcional se OfficeLevel for Country. Caso contrário, será obrigatório. Use esse campo para especificar a região política. Por exemplo, se o estado for Virgínia em comparação com Pensilvânia ou Manitoba em Ontário. 0 ou 1
Funções do escritório OfficeRoles OfficeRole Uma lista dos papéis contidos no conjunto de dados, especificamente limitados aos eleitos para o nível do escritório, ID de OCD da jurisdição etc. 1 ou mais
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id A lista de IDs do OCD 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 eleitoral ou o funcionário público especificado. 0 ou 1

Exemplos

O exemplo a seguir é um Feed que contém um ElectionEvent com OfficeScope. Isso indica que a Feed contém (ou pode conter) dados sobre um conjunto de uma ou mais eleições para eleger o presidente em nível nacional, uma ou mais cadeiras da Câmara baixa e uma ou mais cadeiras da Câmara Superior:

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 em nível de estado na Virgínia e na Pensilvânia para diferentes papéis no nível do estado:

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