OfficeScope

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

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ả dùng cho văn phòng này. 0 hoặc 1
Cấp văn phòng OfficeLevel OfficeLevel Chỉ định cấp của 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
ID OCD theo khu vực tài phán JurisdictionOcdId Ocd Id Không bắt buộc nếu OfficeLevel là Country, có yêu cầu khác. 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ò văn phòng OfficeRoles OfficeRole Danh sách vai trò có trong tập dữ liệu, cụ thể là giới hạn ở những người được bầu cho cấp văn phòng này, mã OCD tại khu vực tài phán, và hơn thế nữa từ 1 trở lên
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id Danh sách mã OCD của các khu vực bầu cử cho các khu vực bầu cử được liệt kê vai trò văn phòng. Danh sách trống ngụ ý rằng phạm vi bao gồm tất cả những gì có thể các quận đối với địa điểm bầu cử hoặc chính trị gia đã chỉ định. 0 hoặc 1

Ví dụ

Sau đây là ví dụ về Feed chứa ElectionEvent có OfficeScope. Mã này cho biết Feed có chứa (hoặc dự kiến sẽ chứa) dữ liệu về 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 khác biểu thị một số cuộc bầu cử cấp tiểu bang tại 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 số khu vực bầu cử bỏ phiếu cho vai trò văn phòng được nêu:

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