Les entités OfficeScope permettent de spécifier à quels bureaux correspondent les entités ElectionEvent et OfficeholderSubFeed.
Éléments
| Nom | Tag | Type | Remarques | Multiplicité |
|---|---|---|---|---|
| Nom de débogage | DebugName |
string |
Nom descriptif utilisé pour le bureau. | 0 ou 1 |
| Au niveau de l'établissement | OfficeLevel |
OfficeLevel |
Spécifie le niveau des bureaux dans ce champ d'application :
Country pour le niveau national, Administrative Area 1
pour un État ou une province, etc. |
1 |
| ID de l'OCD de la juridiction | JurisdictionOcdId |
Ocd Id |
Facultatif si OfficeLevel est Country, obligatoire dans le cas contraire. Utilisez ce champ pour spécifier la géographie politique.
Par exemple, si l'état est la Virginie plutôt que la Pennsylvanie, ou le Manitoba plutôt que l'Ontario. |
0 ou 1 |
| Rôles Office | OfficeRoles |
OfficeRole |
Liste des rôles contenus dans l'ensemble de données, limitée spécifiquement à ceux qui sont élus pour ce niveau de fonction, à l'ID OCD de la juridiction, etc. | 1 ou plus |
| ElectoralDistrictCollection | ElectoralDistrictCollection |
Ocd Id |
Liste des ID OCD des circonscriptions électorales votant pour le poste indiqué. Une liste vide implique que le champ d'application inclut tous les districts possibles pour le lieu de scrutin ou le titulaire du poste spécifiés. | 0 ou 1 |
Exemples
L'exemple suivant est un Feed qui contient un ElectionEvent avec OfficeScope. Cela indique que Feed contient (ou devrait contenir) des données sur un ou plusieurs scrutins visant à élire le président au niveau national, un ou plusieurs sièges à la Chambre basse 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" ] } }
Si nécessaire, ElectionEvent peut contenir des entités OfficeScope qui spécifient les circonscriptions électorales votant pour le rôle de fonctionnaire 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" ] } } }