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 מכיל (או צפוי להכיל) נתונים על מערך של בחירות אחת או יותר לנשיאות ברמה הלאומית, על מושב אחד או יותר בבית התחתון ועל מושב אחד או יותר בבית העליון:

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