אפשר להשתמש ב-Office כדי להגדיר משרה ומידע שקשור לתחרות על המשרה. משרה מזוהה לפי המחוז הבחירות והתפקיד שלה.
האלמנט Office רלוונטי לכל סוגי הפידים, אבל לא צריך לציין אותו במשאל עם.
בוחרים אחד מסוגי הפידים הבאים כדי לקבל מידע נוסף על השימוש ב-Office עם סוג הפיד הזה.
מאפיינים
בטבלה הבאה מפורטים המאפיינים של Office:
| מאפיין | חובה? | סוג | תיאור |
|---|---|---|---|
objectId |
חובה | ID |
מזהה פנימי ייחודי שמשמש רכיבים אחרים כדי ליצור הפניה לרכיב הזה. |
רכיבים
בטבלה הבאה מתוארים הרכיבים של Office:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
ContactInformation |
0 או יותר | ContactInformation |
משייך פרטים שונים ליצירת קשר עם המשרד. אם הרכיב הזה כלול, צריך לציין רק מידע שקשור למשרד עצמו, ולא למועמד או לבעל התפקיד הנוכחי. |
ElectoralDistrictId |
0 או 1 | IDREF |
צריך לציין את בפיד של בעלי תפקידים ציבוריים, אנחנו מצפים ל- לדוגמה: הבחירות לפרלמנט בטייוואן
דוגמה נוספת: פיד של בעלי תפקידים בסנאט של ארה"ב
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
משייך מזהה למשרד. צריך לציין מזהה יציב. מזהים יציבים של משרדים צריכים להיות ייחודיים בכל תקופות הכהונה של המשרדים. לדוגמה, לכל אחת מעשר התקופות הבאות צריך להיות מזהה ייחודי של משרד יציב:
הרכיב |
GovernmentBodyIds |
0 או 1 | IDREFS |
צריך לציין את objectId של GovernmentBody שהמשרד הזה הוא חלק ממנו. לדוגמה, United States Senate (הסנאט של ארצות הברית) לציון סנאטור בארה"ב |
Name |
1 | InternationalizedText |
השם המלא של התפקיד הכללי במשרד הזה. הפרטים האלה צריכים לכלול את תחום השיפוט של המשרד, אבל לא לכלול מידע שקשור למחוז הבחירה.
דוגמאות:
|
JurisdictionId |
0 או 1 | IDREF |
צריך לספק את |
Level |
0 או 1 | OfficeLevel |
סוג הרמה של המשרד. רשימת האפשרויות המלאה מופיעה במאמר הפניה. |
Role |
0 או יותר | OfficeRole |
הסוג הממוספר של התפקיד במשרד, למשל cabinet member או president. כל האפשרויות האפשריות מפורטות במאמר בנושא. |
OfficeHolderPersonIds |
1 | IDREFS |
צריך לציין את |
SeatStatus |
0 או 1 | SeatStatus |
סוג המושב של נבחר הציבור, למשל active או on-leave. ערך ברירת המחדל הוא active אם לא צוין SeatStatus.
המאפיין
|
SelectionMethod |
0 או יותר | OfficeSelectionMethod |
מידע על האופן שבו נבחר בעל התפקיד או מונה לתפקיד. |
Term |
1 | Term |
מספק מידע שקשור למונחים של המשרד. |
סוגים נוספים של ExternalIdentifiers
ברכיב ExternalIdentifiers של Office, מספקים נתונים נוספים עם Type של other, יחד עם ערכים של OtherType ו-Value. בטבלה הבאה מוצגים הערכים האפשריים של הרכיבים האלה:
OtherType |
ערכים לדוגמה | תיאור |
|---|---|---|
jurisdiction-id |
gpu1 |
המאפיין |
legislative-session |
116th United States Congress |
|
office-level |
Country |
הערך חייב להיות בין OfficeLevel.
אם אף אחת מהאפשרויות לא רלוונטית, פנו לאיש הקשר שלכם ב-Google.
|
office-role |
upper house |
הערך חייב להיות בין |
office-seat |
Position 1, Seat 2,
unexpired, special,
Seat 2 special |
אפשר להשתמש בזה כדי להבדיל בין משרדים עם כמה מושבים או תפקידים, וגם למשרדים עם תוקף לא מוגבל. |
דוגמאות
XML
<Office objectId="off0"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>stable-off0</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>