Candidate

使用 Candidate 描述竞赛中候选人的相关信息。Candidate 可由 CandidateSelection 实体引用。

选择以下 Feed 类型之一，详细了解如何将 Candidate 与该类型的 Feed 搭配使用。

有些选举由多个较小的竞选活动组成，或涉及一系列后续竞选活动。在这类相关竞选中，一个 Person 只能由一个 Candidate 引用。请参考以下示例：

  • 在构成全国竞选的州竞选中，候选人 1 引用了人员 1。
  • 不过，在构成同一全国性竞选活动的另一个州级竞选活动中，候选人 2 引用了人员 1。

或者：

  • 在波兰选举的第一轮中，候选人 1 引用了人物 1。
  • 不过，在第 2 轮中，候选人 2 引用了人员 1。

在这些情况下，候选 1 和候选 2 是重复的。两场比赛都需要引用相同的 Candidate。一般来说，不要将候选人纳入多个不相关的竞选。

属性

下表显示了 Candidate 的属性：

属性 是否必需？ 类型 说明
objectId 必填 ID 其他元素用于引用此元素的唯一内部标识符。

元素

下表显示了 Candidate 的元素：

元素 多样性 类型 说明
BallotName 1 InternationalizedText 提供候选人在选票上列出的姓名。
CampaignSlogan 0 或 1 InternationalizedText

您在询问候选人或其竞选团队时得到的竞选口号。请参阅 2020 年美国总统大选中的以下示例：

  • Joe Biden 的口号：“Our Best Days Still Lie Ahead”（我们的美好未来还在后头）。
  • 唐纳德·特朗普的口号：“让美国再次伟大。”
ContactInformation 0 个或更多 ContactInformation 将竞选总部地址、电话号码等信息与候选人信息相关联。
ExternalIdentifiers 1 ExternalIdentifiers 将 ID 与候选人相关联。需要稳定标识符。
FileDate 0 或 1 PartialDate 候选人正式提交竞选申请的日期。
IsIncumbent 0 或 1 boolean 值为 true 表示候选人是与竞选相关的职位的现任者。如果此元素不存在，则默认值为 false。
IsNotable 0 或 1 boolean 实体是否被视为值得注意。如果未指定，则假定为 false。
IsTopTicket 0 或 1 boolean 指明候选人是否是包含多位候选人的选票中的首位候选人。仅当 CandidateSelection 对象中有多个 Candidate 时，才添加此元素。 如果此元素不存在，则默认值为 false。
PartyId 1 个或更多 IDREF Party 元素的唯一标识符。用于将候选人与其所属政党相关联。
PartyLabel 0 或 1 InternationalizedText 在选票上可以显示在候选人姓名旁边作为其政党，但并非符合选票资格的政党的文本（适用于允许这样做的地区）。
PersonId 1 IDREF Person 元素的唯一标识符。用于关联有关候选人的更详细信息。
PostElectionStatus 0 或 1 CandidatePostElectionStatus 候选版本的最终状态，例如 winner 或 advanced-to-runoff。
PreElectionStatus 0 或 1 CandidatePreElectionStatus 候选人的注册状态，例如 filed 或 qualified。

ExternalIdentifiers 的其他类型

在 Candidate 的 ExternalIdentifiers 元素中，提供 Type 为 other 的其他数据，以及 OtherType 和 Value 的值。下表显示了这些元素的可能值：

OtherType 示例值 说明
electoral-commission H2NY22097

可选

选举委员会 ID。
tse-candidate-number 12345

可选

在巴西选举中，由高级选举法院 (Tribunal Superior Eleitoral - TSE) 签发的候选人编号。

示例

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-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>
      <PartyId>par-0002</PartyId>
      <PersonId>per-001-kenyatta</PersonId>
      <PostElectionStatus>projected-winner</PostElectionStatus>
      <PreElectionStatus>qualified</PreElectionStatus>
    </Candidate>