OfficeScope

Các thực thể OfficeScope được dùng để chỉ định văn phòng mà thực thể ElectionEvent và OfficeholderSubFeed tương ứng.

Thành phần

Phần tử Số bội Loại Mô tả
DebugName 0 hoặc 1 string Tên mô tả được dùng cho văn phòng.
OfficeLevel 1 OfficeLevel Chỉ định cấp độ của các văn phòng trong phạm vi này: Country cho quốc gia, Administrative Area 1 cho tiểu bang hoặc tỉnh, v.v.
JurisdictionOcdId 0 hoặc 1 string Mã nhận dạng OCD của khu vực tài phán nơi đặt văn phòng.
OfficeRoles 1 trở lên OfficeRole Danh sách các vai trò có trong tập dữ liệu, cụ thể là chỉ giới hạn ở những vai trò được bầu cho cấp văn phòng này, mã nhận dạng OCD của khu vực tài phán, v.v.
ElectoralDistrictCollection 0 hoặc 1 Không áp dụng Phần tử bao bọc cho danh sách mã nhận dạng OCD của các khu vực bầu cử bỏ phiếu cho các vai trò văn phòng được liệt kê. Danh sách trống có nghĩa là phạm vi bao gồm tất cả các quận có thể có cho địa điểm bầu cử hoặc người nắm giữ chức vụ được chỉ định.

Ví dụ

Ví dụ sau đây là một Feed chứa ElectionEvent có OfficeScope. Tham số này cho biết Feed chứa (hoặc dự kiến sẽ chứa) dữ liệu về một nhóm gồm một hoặc nhiều cuộc bầu cử để bầu Tổng thống cấp quốc gia, một hoặc nhiều ghế Hạ viện và một hoặc nhiều ghế Thượng viện:

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"
   ]
 }
}

Cùng một ElectionEvent có thể chứa các thực thể OfficeScope bổ sung cho biết một số cuộc bầu cử cấp tiểu bang ở Virginia và Pennsylvania cho các vai trò cấp tiểu bang khác nhau:

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"
 ]
 }
}

Nếu cần, ElectionEvent có thể chứa các thực thể OfficeScope chỉ định các khu vực bầu cử bỏ phiếu cho vai trò chức vụ được liệt kê:

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"
     ]
   }
 }
}