دفتر کار

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

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

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

مشخصه‌ها

جدول زیر مشخصه‌های Office را شرح می‌دهد:

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

عناصر

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

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

objectId مربوط به GpUnit را که ایالت پذیرنده دفتر دیپلماتیک را مشخص می‌کند ارائه دهید.
DiplomatSendingStateId ‫۰ یا ۱ IDREF

objectId مربوط به GpUnit را ارائه دهید که وضعیت ارسال را برای دفتر دیپلماتیک مشخص می‌کند.
ElectoralDistrictId 0 یا 1 IDREF

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

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

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

  • به هر عضو «یوان قانون‌گذاری» براساس حوزه انتخاباتی‌اش Office متفاوتی بدهید.

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

  • ‫۱۰۰ شیء Office برای سنای ایالات متحده ارائه دهید.
ExternalIdentifiers 1 ExternalIdentifiers

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

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

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

مثال‌ها:

  • عضو پارلمان سنگاپور
  • نخست‌وزیر هند
  • رئیس‌جمهور اندونزی
  • سناتور ایالات متحده
JurisdictionId 0 یا 1 IDREF

objectId GpUnit را که حوزه قضایی دفتر را مشخص می‌کند ارائه دهید.
Level 0 یا 1 OfficeLevel

نوع شمارشی سطح دفتر. برای مشاهده فهرست کامل گزینه‌ها، مرجع را ببینید.
Role ۰ یا بیشتر OfficeRole نوع شمارشی «نقش» دفتر، مثل cabinet member یا president. برای دیدن همه گزینه‌های ممکن، مرجع را ببینید.
OfficeHolderPersonIds 1 IDREFS

objectId Person که این منصب را دارد ارائه دهید.

‫
SeatStatus 0 یا 1 SeatStatus نوع شمارشی «وضعیت کرسی» دارنده منصب، مثل active یا on-leave. اگر SeatStatus مشخص نشده باشد، مقدار پیش‌فرض active است. ‫
SelectionMethod ۰ یا بیشتر OfficeSelectionMethod اطلاعات مربوط به نحوه انتخاب یا قرارگیری دارنده دفتر در دفتر.
Term ‫۱ Term اطلاعات مربوط به دوره تصدی را ارائه می‌دهد.

انواع دیگر برای ExternalIdentifiers

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

OtherType مقادیر نمونه شرح
jurisdiction-id gpu1

objectId مربوط به GpUnit که حوزه قضایی دفتر را مشخص می‌کند.
legislative-session 116th United States Congress
office-level Country باید مقداری از OfficeLevel باشد. اگر هیچ‌کدام از این موارد صدق نمی‌کند، با مخاطب Google خود تماس بگیرید.
office-role upper house

باید مقداری از OfficeRole باشد. اگر هیچ‌کدام از این موارد صدق نمی‌کند، با مخاطب Google خود تماس بگیرید.
office-seat ‫Position 1،‏ Seat 2،‏ unexpired،‏ special،‏ Seat 2 special

از این برای متمایز کردن دفاتر دارای چند کرسی یا موقعیت، و برای دفاتر بدون محدودیت و منقضی‌نشده استفاده کنید.

مثال‌ها

XML

    <Office objectId="off-0">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>off-0</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>