OfficeScope

Remarque : Cette entité n'est utilisée que dans les flux de métadonnées. Elle n'est pas utilisée avec les flux pré-électoraux, électoraux ou de titulaires de fonctions.

Les entités OfficeScope permettent de spécifier les fonctions auxquelles correspondent une entité ElectionEvent et une entité OfficeholderSubFeed.

Éléments

Élément	Multiplicité	Type	Description
DebugName	0 ou 1	string	Nom descriptif utilisé pour la fonction.
OfficeLevel	1	OfficeLevel	Spécifie le niveau des fonctions dans ce champ d'application : Country pour national, Administrative Area 1 pour un État ou une province, etc.
JurisdictionOcdId	0 ou 1	string	ID OCD de la juridiction des fonctions. Remarque :Facultatif si OfficeLevel est Country, sinon obligatoire, par exemple si les fonctions sont compétentes dans un État.
OfficeRoles	1 ou plus	OfficeRole	Liste des rôles contenus dans l'ensemble de données, limitée spécifiquement à ceux pour lesquels des élections sont organisées pour ce niveau de fonction, cet ID OCD de juridiction, etc.
ElectoralDistrictCollection	0 ou 1	N/A	Élément conteneur pour la liste des ID OCD des circonscriptions électorales votant pour les rôles de fonction listés. Une liste vide implique que le champ d'application inclut toutes les circonscriptions possibles pour le lieu d'élection ou le titulaire de fonction spécifié.

Exemples

L'exemple suivant est un Feed qui contient un ElectionEvent avec OfficeScope. Il indique que le Feed contient (ou est censé contenir) des données sur un ensemble d'une ou plusieurs élections pour é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>

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>

Si nécessaire, l'ElectionEvent peut contenir des entités OfficeScope qui spécifient les circonscriptions électorales votant pour le rôle de fonction listé :

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>