Trang này được dịch bởi Cloud Translation API.

Biểu ngữ

Sử dụng BallotSelection để xác định các lựa chọn phiếu bầu trong một cuộc thi, chẳng hạn như khi bạn liên kết các ứng cử viên và đảng chính trị với thông tin về số phiếu bầu của họ.

Tài liệu này thảo luận về BallotSelection và các thực thể phụ của tài liệu này:

BallotSelection
- CandidateSelection
- PartySelection
- BallotMeasureSelection

Chọn một trong các loại nguồn cấp dữ liệu sau đây để tìm hiểu thêm về cách sử dụng BallotSelection và các thành phần vốn có của loại nguồn cấp dữ liệu đó.

BallotSelection

BallotSelection là một phần tử trừu tượng có 3 loại được sử dụng dựa trên loại cuộc thi:

CandidateSelection: Sử dụng type này của BallotSelection khi cuộc thi dành cho ít nhất một ứng viên. Quảng cáo này liên kết cuộc bầu chọn được đưa ra Phần tử Candidate.
PartySelection: Sử dụng type này trong tổng số BallotSelection khi loại cuộc thi là dành cho Party, chẳng hạn như cuộc thi đấu theo tỷ lệ.
BallotMeasureSelection: Sử dụng loại BallotSelection để biểu thị các lựa chọn có thể có trong một BallotMeasureContest.

Thuộc tính

Bảng sau đây mô tả các thuộc tính của BallotSelection:

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 được 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 mô tả các phần tử cho BallotSelection:

Phần tử Số bội Loại Mô tả

Phần tử	Số bội	Loại	Mô tả
`SequenceOrder`	0 hoặc 1	`integer`	Chỉ định thứ tự mặc định cho việc chọn phiếu bầu để hiển thị . Nếu `SequenceOrder` không có trong nguồn cấp dữ liệu thì không có đơn đặt hàng nào giả định.

SequenceOrder

0 hoặc 1

integer

Chỉ định thứ tự mặc định cho việc chọn phiếu bầu để hiển thị .

Nếu SequenceOrder không có trong nguồn cấp dữ liệu thì không có đơn đặt hàng nào giả định.

CandidateSelection

Sử dụng CandidateSelection để xác định các lựa chọn phiếu bầu của một ứng cử viên cuộc thi, số lượt đăng ký.

CandidateSelection kế thừa các thuộc tính và các phần tử BallotSelection. Tham chiếu đến nhiều Bạn có thể thêm các phần tử Candidate nếu cần thiết, ví dụ: khi khu vực bỏ phiếu là dành cho một vé của nhiều hình thức ứng cử viên.

Khi có nhiều ứng cử viên được tham chiếu cho một vé, đôi khi điều quan trọng là để duy trì thứ tự của các biến. Trong những trường hợp này, chúng tôi dự kiến đang tạo ứng dụng để liệt kê các tham chiếu đến Phần tử Candidate trong CandidateIds theo sơ đồ sắp xếp tại chỗ. Ví dụ: thứ tự của các đề xuất cần phải khớp với cùng một thứ tự của Tham chiếu phần tử Office trong OfficeIds trong Contest thuộc loại CandidateContest.

Nếu có nhiều đối tượng Candidate được tham chiếu, các đối tượng đó sẽ được hiển thị với người dùng theo thứ tự sau:

Tất cả ứng cử viên có IsTopTicket được đặt thành true đều được sắp xếp trước tất cả các đề xuất không có giá trị IsTopTicket. Các sản phẩm này lần lượt được sắp xếp trước trong tất cả đề xuất có IsTopTicket được đặt thành false. Tốt nhất là bạn nên chọn được đặt với một từ khoá không có giá trị IsTopTicket hoặc ở đó là một cặp ứng cử viên và một trong số đó có IsTopTicket được đặt thành true. Nếu không đáp ứng các điều kiện này, những điều sau đây sẽ xảy ra:
- Tất cả các đề xuất có IsTopTicket được đặt thành true sẽ hiển thị trong một thứ tự không xác định.
- Tất cả ứng cử viên có IsTopTicket không có mặt đều xuất hiện trong một thứ tự không xác định.
- Tất cả các đề xuất có IsTopTicket được đặt thành false sẽ hiển thị trong một thứ tự không xác định.

