Biuro

Użyj elementu Office, aby zdefiniować urząd i informacje powiązane z konkursem. Urząd jest identyfikowany przez okręg wyborczy i rolę.

Element Office dotyczy wszystkich typów plików danych, ale nie trzeba go określać w przypadku referendów.

Aby dowiedzieć się więcej o tym, jak używać elementu Office z danym typem pliku danych, wybierz jeden z tych typów:

Atrybuty

W tabeli poniżej opisano atrybuty elementu Office:

Atrybut Wymagany? Typ Opis
objectId Wymagane ID Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu.

Elementy

W tabeli poniżej opisano elementy elementu Office:

Element Mnogość Typ Opis
ContactInformation 0 lub więcej ContactInformation Łączy różne informacje kontaktowe z urzędem. Jeśli ten element jest uwzględniony, podaj tylko informacje związane z samym urzędem, a nie z kandydatem ani osobą sprawującą urząd.
DiplomatReceivingStateId 0 lub 1 IDREF

Podaj objectId elementu GpUnit , który określa stan przyjmujący urząd dyplomatyczny.
DiplomatSendingStateId 0 lub 1 IDREF

Podaj objectId elementu GpUnit który określa stan wysyłający urząd dyplomatyczny.
ElectoralDistrictId 0 lub 1 IDREF

Podaj objectId elementu GpUnit, który reprezentuje okręg wyborczy. Na przykład w przypadku senatora USA podaj stan, np. „Alaska”, a w przypadku przedstawiciela USA – okręg, np. „14. okręg wyborczy Nowego Jorku”.

Atrybut

W przypadku pliku danych o osobach sprawujących urząd oczekujemy 1 elementu Office na każde stanowisko oraz atrybutu ElectoralDistrictId ustawionego na okręg, w którym dana osoba została wybrana na urząd.

Przykład: wybory parlamentarne na Tajwanie

  • Każdemu członkowi Yuanu Ustawodawczego przypisz inny element Office, na podstawie okręgu.

Inny przykład: plik danych o osobach sprawujących urząd w Senacie USA

  • Podaj 100 obiektów Office dla Senatu USA.
ExternalIdentifiers 1 ExternalIdentifiers

Łączy identyfikator z urzędem. Wymagany jest stabilny identyfikator. Stabilne identyfikatory urzędów muszą być unikalne w przypadku kadencji. Na przykład każda z tych kadencji wymaga innego stabilnego identyfikatora urzędu:

  • prezydentura Grovera Clevelanda w latach 1885–1889,
  • prezydentura Grovera Clevelanda w latach 1893–1897,
  • prezydentura Franklina Roosevelta w latach 1933–1945.

Element ExternalIdentifiers elementu Office umożliwia podanie dodatkowych informacji z określonymi wartościami OtherType. Więcej informacji znajdziesz w artykule Dodatkowe typy elementu ExternalIdentifiers.
GovernmentBodyIds 0 lub 1 IDREFS Podaj objectId elementu GovernmentBody, którego częścią jest ten urząd. Na przykład Senat Stanów Zjednoczonych w przypadku senatora USA.
Name 1 InternationalizedText Podaje pełną nazwę ogólnego tytułu tego urzędu. Musi ona zawierać jurysdykcję urzędu, ale nie może zawierać żadnych informacji związanych z okręgiem wyborczym.

Przykłady:

  • członek parlamentu Singapuru,
  • premier Indii,
  • prezydent Indonezji,
  • senator Stanów Zjednoczonych.
JurisdictionId 0 lub 1 IDREF

Podaj objectId elementu GpUnit , który określa jurysdykcję urzędu.
Level 0 lub 1 OfficeLevel

Wyliczeniowy typ poziomu urzędu. Pełną listę opcji znajdziesz w dokumentacji.
Role 0 lub więcej OfficeRole Wyliczeniowy typ roli urzędu, np. cabinet member lub president. Wszystkie możliwe opcje znajdziesz w dokumentacji.
OfficeHolderPersonIds 1 IDREFS

Podaj objectId elementu Person , który sprawuje ten urząd.
SeatStatus 0 lub 1 SeatStatus Wyliczeniowy typ stanu stanowiska osoby sprawującej urząd, np. active lub on-leave. Jeśli nie określono stanu stanowiska, domyślna wartość to active
SelectionMethod 0 lub więcej OfficeSelectionMethod Informacje o tym, jak osoba sprawująca urząd jest wybierana lub powoływana na urząd.
Term 1 Term Zawiera informacje związane z kadencją urzędu.

Dodatkowe typy elementu ExternalIdentifiers

W elemencie ExternalIdentifiers elementu Office podaj dodatkowe dane z wartością Type równą other oraz wartościami OtherType i Value. W tabeli poniżej znajdziesz możliwe wartości tych elementów:

OtherType Przykładowe wartości Opis
jurisdiction-id gpu1

objectId elementu GpUnit, który określa jurysdykcję urzędu.
legislative-session 116th United States Congress
office-level Country Musi to być wartość z OfficeLevel. Jeśli żadna z nich nie pasuje, skontaktuj się z osobą kontaktową w Google.
office-role upper house

Musi to być wartość z OfficeRole. Jeśli żadna z nich nie pasuje, skontaktuj się z osobą kontaktową w Google.
office-seat Position 1, Seat 2, unexpired, special, Seat 2 special

Użyj tego elementu, aby odróżnić urzędy z wieloma stanowiskami lub pozycjami, i urzędy z nieograniczoną liczbą stanowisk i urzędy, których kadencja nie wygasła.

Przykłady

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>