OfficeScope

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

רכיבים

רכיב ריבוי סוג תיאור
DebugName 0 או 1 string שם תיאורי שמשמש לזיהוי המשרד.
OfficeLevel 1 OfficeLevel מציין את רמת המשרדים במסגרת הזו: ‫Country לאומי, Administrative Area 1 מדינתי או מחוזי וכו'.
JurisdictionOcdId 0 או 1 string מזהה ה-OCD של תחום השיפוט שבו נמצאים המשרדים.
OfficeRoles 1 או יותר OfficeRole רשימה של התפקידים שנכללים במערך הנתונים, שמוגבלת לתפקידים שנבחרים ברמת המשרה הזו, למזהה OCD של תחום השיפוט וכו'.
ElectoralDistrictCollection 0 או 1 לא רלוונטי רכיב wrapper לרשימה של מזהי OCD של מחוזות הבחירה שבהם מצביעים לתפקידים המפורטים. רשימה ריקה מציינת שההיקף כולל את כל המחוזות האפשריים עבור המיקום או בעל התפקיד שצוינו בבחירות.

דוגמאות

הדוגמה הבאה היא 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>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"
     ]
   }
 }
}