OfficeScope

OfficeScope エンティティは、ElectionEvent エンティティと OfficeholderSubFeed エンティティが対応する公職を指定するために使用されます。

要素

要素 重複 タイプ 説明
DebugName 0 または 1 string 公職に使用されるわかりやすい名前。
OfficeLevel 1 OfficeLevel この範囲内の公職のレベルを指定します: Country 国レベルの場合は、Administrative Area 1 州レベルの場合などです。
JurisdictionOcdId 0 または 1 string 公職の管轄区域の OCD ID 。
OfficeRoles 1 以上 OfficeRole データセットに含まれる役割のリスト。 この公職レベル、管轄区域 OCD ID などで選出される役割に限定されます。
ElectoralDistrictCollection 0 または 1 なし リストに記載されている公職の役割に投票する選挙区の OCD ID のリストのラッパー要素。 リストが空の場合、指定された選挙場所または公職者のすべての選挙区が範囲に含まれます。

例

次の例は、OfficeScope を含む ElectionEvent を含む Feed です。これは、Feed に、国レベルの大統領、下院議員、上院議員を選出する 1 つ以上の選挙に関するデータが含まれている（または含まれる予定である）ことを示しています。

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>

同じ ElectionEvent に、バージニア州とペンシルベニア州の州レベルのさまざまな役割に対する州レベルの選挙を示す追加の OfficeScope エンティティを含めることができます。

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>

必要に応じて、ElectionEvent に、リストに記載されている公職の役割に投票する選挙区を指定する OfficeScope エンティティを含めることができます。

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>