OfficeScope

หมายเหตุ: เอนทิตีนี้ใช้ในฟีดข้อมูลเมตาเท่านั้น โดยจะไม่ใช้กับฟีด ก่อนการเลือกตั้ง การเลือกตั้ง หรือผู้ดำรงตำแหน่ง

ระบบใช้เอนทิตี OfficeScope เพื่อระบุว่าสำนักงานใดที่เอนทิตี ElectionEvent และ OfficeholderSubFeed สอดคล้องกัน

องค์ประกอบ

ชื่อ	แท็ก	ประเภท	หมายเหตุ	ความหลากหลาย
ชื่อการแก้ไขข้อบกพร่อง	DebugName	string	ชื่อที่สื่อความหมายที่ใช้สำหรับสำนักงาน	0 หรือ 1
ระดับสำนักงาน	OfficeLevel	OfficeLevel	ระบุระดับของสำนักงานภายในขอบเขตนี้ Country สำหรับระดับประเทศ Administrative Area 1 สำหรับระดับรัฐหรือจังหวัด ฯลฯ	1
รหัส OCD ของเขตอำนาจศาล	JurisdictionOcdId	Ocd Id	ไม่บังคับหาก OfficeLevel เป็น Country แต่ต้องระบุในกรณีอื่น ใช้ฟิลด์นี้เพื่อระบุภูมิศาสตร์ทางการเมือง เช่น หากเป็นรัฐเวอร์จิเนียเทียบกับรัฐเพนซิลเวเนีย หรือรัฐแมนิโทบาเทียบกับรัฐออนแทรีโอ	0 หรือ 1
บทบาทใน Office	OfficeRoles	OfficeRole	รายการบทบาทที่มีอยู่ในชุดข้อมูล โดยจำกัดเฉพาะ ผู้ที่ได้รับการเลือกตั้งสำหรับระดับสำนักงานนี้, รหัส OCD ของเขตอำนาจศาล ฯลฯ	1 รายการขึ้นไป
ElectoralDistrictCollection	ElectoralDistrictCollection	Ocd Id	รายการรหัส OCD ของเขตเลือกตั้งที่ลงคะแนนสำหรับบทบาทในสำนักงานที่ระบุ ไว้ รายการที่ว่างเปล่าหมายความว่าขอบเขตครอบคลุมเขตเลือกตั้งที่เป็นไปได้ทั้งหมด สำหรับสถานที่เลือกตั้งหรือผู้ดำรงตำแหน่งที่ระบุ	0 หรือ 1

ตัวอย่าง

ตัวอย่างต่อไปนี้คือ Feed ที่มี ElectionEvent พร้อม OfficeScope ซึ่งระบุว่า Feed มี (หรือคาดว่าจะมี) ข้อมูลเกี่ยวกับการเลือกตั้งอย่างน้อย 1 ครั้งเพื่อเลือกประธานาธิบดีระดับประเทศ ที่นั่งในสภาล่างอย่างน้อย 1 ที่นั่ง และที่นั่งในสภาสูงอย่างน้อย 1 ที่นั่ง

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

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>

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

ElectionEvent สามารถมีOfficeScopeเอนทิตีที่ระบุ เขตเลือกตั้งที่ลงคะแนนเสียงสำหรับบทบาทในตำแหน่งที่ระบุได้ หากจำเป็น

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