OfficeScope

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

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

एलिमेंट

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

उदाहरण

यहां दिए गए उदाहरण में, एक 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>Country</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": "Country",
   "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"
     ]
   }
 }
}