استخدِم Office لتحديد مكتب ومعلومات مرتبطة بمسابقته. يتم تحديد المكتب من خلال الدائرة الانتخابية ودور المكتب.
ينطبق العنصر Office على جميع أنواع الخلاصات، ولكن ليس من الضروري تحديده في الاستفتاءات.
اختَر أحد أنواع الخلاصات التالية لمعرفة المزيد حول كيفية استخدام Office
مع هذا النوع من الخلاصات.
السمات
يوضّح الجدول التالي سمات Office:
| السمة | مطلوب؟ | النوع | الوصف |
|---|---|---|---|
objectId |
مطلوب | ID |
معرّف داخلي فريد تستخدمه عناصر أخرى للإشارة إلى هذا العنصر. |
العناصر
يوضّح الجدول التالي عناصر Office:
| العنصر | التعددية | النوع | الوصف |
|---|---|---|---|
ContactInformation |
0 أو أكثر | ContactInformation |
ربط معلومات الاتصال المختلفة بالمكتب في حال تضمين هذا العنصر، يجب تحديد المعلومات ذات الصلة بالمنصب نفسه فقط، وليس بالمرشّح أو صاحب المنصب الحالي. |
ElectoralDistrictId |
1 | IDREF |
يجب تقديم |
ExternalIdentifiers |
1 | ExternalIdentifiers |
يربط هذا الحقل معرّفًا بالمكتب. يجب توفير معرّف ثابت. يجب أن تكون المعرّفات الثابتة للمكاتب فريدة على مستوى فترات شغل المكاتب. على سبيل المثال، يحتاج كل من المناصب التالية إلى معرّف ثابت ومميّز:
يتيح لك العنصر |
FilingDeadline |
0 أو 1 | PartialDate |
تم إيقاف السمة FilingDeadline نهائيًا لعناصر Office. استخدِم السمة في Contest بدلاً من ذلك. |
GovernmentBodyIds |
0 أو 1 | IDREFS |
قدِّم objectId GovernmentBody الذي يندرج ضمنه هذا المنصب، مثل مجلس الشيوخ الأمريكي لعضو مجلس الشيوخ الأمريكي |
Name |
1 | InternationalizedText |
تقدّم هذه السمة الاسم الكامل للعنوان العام لهذا المكتب، ويجب أن تتضمّن هذه السمة نطاق سلطة المكتب، ولكن بدون أي معلومات ذات صلة بالدائرة الانتخابية. أمثلة:
|
JurisdictionId |
0 أو 1 | IDREF |
يُرجى تقديم |
Level |
0 أو 1 | OfficeLevel |
تمثّل هذه السمة النوع المُعدّد لمستوى المكتب. راجِع المَرجع للاطّلاع على القائمة الكاملة بالخيارات. |
Role |
0 أو أكثر | OfficeRole |
تمثّل هذه السمة النوع المُعدَّد لدور المكتب، مثل cabinet member أو president. راجِع المرجع للاطّلاع على جميع الخيارات المتاحة. |
SelectionMethod |
0 أو أكثر | OfficeSelectionMethod |
معلومات حول كيفية اختيار صاحب المنصب أو تولّيه المنصب |
Term |
0 أو 1 | Term |
تقدّم هذه السمة معلومات ذات صلة بمصطلح المكتب.
Term الخاصة
بالسمة Office نهائيًا، لذا يُرجى تقديم هذه المعلومات باستخدام
السمة OfficeHolderTenure بدلاً منها. |
أنواع إضافية لـ ExternalIdentifiers
في العنصر ExternalIdentifiers من Office، قدِّم بيانات إضافية مع Type بقيمة other، بالإضافة إلى قيمتَي OtherType وValue. يعرض الجدول التالي القيم المحتملة لهذه العناصر:
OtherType |
أمثلة على القيم | الوصف |
|---|---|---|
jurisdiction-id |
gpu1 |
تمثّل jurisdiction-id نهائيًا. استخدِم السمة JurisdictionId بدلاً من ذلك |
legislative-session |
116th United States Congress |
|
office-level |
Country |
يجب أن تكون قيمة من
OfficeLevel.
في حال عدم انطباق أي من هذه القيم، يُرجى التواصل مع جهة الاتصال في Google.
office-level نهائيًا. استخدِم السمة OfficeLevel بدلاً من ذلك |
office-role |
upper house |
يجب أن تكون القيمة من
office-role نهائيًا. استخدِم السمة OfficeRole بدلاً من ذلك |
office-seat |
Position 1، Seat 2،
unexpired، special،
Seat 2 special |
استخدِم هذه السمة للتمييز بين المكاتب التي تضم مقاعد أو مناصب متعددة، وكذلك للمكاتب التي لا تتبع أي منطقة جغرافية والمكاتب التي لم تنتهِ مدتها. office-seat نهائيًا.
يُرجى تقديم هذه المعلومات باستخدام السمة Seat في
Contest بدلاً من ذلك.
ملاحظة:
|
أمثلة
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>