משרד

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

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

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

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

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

מאפיינים

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

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

רכיבים

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

רכיב ריבוי סוג תיאור
ContactInformation 0 או יותר ContactInformation שיוך של פרטים שונים ליצירת קשר עם המשרד. אם האלמנט הזה כלול, צריך לציין רק מידע שקשור לתפקיד עצמו, ולא למועמד או לנבחר הציבור הנוכחי.
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 השם המלא של התפקיד הכללי של המשרד הזה. המידע הזה צריך לכלול את תחום השיפוט של המשרד, אבל לא מידע שקשור למחוז הבחירות.

דוגמאות:

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

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

סוגי ערכים נוספים ל-ExternalIdentifiers

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

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

חובה

השדה objectId של ה-GpUnit שמציין את סמכות השיפוט של המשרד.
government-body United States Senate מידע נוסף זמין במאמר GovernmentBody.
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="off0">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-off0</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-level</OtherType>
          <Value>Administrative Area 1</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>office-role</OtherType>
          <Value>upper house</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>jurisdiction-id</OtherType>
          <Value>ru-gpu0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <GovernmentBodyIds>gb-1</GovernmentBodyIds>
      <Name>
        <Text language="en">United States Senator</Text>
      </Name>
      <OfficeHolderPersonIds>per0</OfficeHolderPersonIds>
      <SelectionMethod>directly-elected</SelectionMethod>
      <Term>
        <StartDate>2019-01-02</StartDate>
      </Term>
    </Office>

JSON

    "Office": [
      {
        "objectId": "off0",
        "ElectoralDistrictId": "ru-gpu0",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-off0"
            },
            {
              "Type": "other",
              "OtherType": "office-level",
              "Value": "Administrative Area 1"
            },
            {
              "Type": "other",
              "OtherType": "office-role",
              "Value": "upper house"
            },
            {
              "Type": "other",
              "OtherType": "jurisdiction-id",
              "Value": "ru-gpu0"
            }
          ]
        }
        "GovernmentBodyIds": ["gb-1]
        "Name": {
          "Text": [
            {
              "value": "United States Senator",
              "language": "en"
            }
          ]
        }
        "OfficeHolderPersonIds": "per0"
        "SelectionMethod": "directly-elected"
        "Term": {
          "StartDate": "2019-01-02"
        }
      }
    ]