Cú pháp XML cho CandidateSelection như sau: <BallotSelection xsi:type="CandidateSelection">

Thành phần

Bảng sau đây mô tả các phần tử cho CandidateSelection:

Phần tử	Số bội	Loại	Mô tả
`CandidateIds`	1	`IDREFS`	Giá trị nhận dạng duy nhất của một hoặc nhiều `Candidate` phần tử. Sử dụng để liên kết một ứng cử viên với lựa chọn ứng viên trên phiếu bầu. Cũng hữu ích khi lựa chọn phiếu bầu cho nhiều người ứng cử viên, chẳng hạn như vé xem vé với Tổng thống và Phó Tổng thống được chọn cùng nhau.
`EndorsementPartyIds`	0 trở lên	`IDREFS`	Giá trị nhận dạng duy nhất của hai hoặc nhiều Các thực thể `Party`. Điều này thể hiện một thoả thuận trong đó các đảng phái chính trị đều liệt kê như nhau ứng cử viên trên phiếu bầu.
`IsWriteIn`	0 hoặc 1	`boolean`	Cho biết ứng cử viên có phải là người đăng ký hay không. Giá trị mặc định là `false`.

Ví dụ

XML

    <BallotSelection objectId="cs10861" xsi:type="CandidateSelection">
      <CandidateIds>can10861a can10861b</CandidateIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "CandidateSelection",
        "objectId": "cs10861",
        "CandidateIds": [
          "can10861a",
          "can10861b"
        ]
      }
    ]

PartySelection

Sử dụng PartySelection để xác định các lựa chọn phiếu bầu có liên quan đến một đảng, chẳng hạn như lựa chọn danh sách đảng trên lá phiếu.

PartySelection kế thừa các thuộc tính và phần tử của BallotSelection. Chiến lược phát hành đĩa đơn Cú pháp XML cho PartySelection như sau: <BallotSelection xsi:type="PartySelection" ... />

Thành phần

Bảng sau đây mô tả các phần tử cho PartySelection:

Phần tử	Số bội	Loại	Mô tả
`PartyIds`	1	`IDREFS`	Giá trị nhận dạng duy nhất của một hoặc nhiều `Party` phần tử. Sử dụng để liên kết một hoặc nhiều bên với bên đó lựa chọn.

Ví dụ

XML

    <BallotSelection objectId="ps150" xsi:type="PartySelection">
      <PartyIds>par100</PartyIds>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "PartySelection",
        "objectId": "ps150",
        "PartyIds": [
          "par100"
        ]
      }
    ]

BallotMeasureSelection

Sử dụng BallotMeasureSelection để xác định các lựa chọn phiếu bầu liên quan đến dự luật cần bỏ phiếu, chẳng hạn như trưng cầu dân ý.

BallotMeasureSelection kế thừa các thuộc tính và phần tử của BallotSelection Cú pháp XML cho BallotMeasureSelection như sau: <BallotSelection xsi:type="BallotMeasureSelection" ... />

Thành phần

Bảng sau đây mô tả các phần tử cho BallotMeasureSelection:

Phần tử	Số bội	Loại	Mô tả
`ExternalIdentifiers`	1	`ExternalIdentifiers`	Liên kết giấy tờ tuỳ thân với lựa chọn dự luật cần bỏ phiếu. Đáp giá trị nhận dạng ổn định là trường bắt buộc.
`Selection`	1	`InternationalizedText`	Cung cấp một lựa chọn cho cuộc bỏ phiếu, chẳng hạn như `Yes` hoặc `No`.

Ví dụ

XML

    <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bmc0_yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]

XML

    <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>bmc0_yes</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Selection>
        <Text language="en">Yes</Text>
      </Selection>
    </BallotSelection>

JSON

    "BallotSelection": [
      {
        "@type": "BallotMeasureSelection",
        "objectId": "bms00",
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0_yes"
            }
          ]
        }
        "Text": [
          {
            "value": "Yes",
            "language": "en"
          },
        ]
      }
    ]

Biểu ngữ Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

BallotSelection

Thuộc tính

Thành phần

CandidateSelection

Thành phần

Ví dụ

XML

JSON

PartySelection

Thành phần

Ví dụ

XML

JSON

BallotMeasureSelection

Thành phần

Ví dụ

XML

JSON

XML

JSON

Biểu ngữ