OfficeScope

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

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

एलिमेंट

नाम	टैग	टाइप	नोट	गुणनफल
डीबग का नाम	DebugName	string	ऑफ़िस के लिए इस्तेमाल किया गया नाम, जिससे उसके बारे में जानकारी मिलती है.	0 या 1
ऑफ़िस लेवल	OfficeLevel	OfficeLevel	इससे इस स्कोप में आने वाले ऑफ़िस का लेवल पता चलता है: राष्ट्रीय स्तर के लिए Country, Administrative Area 1 राज्य या प्रांत के लिए, वगैरह.	1
Jurisdiction OCD ID	JurisdictionOcdId	Ocd Id	अगर OfficeLevel Country है, तो यह ज़रूरी नहीं है. हालांकि, अन्य मामलों में यह ज़रूरी है. राजनीतिक भूगोल के बारे में बताने के लिए, इस फ़ील्ड का इस्तेमाल करें. उदाहरण के लिए, अगर राज्य वर्जीनिया बनाम पेन्सिलवेनिया या मैनिटोबा बनाम ओंटारियो है.	0 या 1
ऑफ़िस की भूमिकाएं	OfficeRoles	OfficeRole	डेटा सेट में शामिल भूमिकाओं की सूची. खास तौर पर, इस ऑफ़िस लेवल, अधिकार क्षेत्र के ओसीडी आईडी वगैरह के लिए चुनी गई भूमिकाएं.	एक या इससे ज़्यादा
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"
     ]
   }
 }
}