OfficeScope

ध्यान दें: इस इकाई का इस्तेमाल सिर्फ़ मेटाडेटा फ़ीड में किया जाता है. इसका इस्तेमाल चुनाव से पहले, चुनाव या पदाधिकारी के फ़ीड के साथ नहीं किया जाता है.

OfficeScope इकाइयों का इस्तेमाल यह बताने के लिए किया जाता है कि ElectionEvent और OfficeholderSubFeed इकाई किन ऑफ़िस से जुड़ी है.

एलिमेंट

नाम	टैग करें	टाइप	ज़रूरी जानकारी	गुणनफल
डीबग का नाम	DebugName	String	ऑफ़िस के लिए इस्तेमाल किया गया जानकारी देने वाला नाम.	0 या 1
ऑफ़िस लेवल	OfficeLevel	OfficeLevel	इस स्कोप में शामिल ऑफ़िस के लेवल की जानकारी देता है: राष्ट्रीय के लिए Country, किसी राज्य या प्रांत के लिए Administrative Area 1 वगैरह.	1
अधिकार क्षेत्र का ओसीडी आईडी	JurisdictionOcdId	Ocd Id	अगर OfficeLevel Country है, तो ज़रूरी नहीं है. राजनैतिक भूगोल बताने के लिए इस फ़ील्ड का इस्तेमाल करें. उदाहरण के लिए, अगर राज्य, वर्जीनिया बनाम पेंसिलवेनिया या मैनिटोबा बनाम ऑन्टेरियो है.	0 या 1
ऑफ़िस के लिए भूमिकाएं	OfficeRoles	OfficeRole	डेटा सेट में शामिल भूमिकाओं की सूची, जो खास तौर पर इस ऑफ़िस लेवल, अधिकार क्षेत्र के ओसीडी आईडी वगैरह के लिए चुनी जा रही है.	1 या ज़्यादा
ElectoralDistrictCollection	ElectoralDistrictCollection	Ocd Id	सूची में शामिल पद के लिए, मतदान करने वाले निर्वाचन ज़िलों की ओसीडी आईडी सूची. खाली सूची का मतलब है कि इस दायरे में, चुनाव की जगह या पदाधिकारी के लिए सभी संभावित ज़िलों को शामिल किया गया है.	0 या 1

उदाहरण

यह उदाहरण एक Feed है, जिसमें OfficeScope वाला ElectionEvent शामिल है. इससे पता चलता है कि Feed में राष्ट्रीय स्तर के राष्ट्रपति, लोअर हाउस की एक या उससे ज़्यादा सीटों, और उच्च सदन की एक या ज़्यादा सीटें चुनने के लिए, एक या उससे ज़्यादा चुनावों के बारे में डेटा है (या इसमें शामिल होने की उम्मीद है):

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