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

Tên Thẻ Loại Ghi chú Số bội
Tên gỡ lỗi DebugName string Tên mô tả được dùng cho văn phòng. 0 hoặc 1
Cấp văn phòng OfficeLevel 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. 1
Mã OCD của khu vực tài phán JurisdictionOcdId Ocd Id Không bắt buộc nếu OfficeLevel là Country, nếu không thì bắt buộc. Hãy sử dụng trường này để chỉ định khu vực địa lý chính trị. Ví dụ: nếu tiểu bang là Virginia so với Pennsylvania, hoặc Manitoba so với Ontario. 0 hoặc 1
Vai trò trong Office OfficeRoles 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. 1 trở lên
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id Danh sách mã nhận dạng OCD của các khu vực bầu cử bỏ phiếu cho vai trò văn phòng được liệt kê. Danh sách trống ngụ ý rằng 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. 0 hoặc 1

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>National</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": "National",
   "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"
     ]
   }
 }
}