استخدِم Office لتحديد مكتب ومعلومات مرتبطة بمسابقته. يتم تحديد المكتب من خلال الدائرة الانتخابية ودور المكتب.
ينطبق العنصر Office على جميع أنواع الخلاصات، ولكن ليس من الضروري تحديده في الاستفتاءات.
اختَر أحد أنواع الخلاصات التالية لمعرفة المزيد حول كيفية استخدام Office
مع هذا النوع من الخلاصات.
السمات
يوضّح الجدول التالي سمات Office:
| السمة | مطلوب؟ | النوع | الوصف |
|---|---|---|---|
objectId |
مطلوب | ID |
معرّف داخلي فريد تستخدمه عناصر أخرى للإشارة إلى هذا العنصر. |
العناصر
يوضّح الجدول التالي عناصر Office:
| العنصر | التعددية | النوع | الوصف |
|---|---|---|---|
ContactInformation |
0 أو أكثر | ContactInformation |
ربط معلومات الاتصال المختلفة بالمكتب في حال تضمين هذا العنصر، يجب تحديد المعلومات ذات الصلة بالمنصب نفسه فقط، وليس بالمرشّح أو صاحب المنصب الحالي. |
ElectoralDistrictId |
0 أو 1 | IDREF |
يجب تقديم بالنسبة إلى خلاصة المسؤولين، نتوقّع مثال: الانتخابات التشريعية في تايوان
مثال آخر: خلاصة موجزة عن شاغل منصب في مجلس الشيوخ الأمريكي
|
ExternalIdentifiers |
1 | ExternalIdentifiers |
يربط هذا الحقل معرّفًا بالمكتب. يجب توفير معرّف ثابت. يجب أن تكون المعرّفات الثابتة للمكاتب فريدة على مستوى فترات شغل المكاتب. على سبيل المثال، يحتاج كل من المناصب التالية إلى معرّف ثابت ومميّز:
يتيح لك العنصر |
GovernmentBodyIds |
0 أو 1 | IDREFS |
قدِّم objectId GovernmentBody الذي يندرج ضمنه هذا المنصب، مثل مجلس الشيوخ الأمريكي لعضو مجلس الشيوخ الأمريكي |
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>