人物

使用 Person 實體定義人物資訊。該人士可能是候選人、選舉官員或報表單位的主管機關。ElectionReport 元素包含 PersonCollection,而 PersonCollection 則包含這個動態饋給中的完整 Person 物件集合。這些 Person 物件會在 CandidateGpUnit 中參照。PersonCollection 可選擇加入 ContactInformation,用於關聯聯絡資訊。

屬性

下表說明 Person 元素的屬性:

屬性 必填與否 類型 說明
objectId 必填 ID 其他元素用來參照此元素的專屬內部 ID。

元素

下表說明 Person 的元素:

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

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

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

如果您加入人物圖片,請使用 candidate-image 註解為 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
LastName 0 或 1 string 該人的姓氏。
MiddleName 0 個以上 string 使用者中間名。
Nickname 0 或 1 string 如果使用者有常用的別名,則會顯示與該使用者相關的暱稱。
PartyId 須為 1 以上 IDREF Party 元素的專屬 ID。將政黨與人物建立關聯。請提供此人相關聯的 Party objectId
Prefix 0 或 1 string 與該人相關的前置字串,例如「先生」或「博士
Profession 0 或 1 InternationalizedText 使用者的職業。
Suffix 0 或 1 string 與該人物相關的後綴,例如「Jr.」
Title 0 或 1 InternationalizedText 與人物相關的頭銜。

範例

XML

    <Person objectId="P12321">
      <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>stable-pers-P12321</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>

JSON

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