OfficeScope

Сущности OfficeScope используются для указания того, каким должностным лицам соответствуют сущности ElectionEvent и OfficeholderSubFeed .

Элементы

Элемент Множественность Тип Описание
DebugName 0 или 1 string Описательное название, используемое для офиса.
OfficeLevel 1 OfficeLevel Указывает уровень полномочий ведомств в рамках данной сферы: Country для национального уровня, Administrative Area 1 для штата или провинции и т. д.
JurisdictionOcdId 0 или 1 string Идентификатор OCD , соответствующий юрисдикции офисов.
OfficeRoles 1 или более OfficeRole Список должностей, содержащихся в наборе данных, с указанием только тех, кто избирается на должность соответствующего уровня, идентификатор OCD юрисдикции и т. д.
ElectoralDistrictCollection 0 или 1 Н/Д Элемент-оболочка для списка идентификаторов OCD избирательных округов, голосующих за указанные должности. Пустой список означает, что область действия включает все возможные округа для указанного места выборов или должностного лица.

Примеры

В следующем примере представлена Feed , содержащая ElectionEvent с OfficeScope . Это указывает на то, что 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>