Ứng cử viên

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

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 những loại cuộc thi liên quan này, một Person chỉ được tham chiếu bởi một Candidate. Hãy xem các ví dụ sau đây:

  • Trong một cuộc tranh cử cấp tiểu bang tạo nên một cuộc tranh cử cấp quốc gia, Người 1 được Ứng cử viên 1 tham chiếu.
  • Tuy nhiên, trong một cuộc thi khác ở cấp tiểu bang thuộc cùng một cuộc thi cấp quốc gia, Người 1 được Ứng cử viên 2 tham chiếu.

hoặc:

  • 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, trong Vòng 2, Người 1 được Ứng viên 2 tham chiếu.

Trong những trường hợp này, Ứng viên 1 và Ứng viên 2 là các địa điểm trùng lặp. 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 tranh cử không liên quan.

Thuộc tính

Bảng sau đây cho biết 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 Giá trị nhận dạng nội bộ duy nhất mà các phần tử khác sử dụng để tham chiếu đến phần tử này.

Phần tử

Bảng sau đây trình bày các phần tử cho 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 ghi trên lá phiế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ụ sau đâ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 0 trở lên ContactInformation Liên kết địa chỉ, số điện thoại, v.v. của trụ sở chiến dịch 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ó một giá trị nhận dạng ổn định.
FileDate 0 hoặc 1 PartialDate Ngày ứng cử viên chính thức nộp đơn tranh cử.
IsIncumbent 0 hoặc 1 boolean Giá trị true cho biết ứng cử viên là người đương nhiệm của chức vụ liên quan đến cuộc tranh cử. Nếu không có phần tử này, thì giá trị mặc định là false.
IsNotable 0 hoặc 1 boolean Liệu thực thể có được coi là đáng chú ý hay không. Giả định là false nếu không được chỉ định.
IsTopTicket 0 hoặc 1 boolean Cho biết liệu ứng cử viên có phải là người đứng đầu trong một danh sách gồm nhiều ứng cử viên hay không. Chỉ thêm phần tử này khi có nhiều hơn một Candidate trong một đối tượng CandidateSelection. Nếu không có phần tử này, thì giá trị mặc định là false.
PartyId 1 trở lên IDREF Giá trị nhận dạng riêng biệt cho 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ọ.
PartyLabel 0 hoặc 1 InternationalizedText Văn bản có thể xuất hiện bên cạnh tên của một ứng cử viên trên lá phiếu với tư cách là đảng của họ, nhưng không phải là một đảng đủ điều kiện xuất hiện trên lá phiếu (đối với những nơi cho phép điều này).
PersonId 1 IDREF Giá trị nhận dạng riêng biệt cho một phần tử Person. 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 advanced-to-runoff.
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 ExternalIdentifiers khác

Trong phần tử ExternalIdentifiers của Candidate, hãy cung cấp thêm dữ liệu có 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ử.
tse-candidate-number 12345

Không bắt buộc

Trong các cuộc bầu cử ở Brazil, số của ứng cử viên do Toà án bầu cử cấp cao (Tribunal Superior Eleitoral – TSE) cấp.

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-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>