OfficeScope

Les entités OfficeScope permettent de spécifier à quels bureaux correspondent les entités ElectionEvent et OfficeholderSubFeed.

Éléments

Élément Multiplicité Type Description
DebugName 0 ou 1 string Nom descriptif utilisé pour le bureau.
OfficeLevel 1 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.
JurisdictionOcdId 0 ou 1 string L'ID OCD de la juridiction des bureaux.
OfficeRoles 1 ou plus 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.
ElectoralDistrictCollection 0 ou 1 N/A Élément wrapper pour la liste des ID OCD des circonscriptions électorales votant pour les fonctions listées. 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.

Exemples

L'exemple suivant est un Feed qui contient un ElectionEvent avec OfficeScope. Il 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>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>

JSON

{
 "OfficeScope": {
   "DebugName" : "US general election scope",
   "OfficeLevel": "Country",
   "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"
     ]
   }
 }
}