Les entités OfficeScope
permettent de spécifier les bureaux auxquels correspondent les entités ElectionEvent
et OfficeholderSubFeed
.
Éléments
Nom | Tag | Type | Remarques | Multiplicité |
---|---|---|---|---|
Nom du débogage | DebugName |
String |
Nom descriptif du bureau. | 0 ou 1 |
Au niveau du bureau | OfficeLevel |
OfficeLevel |
Spécifie le niveau des bureaux dans ce champ d'application : Country pour le pays, Administrative Area 1 pour un État ou une province, etc. |
1 |
ID de la juridiction OCD | JurisdictionOcdId |
Ocd Id |
Facultatif si OfficeLevel est défini sur Country . Sinon, il est obligatoire. Ce champ vous permet de spécifier la zone géographique politique.
(par exemple, si l'État est la Virginie contre la Pennsylvanie, ou le Manitoba contre l'Ontario). |
0 ou 1 |
Rôles dans les bureaux | OfficeRoles |
OfficeRole |
Liste des rôles contenus dans l'ensemble de données, spécifiquement limités aux personnes élues pour ce niveau de charge, ID OCD de la juridiction, etc. | 1 ou plus |
ElectoralDistrictCollection | ElectoralDistrictCollection |
Ocd Id |
Liste d'identifiants OCD des circonscriptions électorales votant pour le poste indiqué. Une liste vide signifie que le champ d'application inclut toutes les circonscriptions possibles pour le lieu électoral ou le titulaire spécifié. | 0 ou 1 |
Exemples
L'exemple suivant est un Feed
contenant un élément ElectionEvent
avec OfficeScope
. Il indique que Feed
contient (ou devrait contenir) des données sur un ensemble d'une ou plusieurs élections visant à élire le président au niveau national, un ou plusieurs sièges basse Chambre et un ou plusieurs sièges à la Chambre haute:
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" ] } }
Le même ElectionEvent
peut contenir des entités OfficeScope
supplémentaires qui indiquent plusieurs élections au niveau de l'État en Virginie et en Pennsylvanie pour différents rôles au niveau de l'État:
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" ] } }
Le ElectionEvent
peut, si nécessaire, contenir des entités OfficeScope
qui spécifient les circonscriptions électorales votant pour le poste indiqué:
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" ] } } }