Le entità OfficeScope
vengono utilizzate per specificare a quali uffici corrispondono un'entità ElectionEvent
e OfficeholderSubFeed
.
Elementi
Nome | Tag | Tipo | Note | Molteplicità |
---|---|---|---|---|
Nome debug | DebugName |
String |
Nome descrittivo utilizzato per l'ufficio. | 0 o 1 |
Livello ufficio | OfficeLevel |
OfficeLevel |
Specifica il livello degli uffici in questo ambito:
Country per il nazionale, Administrative Area 1
per uno stato o una provincia e così via. |
1 |
ID OCD di giurisdizione | JurisdictionOcdId |
Ocd Id |
Facoltativo se OfficeLevel è Country ,
altrimenti obbligatorio. Utilizza questo campo per specificare la geografia politica.
Ad esempio, se lo stato è Virginia e Pennsylvania o Manitoba rispetto a Ontario. |
0 o 1 |
Ruoli Office | OfficeRoles |
OfficeRole |
Un elenco dei ruoli contenuti nel set di dati, in particolare limitato a quelli eletti per questo livello di carica, ID OCD giurisdizione e così via. | 1 o più |
ElectoralDistrictCollection | ElectoralDistrictCollection |
Ocd Id |
L'elenco di ID OCD dei distretti elettorali che votano per il ruolo di carica in elenco. Un elenco vuoto indica che l'ambito include tutti i possibili distretti per il funzionario o la sede elettorale specificati. | 0 o 1 |
Esempi
L'esempio seguente è un Feed
che contiene un ElectionEvent
con
OfficeScope
. Indica che Feed
contiene (o dovrebbe contenere) dati su una serie di una o più elezioni per eleggere il presidente di livello nazionale, uno o più seggi alla Camera e uno o più seggi alla Camera:
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
indicano diverse elezioni a livello statale in Virginia e Pennsylvania per
ruoli statali 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" ] } }
ElectionEvent
può, se necessario, contenere OfficeScope
entità che specificano i distretti elettorali che votano per il ruolo della carica elencato:
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" ] } } }