אפשר להשתמש ב-Office כדי להגדיר משרה ומידע שקשור לתחרות על המשרה. משרה מזוהה לפי המחוז הבחירות והתפקיד שלה.
האלמנט Office רלוונטי לכל סוגי הפידים, אבל לא צריך לציין אותו במשאל עם.
בוחרים אחד מסוגי הפידים הבאים כדי לקבל מידע נוסף על השימוש ב-Office עם סוג הפיד הזה.
מאפיינים
בטבלה הבאה מפורטים המאפיינים של Office:
| מאפיין | חובה? | סוג | תיאור |
|---|---|---|---|
objectId |
חובה | ID |
מזהה פנימי ייחודי שמשמש רכיבים אחרים כדי ליצור הפניה לרכיב הזה. |
רכיבים
בטבלה הבאה מתוארים הרכיבים של Office:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
ContactInformation |
0 או יותר | ContactInformation |
משייך פרטים שונים ליצירת קשר עם המשרד. אם הרכיב הזה כלול, צריך לציין רק מידע שקשור למשרד עצמו, ולא למועמד או לבעל התפקיד הנוכחי. |
ElectoralDistrictId |
1 | IDREF |
צריך לציין את בפיד שלנתונים לפני הבחירות, צריך לספק ישות דוגמה: הבחירות לפרלמנט בטייוואן
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
משייך מזהה למשרד. צריך לציין מזהה יציב. מזהים יציבים של משרדים צריכים להיות ייחודיים בכל תקופות הכהונה של המשרדים. לדוגמה, לכל אחת מעשר התקופות הבאות צריך להיות מזהה ייחודי של משרד יציב:
הרכיב |
FilingDeadline |
0 או 1 | PartialDate |
התאריך האחרון שבו מועמד יכול להגיש מועמדות למשרה. המאפיין |
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. כל האפשרויות האפשריות מפורטות במאמר בנושא. |
SelectionMethod |
0 או יותר | OfficeSelectionMethod |
מידע על האופן שבו נבחר בעל התפקיד או מונה לתפקיד. |
Term |
0 או 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="off9999a"> <ElectoralDistrictId>ru0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>stable-off9999a</Value> </ExternalIdentifier> </ExternalIdentifiers> <IsPartisan>true</IsPartisan> <JurisdictionId>ru0002</JurisdictionId> <Level>Administrative Area 1</Level> <Name> <Text language="en">President</Text> </Name> <Role>president</Role> <Term> <Type>full-term</Type> </Term> </Office>