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>

אותו 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>

התג 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>