候选人

使用 Candidate 描述有关竞选候选人的信息。答 Candidate 可以由 CandidateSelection 实体。

请选择以下 Feed 类型之一，以详细了解如何使用 Candidate与该类型的 Feed 相关联。

<ph type="x-smartling-placeholder"></ph>

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

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

在本例中，候选定位设置 1 和候选定位设置 2 重复。这两项比赛都需要 引用同一个 Candidate。一般来说，不要将某位候选人 进行不相关的竞赛

属性

下表显示了 Candidate 的属性：

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

元素

下表显示了 Candidate 的元素：

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

你问候选人或其竞选时看到的标语 他们的广告系列标语是什么请参阅这些来自 2020 年美国的示例 总统选举：

  • 乔·拜登的宣传口号：“Our Best Days Still Lie Ahead.”
  • Donald Trump 的宣传口号：“Make America Great Again”
ContactInformation 0 或更多 ContactInformation 将竞选总部地址、电话号码等与候选人信息相关联。
ExternalIdentifiers 1 ExternalIdentifiers 将 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>
      <PartyId>par-0002</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","par-0002"]
            "PersonId": "per-001-kenyatta",
            "PostElectionStatus": "projected-winner",
            "PreElectionStatus": "qualified"
          }
      ]