از Office
برای تعریف دفتر و اطلاعات مرتبط با مسابقه آن استفاده کنید. یک دفتر بر اساس حوزه انتخاباتی و نقش دفتر آن مشخص می شود.
عنصر 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 | نام کامل عنوان عمومی این دفتر را ارائه می دهد. این باید شامل حوزه قضایی دفتر باشد، اما هرگونه اطلاعات مربوط به حوزه انتخاباتی را حذف نمی کند. مثال ها:
|
OfficeHolderPersonIds | 1 | IDREFS | |
SeatStatus | 0 یا 1 | SeatStatus | نوع برشماری شده از وضعیت صندلی صاحب دفتر، مانند active یا on-leave . اگر SeatStatus مشخص نشده باشد، مقدار پیشفرض active است. |
SelectionMethod | 0 یا 1 | OfficeSelectionMethod | اطلاعاتی در مورد نحوه انتخاب یا قرار گرفتن صاحب دفتر. |
Term | 1 | Term | اطلاعات مربوط به دوره اداری را ارائه می دهد. |
انواع اضافی برای شناسه های خارجی
در عنصر ExternalIdentifiers
Office
، داده های اضافی را با Type
of 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"> <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>stable-off0</Value> </ExternalIdentifier> <ExternalIdentifier> <Type>other</Type> <OtherType>office-level</OtherType> <Value>Administrative Area 1</Value> </ExternalIdentifier> <ExternalIdentifier> <Type>other</Type> <OtherType>office-role</OtherType> <Value>upper house</Value> </ExternalIdentifier> <ExternalIdentifier> <Type>other</Type> <OtherType>jurisdiction-id</OtherType> <Value>ru-gpu0</Value> </ExternalIdentifier> </ExternalIdentifiers> <GovernmentBodyIds>gb-1</GovernmentBodyIds> <Name> <Text language="en">United States Senator</Text> </Name> <OfficeHolderPersonIds>per0</OfficeHolderPersonIds> <SelectionMethod>directly-elected</SelectionMethod> <Term> <StartDate>2019-01-02</StartDate> </Term> </Office>
JSON
"Office": [ { "objectId": "off0", "ElectoralDistrictId": "ru-gpu0", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "stable-off0" }, { "Type": "other", "OtherType": "office-level", "Value": "Administrative Area 1" }, { "Type": "other", "OtherType": "office-role", "Value": "upper house" }, { "Type": "other", "OtherType": "jurisdiction-id", "Value": "ru-gpu0" } ] } "GovernmentBodyIds": ["gb-1] "Name": { "Text": [ { "value": "United States Senator", "language": "en" } ] } "OfficeHolderPersonIds": "per0" "SelectionMethod": "directly-elected" "Term": { "StartDate": "2019-01-02" } } ]