人物

使用 Person 實體定義人員相關資訊。該人員可能是候選人、選舉官員或報表單位的授權人員。ElectionReport 元素包含 PersonCollection,其中含有這個動態消息中的完整 Person 物件集。這些 Person 物件會參照 CandidateGpUnitPersonCollection可選擇性ContactInformation加入聯絡資訊。

屬性

下表說明 Person 元素的屬性:

屬性 是否必要? 類型 說明
objectId 必填 ID 其他元素用來參照這個元素的專屬內部 ID。

元素

下表說明 Person 的元素:

元素 多重性 類型 說明
ContactInformation 0 以上 ContactInformation

將聯絡資訊與使用者建立關聯。

這必須包含註解 URI,並以 wikipedia 註解,且指定人物的標準維基百科頁面 (如有)。請一併提供任何其他已知的個人社群媒體 URI 或網站。這項資訊必須是該人員的個人資訊,而非辦公室或部門的資訊。

DateOfBirth 0 或 1 PartialDate 該人員的出生日期。
ExternalIdentifiers 1 ExternalIdentifiers 將 ID 與使用者建立關聯。必須提供穩定 ID
FirstName 0 或 1 string 使用者的名字。
FullName 1 InternationalizedText 該人員的全名。如要瞭解如何處理多種語言的全名,請參閱「當地語言內容」。
Gender 0 或 1 string

使用者的性別。Gender 可用的值如下:

  • 男性:mmaleman
  • 女性:ffemalewoman
  • 其他性別:oxothernonbinary
ImageUri 0 以上 AnnotatedUri 可直接連結至個人圖片的 URI。圖片必須授權第三方使用。
LastName 0 或 1 string 使用者的姓氏。
MiddleName 0 以上 string 使用者的別名。
Nickname 0 或 1 string 如果該人物有廣為人知的別名,則為與該人物相關聯的暱稱。
PartyId 須為 1 以上 IDREF Party 元素的專屬 ID。將政黨與該名人士建立關聯。提供與這個人相關聯的 PartyobjectId
Prefix 0 或 1 string 與該人員相關的前置字串,例如「先生」或「博士」
Profession 0 或 1 InternationalizedText 使用者的職業。
Suffix 0 或 1 string 與該人員相關的後綴,例如「Jr.」
Title 0 或 1 InternationalizedText 與該人員相關的職稱。

範例

XML

    <Person objectId="per-12321">
      <ContactInformation>
        <Uri Annotation="candidate-image">https://example.come/candidates/ayron-silva.jpg</Uri>
        <Uri Annotation="official-facebook">https://fb.com/ayronsilvasample/</Uri>
        <Uri Annotation="official-instagram">https://www.instagram.com/ayron_silva_sample/</Uri>
        <Uri Annotation="official-twitter">https://twitter.com/ayronsilvasample</Uri>
        <Uri Annotation="official-website">https://ayron-silva-sample.com/</Uri>
        <Uri Annotation="official-youtube">https://www.youtube.com/user/ayron831/featured</Uri>
        <Uri Annotation="wikipedia">https://en.wikipedia.org/wiki/Ayron-Silva-Sample</Uri>
        <Uri Annotation="wikipedia">https://zh.wikipedia.org/zh/%E8%94%A1%E8%8B%B1%E6%96%87</Uri>
        <Uri Annotation="campaign">https://ayronsilvacampaign.com</Uri>
      </ContactInformation>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>per-12321</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FullName>
        <Text language="pt">Ayrton Silva</Text>
        <Text language="en">Ayrton Silva</Text>
        <Text language="hi">एर्टन सेना</Text>
        <Text language="ja">アイルトン・シルバ</Text>
      </FullName>
      <DateOfBirth>1960-01-01</DateOfBirth>
      <Gender>M</Gender>
      <LastName>Silva</LastName>
      <PartyId>par-dpp</PartyId>
      <PartyId>par-exp</PartyId>
    </Person>