OfficeScope

Le entità OfficeScope vengono utilizzate per specificare gli uffici di un ElectionEvent e Corrispondenza dell'entità OfficeholderSubFeed.

Elementi

Nome Tag Tipo Note Molteplicità
Nome debug DebugName String Nome descrittivo utilizzato per l'ufficio. 0 o 1
A livello di ufficio OfficeLevel OfficeLevel Specifica il livello degli uffici che rientrano in questo ambito: Country per la nazionale, Administrative Area 1 per uno stato o una provincia ecc. 1
ID OCD giurisdizione JurisdictionOcdId Ocd Id Facoltativo se OfficeLevel è Country, altrimenti richiesti. Utilizza questo campo per specificare l'area geografica politica. Ad esempio, se lo stato è Virginia e Pennsylvania o Manitoba contro l'Ontario. 0 o 1
Ruoli di ufficio OfficeRoles OfficeRole Un elenco dei ruoli contenuti in un set di dati, specificamente limitato a gli eletti per questo livello di carica, l'ID OCD di giurisdizione, ecc. 1 o più
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id Elenco del documento di identità dell'OCD dei distretti elettorali che votano per d'ufficio. Un elenco vuoto implica che l'ambito include tutte le distretti per la sede elettorale o il funzionario specificato. 0 o 1

Esempi

L'esempio seguente è un Feed che contiene un elemento ElectionEvent con OfficeScope. Indica che Feed contiene (o dovrebbe contenere) dati su una serie di una o più elezioni per eleggere il presidente a livello nazionale, uno o più seggi alla Camera bassa e uno o più seggi alla Camera 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"
   ]
 }
}

Lo stesso ElectionEvent può contenere altre entità OfficeScope che indicare diverse elezioni a livello statale in Virginia e Pennsylvania per ruoli a livello di stato diversi:

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 necessario, ElectionEvent può contenere entità OfficeScope che specificano i distretti elettorali che votano per il ruolo di carica in lista:

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