使用 Candidate
描述有关比赛中候选人的信息。Candidate
可由 CandidateSelection
实体引用。
选择下列 Feed 类型之一,即可详细了解如何将 Candidate
用于该类型的 Feed。
有些选举包含多次小型竞赛或一系列后续竞赛。在这类相关竞赛中,Person
必须仅由一个 Candidate
引用。请参考以下示例:
- 在波兰选举的第 1 轮中,第 1 个人被候选人 1 提及。
- 不过,在第 2 轮中,第 1 个人被候选人 2 提及。
在这种情况下,候选字词 1 和候选字词 2 是重复的。两场比赛都需要引用同一个 Candidate
。一般来说,不要让候选人参与多个不相关的竞赛。
属性
下表显示了 Candidate
的属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
objectId |
必需 | ID |
其他元素用来引用此元素的唯一内部标识符。 |
元素
下表显示了 Candidate
的元素:
元素 | 多样性 | 类型 | 说明 |
---|---|---|---|
BallotName |
1 | InternationalizedText |
提供选票上所列的候选人姓名。 |
CampaignSlogan |
0 或 1 |
InternationalizedText |
当你询问候选人或其竞选时,你获得的宣传口号是什么。以下是 2020 年美国总统选举的标语:
|
ContactInformation |
0 个或更多 | ContactInformation |
将竞选总部地址、电话号码等与候选人信息相关联。 |
ExternalIdentifiers |
1 | ExternalIdentifiers |
将 ID 与候选 ID 相关联。必须提供稳定的标识符。 |
FileDate |
0 或 1 | PartialDate |
候选人正式提交参加竞选的日期。 |
IsIncumbent |
0 或 1 | boolean |
值 true 表示候选人是与竞赛相关的公职人员。如果此元素不存在,则默认值为 false 。
|
IsTopTicket |
0 或 1 | boolean |
指示候选项是否是包含多个候选项的工单的顶部。仅当 CandidateSelection 对象中有多个 Candidate 时,才包含此元素。
如果不存在此元素,则默认值为 false 。 |
PartyId |
1 | IDREF |
Party 元素的唯一标识符。用于将候选人与其政党联系起来。 |
PersonId |
1 | IDREF |
Person 元素的唯一标识符。用于关联关于候选人的更多详细信息。 |
PostElectionStatus |
0 或 1 | CandidatePostElectionStatus |
候选版本的最终状态,例如 winner 或 withdrawn 。 |
PreElectionStatus |
0 或 1 | CandidatePreElectionStatus |
候选人的登记状态,例如 filed 或 qualified 。 |
ExternalIdentifiers 的其他类型
在 Candidate
的 ExternalIdentifiers
元素中,提供其他数据,将 Type
设为 other
,以及 OtherType
和 Value
的值。下表显示了这些元素的可能值:
OtherType | 示例值 | 说明 |
---|---|---|
electoral-commission |
H2NY22097 |
可选 选举委员会 ID。 |
示例
XML
<Candidate objectId="can-1001-kenyatta"> <BallotName> <Text language="en">Uhuru Kenyatta</Text> <Text language="sw">Uhuru Kenyatta</Text> </BallotName> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>can-per-100</Value> </ExternalIdentifier> <ExternalIdentifier> <Type>other</Type> <OtherType>electoral-commission</OtherType> <Value>H2NY22097</Value> </ExternalIdentifier> </ExternalIdentifiers> <IsIncumbent>1</IsIncumbent> <IsTopTicket>1</IsTopTicket> <PartyId>par-jubilee</PartyId> <PersonId>per-001-kenyatta</PersonId> <PostElectionStatus>projected-winner</PostElectionStatus> <PreElectionStatus>qualified</PreElectionStatus> </Candidate>
JSON
"Candidate": [ { "objectId": "can-1001-kenyatta", "BallotName": { "Text": [ { "value": "Uhuru Kenyatta", "language": "en" }, { "value": "Uhuru Kenyatta", "language": "sw" } ] }, "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "can-per-100" }, { "Type": "other", "OtherType": "electoral-commission", "Value": "H2NY22097" }, ] } "IsIncumbent": 1, "IsTopTicket": 1, "PartyId": "par-jubilee", "PersonId": "per-001-kenyatta", "PostElectionStatus": "projected-winner", "PreElectionStatus": "qualified" } ]