OfficeScope

Lưu ý: Thực thể này chỉ được dùng trong nguồn cấp dữ liệu siêu dữ liệu. Thẻ này không được dùng với nguồn cấp dữ liệu trước bầu cử, bầu cử hoặc chính trị.

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

Các phần tử

Tên	Gắ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	Xác đị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
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. Sử dụng trường này để chỉ định đị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 văn phòng	OfficeRoles	OfficeRole	Danh sách các vai trò có trong tập dữ liệu, cụ thể ở những người được chọn ở cấp văn phòng này, mã OCD ở khu vực tài phán, v.v.	từ 1 trở lên
ElectoralDistrictCollection	ElectoralDistrictCollection	Ocd Id	Danh sách mã OCD của các khu vực bầu cử bỏ phiếu cho vai trò văn phòng được nêu. Danh sách trống ngụ ý rằng phạm vi này bao gồm tất cả các hạt có thể có cho địa điểm bầu cử hoặc chính trị gia đã chỉ định.	0 hoặc 1

Ví dụ

Ví dụ sau đây là một Feed chứa ElectionEvent với OfficeScope. Thuộc tính này cho biết Feed chứa (hoặc dự kiến có chứa) dữ liệu về một tập hợp 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 cho biết có một số cuộc bầu cử cấp tiểu bang tại Virginia và Pennsylvania cho các vai trò khác nhau cấp tiểu bang:

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ử cho vai trò văn phòng như đượ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"
     ]
   }
 }
}