OfficeScope

הערה: בישות הזו משתמשים רק בפידים של מטא-נתונים. לא נעשה בו שימוש עם פידים של נבחרי ציבור, של בחירות או של בעלי תפקידים.

ישויות של OfficeScope משמשות לציון המשרדים ElectionEvent וגם ישות OfficeholderSubFeed תואמת.

רכיבים

שם	תיוג	סוג	הערות	ריבוי
שם ניפוי הבאגים	DebugName	String	שם תיאורי המשמש למשרד.	0 או 1
רמת המשרד	OfficeLevel	OfficeLevel	מציין את רמת המשרדים בהיקף הזה: Country במדינה הארצית, Administrative Area 1 עבור מדינה או מחוז וכו'	1
מזהה OCD של סמכות שיפוט	JurisdictionOcdId	Ocd Id	אופציונלי אם הערך של OfficeLevel הוא Country, אחרת. צריך להשתמש בשדה הזה כדי לציין את המיקום הפוליטי. לדוגמה, אם המדינה היא וירג'יניה לעומת פנסילבניה או מניטובה נגד אונטריו.	0 או 1
תפקידים במשרד	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"
     ]
   }
 }
}