使用 Person
實體定義人物資訊。該人士可能是候選人、選舉官員或報表單位的主管機關。ElectionReport
元素包含 PersonCollection
,而 PersonCollection
則包含這個動態饋給中的完整 Person
物件集合。這些 Person
物件會在 Candidate
和 GpUnit
中參照。PersonCollection
可選擇加入 ContactInformation
,用於關聯聯絡資訊。
屬性
下表說明 Person
元素的屬性:
屬性 | 必填與否 | 類型 | 說明 |
---|---|---|---|
objectId |
必填 | ID |
其他元素用來參照此元素的專屬內部 ID。 |
元素
下表說明 Person
的元素:
元素 | 多重性 | 類型 | 說明 |
---|---|---|---|
ContactInformation |
0 個以上 | ContactInformation |
將聯絡資訊與使用者建立關聯。 這必須包含註解 URI,並以 如果您加入人物圖片,請使用 |
DateOfBirth
|
0 或 1 | PartialDate |
使用者出生日期。 |
ExternalIdentifiers |
1 | ExternalIdentifiers |
將 ID 與使用者相關聯。必須提供穩定 ID。 |
FirstName |
0 或 1 | string |
使用者名字。 |
FullName |
1 | InternationalizedText |
使用者的全名。如要進一步瞭解如何處理多種語言的完整名稱,請參閱「本土語言內容」。 |
Gender |
0 或 1 | string |
使用者的性別。
|
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"] } ]