OfficeScope

Le entità OfficeScope vengono utilizzate per specificare a quali uffici corrispondono un'entità ElectionEvent e OfficeholderSubFeed.

Elementi

Elemento Molteplicità Tipo Descrizione
DebugName 0 o 1 string Nome descrittivo utilizzato per l'ufficio.
OfficeLevel 1 OfficeLevel Specifica il livello degli uffici all'interno di questo ambito: Country per il livello nazionale, Administrative Area 1 per uno stato o una provincia e così via.
JurisdictionOcdId 0 o 1 string L' ID OCD della giurisdizione degli uffici.
OfficeRoles 1 o più OfficeRole Un elenco dei ruoli contenuti nel set di dati, limitato in modo specifico a quelli per cui si vota per questo livello di ufficio, ID OCD della giurisdizione e così via.
ElectoralDistrictCollection 0 o 1 N/D Elemento wrapper per l'elenco degli ID OCD dei distretti elettorali che votano per i ruoli di ufficio elencati. Un elenco vuoto implica che l'ambito include tutti i distretti possibili per la sede elettorale o il titolare di carica specificati.

Esempi

L'esempio seguente è un Feed che contiene un ElectionEvent con OfficeScope. Indica che il Feed contiene (o si prevede che contenga) dati su un insieme di una o più elezioni per eleggere il presidente a livello nazionale, uno o più seggi della Camera bassa e uno o più seggi della 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>

Lo stesso ElectionEvent può contenere entità OfficeScope aggiuntive che indicano diverse elezioni a livello statale in Virginia e Pennsylvania per diversi ruoli a livello statale:

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>

Se necessario, ElectionEvent può contenere entità OfficeScope che specificano i distretti elettorali che votano per il ruolo di ufficio elencato:

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>