دفتر

Office برای تعریف یک دفتر و اطلاعات مرتبط با رقابت آن استفاده کنید. یک دفتر با حوزه انتخابیه و نقش دفتری آن مشخص می‌شود.

عنصر Office برای همه انواع فید اعمال می‌شود، اما نیازی به مشخص کردن آن برای همه‌پرسی‌ها نیست.

برای کسب اطلاعات بیشتر در مورد نحوه استفاده Office با آن نوع فید، یکی از انواع فید زیر را انتخاب کنید.

ویژگی‌ها

جدول زیر ویژگی‌های Office را شرح می‌دهد:

ویژگی الزامی است؟ نوع توضیحات
objectId مورد نیاز ID شناسه داخلی منحصر به فردی که توسط عناصر دیگر برای ارجاع به این عنصر استفاده می‌شود.

عناصر

جدول زیر عناصر مربوط به Office را شرح می‌دهد:

عنصر چندگانگی نوع توضیحات
ContactInformation ۰ یا بیشتر ContactInformation اطلاعات تماس مختلف را با دفتر مرتبط می‌کند. اگر این عنصر گنجانده شده است، فقط اطلاعاتی را مشخص کنید که مربوط به خود دفتر باشد، نه نامزد یا صاحب فعلی دفتر.
ElectoralDistrictId۰ یا ۱ IDREF

objectId مربوط به GpUnit که نشان دهنده حوزه انتخابیه است را وارد کنید. برای مثال، برای سناتور ایالات متحده، یک ایالت مانند "آلاسکا" یا برای نماینده ایالات متحده، یک حوزه انتخابیه مانند "حوزه انتخابیه چهاردهم نیویورک" وارد کنید.

برای فید مربوط به صاحب منصب، انتظار داریم به ازای هر کرسی یک Office باشد و ElectoralDistrictId روی منطقه‌ای تنظیم شود که آن شخص را به این سمت انتخاب کرده است.

مثال: انتخابات مجلس قانونگذاری تایوان

  • به هر یک از اعضای مجلس قانونگذاری، بر اساس حوزه انتخابیه‌شان، یک Office متفاوت اختصاص دهید.

مثال دیگر: فید صاحب منصبان سنای ایالات متحده

  • ۱۰۰ شیء Office برای مجلس سنای ایالات متحده فراهم کنید.
ExternalIdentifiers ۱ ExternalIdentifiers

یک شناسه را به دفتر مرتبط می‌کند. یک شناسه پایدار مورد نیاز است. شناسه‌های پایدار برای دفاتر باید در طول دوره‌های تصدی دفتر منحصر به فرد باشند. به عنوان مثال، هر یک از دوره‌های تصدی زیر به یک شناسه پایدار دفتر مجزا نیاز دارند:

  • ریاست جمهوری گروور کلیولند از ۱۸۸۵ تا ۱۸۸۹
  • ریاست جمهوری گروور کلیولند از ۱۸۹۳ تا ۱۸۹۷
  • ریاست جمهوری فرانکلین روزولت از سال ۱۹۳۳ تا ۱۹۴۵

عنصر ExternalIdentifiers در Office به شما امکان می‌دهد اطلاعات بیشتری با مقادیر خاص برای OtherType ارائه دهید. برای جزئیات بیشتر، به بخش انواع اضافی برای ExternalIdentifiers مراجعه کنید.

GovernmentBodyIds ۰ یا ۱ IDREFS objectId GovernmentBody که این دفتر بخشی از آن است را ارائه دهید. به عنوان مثال، سنای ایالات متحده برای یک سناتور آمریکایی
Name ۱ InternationalizedText نام کامل عنوان عمومی این دفتر را ارائه می‌دهد. این باید شامل حوزه قضایی دفتر باشد اما هرگونه اطلاعات مربوط به حوزه انتخاباتی را شامل نمی‌شود.

مثال‌ها:

  • نماینده پارلمان سنگاپور
  • نخست وزیر هند
  • رئیس جمهور اندونزی
  • سناتور ایالات متحده
JurisdictionId ۰ یا ۱ IDREF

objectId مربوط به GpUnit را که حوزه قضایی دفتر را مشخص می‌کند، ارائه دهید.

Level ۰ یا ۱ OfficeLevel

نوع طبقه بندی شده دفتر. برای لیست کامل گزینه ها به مرجع مراجعه کنید.

Role ۰ یا بیشتر OfficeRole نوع نقش ذکر شده در دفتر، مانند cabinet member یا president . برای مشاهده همه گزینه‌های ممکن به مرجع مراجعه کنید.
OfficeHolderPersonIds ۱ IDREFS

objectId Person که این سمت را بر عهده دارد، ارائه دهید.

SeatStatus ۰ یا ۱ SeatStatus نوع شمارشی وضعیت صندلی (SeatStatus) صاحب دفتر، مانند active یا on-leave . اگر هیچ وضعیت صندلی (SeatStatus) مشخص نشده باشد، مقدار پیش‌فرض active است.
SelectionMethod ۰ یا بیشتر OfficeSelectionMethod اطلاعات مربوط به نحوه انتخاب یا انتصاب صاحب منصب.
Term۱ Term اطلاعات مربوط به دوره تصدی را ارائه می‌دهد.

انواع اضافی برای شناسه‌های خارجی

در عنصر ExternalIdentifiers از Office ، داده‌های اضافی با Type other به همراه مقادیر OtherType و Value ارائه دهید. جدول زیر مقادیر ممکن برای این عناصر را نشان می‌دهد:

OtherType مقادیر مثال توضیحات
jurisdiction-id gpu1

objectId مربوط به GpUnit که حوزه قضایی دفتر را مشخص می‌کند.

government-body United States Senate به GovernmentBody مراجعه کنید.
legislative-session 116th United States Congress
office-level Country باید مقداری از OfficeLevel باشد. اگر هیچ کدام صدق نمی‌کند، با مخاطب گوگل خود تماس بگیرید.
office-role upper house

باید مقداری از OfficeRole باشد. اگر هیچ کدام صدق نمی‌کرد، با مخاطب گوگل خود تماس بگیرید.

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>