משרד

אפשר להשתמש ב-Office כדי להגדיר משרה ומידע שקשור לתחרות עליה. משרד מזוהה לפי המחוז הבחירות שלו ותפקיד המשרד.

האלמנט Office חל על כל סוגי הפידים, אבל אין צורך לציין אותו במשאל עם.

כדי לקבל מידע נוסף על השימוש ב-Office עם סוג מסוים של פיד, בוחרים באחד מסוגי הפידים הבאים.

מאפיינים

בטבלה הבאה מתוארים המאפיינים של Office:

מאפיין חובה? סוג תיאור
objectId חובה ID מזהה פנימי ייחודי שמשמש רכיבים אחרים להפניה לרכיב הזה.

רכיבים

בטבלה הבאה מתוארים הרכיבים של Office:

רכיב ריבוי סוג תיאור
ContactInformation 0 או יותר ContactInformation משייך פרטים שונים ליצירת קשר למשרד. אם הרכיב הזה כלול, צריך לציין רק מידע שקשור למשרד עצמו, ולא למועמד או לבעל התפקיד הנוכחי.
DiplomatReceivingStateId 0 או 1 IDREF

צריך לציין את objectId של GpUnit שמציין את המדינה המקבלת של משרד דיפלומטי.
DiplomatSendingStateId 0 או 1 IDREF

מציינים את objectId של GpUnit שמציין את המדינה השולחת של נציגות דיפלומטית.
ElectoralDistrictId ‫0 או 1 IDREF

צריך לציין את objectId של GpUnit שמייצג את מחוז הבחירה. לדוגמה, אפשר לציין מדינה, כמו 'אלסקה', כשמדובר בסנאטור בארה"ב, או מחוז, כמו 'המחוז ה-14 של ניו יורק בקונגרס', כשמדובר בנציג בבית הנבחרים של ארה"ב.

בפיד של בעלי התפקידים, אנחנו מצפים ל-Office אחד לכל מושב, ולכך שהשדה ElectoralDistrictId יוגדר למחוז שבו נבחר האדם הזה לתפקיד.

דוגמה: הבחירות לרשות המחוקקת בטייוואן

  • צריך לתת לכל חבר ב-Legislative Yuan ערך Office שונה, בהתאם למחוז שלו.

דוגמה נוספת: פיד של בעלי תפקידים בסנאט של ארה"ב

  • צריך לספק 100 אובייקטים מסוג Office לסנאט של ארה"ב.
ExternalIdentifiers 1 ExternalIdentifiers

משייך מזהה למשרד. צריך לציין מזהה יציב. המזהים הקבועים של המשרדים חייבים להיות ייחודיים בכל תקופות הכהונה במשרד. לדוגמה, לכל אחת מתקופות הכהונה הבאות צריך להיות מזהה משרד קבוע נפרד:

  • הנשיאות של גרובר קליבלנד מ-1885 עד 1889
  • תקופת הנשיאות של גרובר קליבלנד מ-1893 עד 1897
  • תקופת הנשיאות של פרנקלין רוזוולט, מ-1933 עד 1945

רכיב ExternalIdentifiers של Office מאפשר לספק מידע נוסף עם ערכים ספציפיים של OtherType. לפרטים נוספים, ראו סוגים נוספים של ExternalIdentifiers.
GovernmentBodyIds 0 או 1 IDREFS צריך לציין את objectId של GovernmentBody שהמשרד הזה שייך אליו. לדוגמה, United States Senate (הסנאט של ארצות הברית) לסנאטור אמריקאי
Name 1 InternationalizedText השם המלא של התפקיד הכללי במשרד הזה. המידע הזה צריך לכלול את תחום השיפוט של המשרד, אבל לא לכלול מידע שקשור למחוז הבחירה.

דוגמאות:

  • חבר בפרלמנט של סינגפור
  • ראש ממשלת הודו
  • נשיא אינדונזיה
  • סנאטור בארצות הברית
JurisdictionId 0 או 1 IDREF

מציינים את objectId של GpUnit שמגדיר את תחום השיפוט של המשרד.
Level 0 או 1 OfficeLevel

סוג הרמה של המשרד. רשימת האפשרויות המלאה מופיעה במאמר בנושא הפניה.
Role ‫0 או יותר OfficeRole הסוג הממוספר של התפקיד במשרד, למשל cabinet member או president. כל האפשרויות האפשריות מפורטות במאמר בנושא.
OfficeHolderPersonIds 1 IDREFS

צריך לציין את objectId של Person שמחזיק בתפקיד הזה.
SeatStatus 0 או 1 SeatStatus סוג ה-SeatStatus של נבחר הציבור, כמו active או on-leave. ערך ברירת המחדל הוא active אם לא צוין SeatStatus. המאפיין
SelectionMethod ‫0 או יותר OfficeSelectionMethod מידע על האופן שבו נבחר נבחר הציבור או על האופן שבו הוא מונה לתפקיד.
Term 1 Term מספק מידע שקשור למונחים במשרד.

סוגים נוספים של ExternalIdentifiers

באמצעות האלמנט ExternalIdentifiers של Office, מספקים נתונים נוספים עם Type של other, יחד עם ערכים של OtherType ושל Value. בטבלה הבאה מפורטים הערכים האפשריים של הרכיבים האלה:

OtherType ערכים לדוגמה תיאור
jurisdiction-id gpu1

השדה objectId של GpUnit שמציין את תחום השיפוט של המשרד.
legislative-session 116th United States Congress
office-level Country הערך חייב להיות בין OfficeLevel. אם אף אחת מהאפשרויות לא רלוונטית, פנו לאיש הקשר שלכם ב-Google.
office-role upper house

הערך חייב להיות בין OfficeRole. אם אף אחת מהאפשרויות לא רלוונטית, פנו לאיש הקשר שלכם ב-Google.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

אפשר להשתמש בזה כדי להבדיל בין משרדים עם כמה מושבים או תפקידים, ולמשרדים כלליים ובתוקף.

דוגמאות

XML

    <Office objectId="off-0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <JurisdictionId>ru-gpu0</JurisdictionId>
      <Level>Administrative Area 1</Level>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <Role>upper house</Role>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>