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 列表的封装容器元素。 如果列表为空，则表示范围包括指定选举地点或公职人员的所有可能选区。

示例

以下示例是一个 Feed，其中包含一个具有 OfficeScope 的 ElectionEvent。它表示 Feed 包含（或预计包含）一组或多组选举的数据，这些选举用于选出国家级总统、一个或多个下议院席位以及一个或多个上议院席位：

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>