Seleksi

Gunakan BallotSelection untuk mengidentifikasi pilihan surat suara dalam suatu pemilihan, seperti saat Anda menautkan kandidat dan partai dengan jumlah suara mereka.

Dokumen ini membahas BallotSelection dan sub-entitasnya:

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection

Pilih salah satu jenis feed berikut untuk mempelajari lebih lanjut cara menggunakan BallotSelection dan elemen bawaannya dengan jenis feed tersebut.

BallotSelection

BallotSelection adalah elemen abstrak dengan tiga jenis yang digunakan berdasarkan jenis kontes:

Atribut

Tabel berikut menjelaskan atribut untuk BallotSelection:

Atribut Wajib? Jenis Deskripsi
objectId Wajib ID ID internal unik yang digunakan oleh elemen lain untuk merujuk elemen ini.

Elemen

Tabel berikut menjelaskan elemen untuk BallotSelection:

Elemen Keanekaragaman Jenis Deskripsi
SequenceOrder 0 atau 1 integer

Menentukan urutan default untuk pemilihan surat suara untuk tujuan penayangan.

Jika SequenceOrder tidak ada di feed, tidak ada urutan yang diasumsikan.

CandidateSelection

Gunakan CandidateSelection untuk mengidentifikasi pilihan surat suara dalam kontes kandidat, termasuk kandidat yang ditulis.

CandidateSelection mewarisi atribut dan elemen BallotSelection. Referensi ke beberapa elemen Candidate dapat disertakan jika diperlukan, misalnya, saat pemilihan surat suara adalah untuk tiket beberapa kandidat.

Jika beberapa kandidat dirujuk untuk tiket, terkadang penting untuk mempertahankan urutan kandidat. Dalam kasus ini, kami berharap aplikasi yang membuat daftar referensi ke elemen Candidate dalam CandidateIds sesuai dengan skema pengurutan yang ada. Misalnya, urutan kandidat harus cocok dengan urutan yang sama dari referensi elemen Office dalam OfficeIds di Contest jenis CandidateContest.

Jika lebih dari satu objek Candidate dirujuk, objek tersebut akan ditampilkan kepada pengguna dalam urutan berikut:

  • Semua kandidat dengan IsTopTicket yang ditetapkan ke true diurutkan sebelum semua kandidat tanpa nilai IsTopTicket. Selanjutnya, kandidat ini diurutkan di depan semua kandidat dengan IsTopTicket yang ditetapkan ke false. Idealnya, pilihan ditetapkan dengan satu kandidat tanpa nilai IsTopTicket, atau ada sepasang kandidat, dan salah satunya memiliki IsTopTicket yang ditetapkan ke true. Jika kondisi ini tidak terpenuhi, hal berikut akan terjadi:
    • Semua kandidat dengan IsTopTicket yang ditetapkan ke true ditampilkan dalam urutan yang tidak ditentukan.
    • Semua kandidat yang tidak memiliki IsTopTicket ditampilkan dalam urutan yang tidak ditentukan.
    • Semua kandidat dengan IsTopTicket yang ditetapkan ke false ditampilkan dalam urutan yang tidak ditentukan.

Sintaksis XML untuk CandidateSelection adalah sebagai berikut: <BallotSelection xsi:type="CandidateSelection">.

Elemen

Tabel berikut menjelaskan elemen untuk CandidateSelection:

Elemen Keanekaragaman Jenis Deskripsi
CandidateIds 1 IDREFS ID unik untuk satu atau beberapa elemen Candidate. Digunakan untuk mengaitkan kandidat dengan pemilihan kandidat pada surat suara. Juga berguna saat pemilihan surat suara ditujukan untuk beberapa kandidat, seperti tiket dengan Presiden dan Wakil Presiden yang dipilih bersama.
EndorsementPartyIds 0 atau lebih IDREFS ID unik untuk dua atau lebih entitas Party. Hal ini menunjukkan pengaturan di mana partai politik mencantumkan kandidat yang sama dalam surat suara.
IsWriteIn 0 atau 1 boolean Menunjukkan apakah kandidat adalah kandidat dengan surat suara tertulis. Nilai defaultnya adalah false.

Contoh

XML

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

JSON

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

PartySelection

Gunakan PartySelection untuk mengidentifikasi pilihan surat suara yang melibatkan partai, seperti pilihan daftar partai pada surat suara.

PartySelection mewarisi atribut dan elemen BallotSelection. Sintaksis XML untuk PartySelection adalah sebagai berikut: <BallotSelection xsi:type="PartySelection" ... />.

Elemen

Tabel berikut menjelaskan elemen untuk PartySelection:

Elemen Keanekaragaman Jenis Deskripsi
PartyIds 1 IDREFS ID unik untuk satu atau beberapa elemen Party. Gunakan untuk mengaitkan satu atau beberapa pihak dengan pilihan pihak.

Contoh

XML

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

JSON

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

BallotMeasureSelection

Gunakan BallotMeasureSelection untuk mengidentifikasi pilihan surat suara yang melibatkan ukuran surat suara, seperti referendum.

BallotMeasureSelection mewarisi atribut dan elemen BallotSelection. Sintaksis XML untuk BallotMeasureSelection adalah sebagai berikut: <BallotSelection xsi:type="BallotMeasureSelection" ... />.

Elemen

Tabel berikut menjelaskan elemen untuk BallotMeasureSelection:

Elemen Keanekaragaman Jenis Deskripsi
ExternalIdentifiers 1 ExternalIdentifiers Mengaitkan ID dengan pilihan inisiatif dan referendum. A ID stabil wajib diisi.
Selection 1 InternationalizedText Menyediakan pilihan yang tersedia untuk surat suara, seperti Yes atau No.

Contoh

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"
            }
          ]
        },
        "Selection": {
          "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"
            }
          ]
        },
        "Selection": {
          "Text": [
            {
              "value": "Yes",
              "language": "en"
            }
          ]
        }
      }
    ]