Ứng cử viên

Sử dụng Candidate để mô tả thông tin về một ứng cử viên trong cuộc thi. CandidateSelection có thể tham chiếu đến Candidate.

Chọn một trong các loại nguồn cấp dữ liệu sau để tìm hiểu thêm về cách sử dụng Candidate với loại nguồn cấp dữ liệu đó.

Một số cuộc bầu cử bao gồm nhiều cuộc tranh cử nhỏ hơn hoặc liên quan đến một loạt cuộc tranh cử tiếp theo. Trong các cuộc thi có liên quan như vậy, chỉ một Candidate được phép tham chiếu đến một Person. Hãy xem ví dụ sau đây:

  • Trong Vòng 1 của một cuộc bầu cử ở Ba Lan, Người 1 được Ứng cử viên 1 nhắc đến.
  • Tuy nhiên, ở Vòng 2, Người 1 được Ứng cử viên 2 tham chiếu.

Trong trường hợp này, Ứng viên 1 và Ứng viên 2 là các bản sao. Cả hai cuộc thi đều cần tham chiếu đến cùng một Candidate. Nhìn chung, đừng đưa một ứng cử viên vào nhiều cuộc thi không liên quan.

Thuộc tính

Bảng sau đây cho thấy các thuộc tính của Candidate:

Thuộc tính Bắt buộc? Loại Mô tả
objectId Bắt buộc ID Mã nhận dạng nội bộ duy nhất mà các phần tử khác dùng để tham chiếu phần tử này.

Thành phần

Bảng sau đây cho thấy các phần tử của Candidate:

Phần tử Số bội Loại Mô tả
BallotName 1 InternationalizedText Cung cấp tên của ứng cử viên như tên được liệt kê trên phiếu bầu.
CampaignSlogan 0 hoặc 1 InternationalizedText

Khẩu hiệu mà bạn nhận được khi hỏi một ứng cử viên hoặc chiến dịch của họ về khẩu hiệu của chiến dịch. Hãy xem những ví dụ này trong cuộc bầu cử tổng thống Hoa Kỳ năm 2020:

  • Khẩu hiệu của Joe Biden: "Những ngày tươi đẹp nhất vẫn còn ở phía trước".
  • Khẩu hiệu của Donald Trump: "Làm cho nước Mỹ vĩ đại trở lại".
ContactInformation Từ 0 trở lên ContactInformation Liên kết địa chỉ trụ sở chiến dịch, số điện thoại, v.v. với thông tin của ứng cử viên.
ExternalIdentifiers 1 ExternalIdentifiers Liên kết một mã nhận dạng với ứng viên. Bạn phải có giá trị nhận dạng ổn định.
FileDate 0 hoặc 1 PartialDate Ngày mà ứng cử viên chính thức đăng ký tham gia cuộc bầu cử.
IsIncumbent 0 hoặc 1 boolean Giá trị true cho biết ứng cử viên là người đang nắm giữ chức vụ liên quan đến cuộc tranh cử. Nếu không có phần tử này, giá trị mặc định sẽ là false.
IsNotable 0 hoặc 1 boolean Liệu thực thể có được coi là đáng chú ý hay không. Được giả định là false nếu bạn không chỉ định.
IsTopTicket 0 hoặc 1 boolean Cho biết liệu đề xuất có phải là đề xuất hàng đầu trong một vé có nhiều đề xuất hay không. Chỉ thêm phần tử này khi có nhiều Candidate trong một đối tượng CandidateSelection. Nếu không có phần tử này, giá trị mặc định sẽ là false.
PartyId 1 trở lên IDREF Giá trị nhận dạng riêng biệt của một phần tử Party. Dùng để liên kết một ứng cử viên với đảng phái chính trị của họ.
PersonId 1 IDREF Giá trị nhận dạng riêng biệt của một phần tử Person. Được dùng để liên kết thông tin chi tiết hơn về ứng viên.
PostElectionStatus 0 hoặc 1 CandidatePostElectionStatus Trạng thái cuối cùng của ứng viên, chẳng hạn như winner hoặc withdrawn.
PreElectionStatus 0 hoặc 1 CandidatePreElectionStatus Trạng thái đăng ký của ứng cử viên, chẳng hạn như filed hoặc qualified.

Các loại khác cho ExternalIdentifiers

Trong phần tử ExternalIdentifiers của Candidate, hãy cung cấp thêm dữ liệu bằng Type là other, cùng với các giá trị cho OtherType và Value. Bảng sau đây cho thấy các giá trị có thể có cho những phần tử này:

OtherType Giá trị mẫu Mô tả
electoral-commission H2NY22097

Không bắt buộc

Mã nhận dạng của uỷ ban bầu cử.

Ví dụ

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"
          }
      ]