אפשר להשתמש ב-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 |
הסוג המנוי של SeatStatus של נבחר הציבור, לדוגמה
active או on-leave. ערך ברירת המחדל הוא active אם לא מצוין SeatStatus.
המאפיין
|
SelectionMethod |
0 או יותר | OfficeSelectionMethod |
מידע על אופן הבחירה של בעל התפקיד או על אופן המינוי שלו לתפקיד. |
Term |
1 | Term |
מספק מידע שקשור לתנאי השימוש ב-Office. |
סוגים נוספים של ExternalIdentifiers
ברכיב ExternalIdentifiers של Office, מספקים נתונים נוספים עם Type של other, יחד עם ערכים של OtherType ו-Value. בטבלה הבאה מוצגים הערכים האפשריים של הרכיבים האלה:
OtherType |
ערכים לדוגמה | תיאור |
|---|---|---|
jurisdiction-id |
gpu1 |
המאפיין |
government-body |
United States Senate |
מידע נוסף מפורט בGovernmentBody.
|
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>