Seleksi

Gunakan BallotSelection untuk mengidentifikasi pemilihan surat suara dalam kontes, seperti saat Anda menautkan kandidat dan partai ke 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 menggunakannya BallotSelection dan elemen yang melekat padanya dengan jenis feed tersebut.

BallotSelection

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

  • CandidateSelection: Gunakan type ini BallotSelection jika kontes ditujukan untuk satu atau beberapa kandidat. {i>Link<i} ini menautkan pemilihan surat suara ke Elemen Candidate.
  • PartySelection: Gunakan type dari BallotSelection ini jika jenis kontesnya adalah untuk Party, seperti untuk kontes proporsional partai.
  • BallotMeasureSelection: Gunakan jenis BallotSelection untuk merepresentasikan kemungkinan pilihan dalam BallotMeasureContest.

Atribut

Tabel berikut menjelaskan atribut untuk BallotSelection:

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

Elemen

Tabel berikut menjelaskan elemen untuk BallotSelection:

Elemen Keanekaragaman Jenis Deskripsi
SequenceOrder 0 atau 1 integer

Menentukan urutan default pemilihan surat suara untuk ditampilkan tujuan.

Jika SequenceOrder tidak ada dalam feed, berarti tidak ada pesanan diasumsikan.

CandidateSelection

Gunakan CandidateSelection untuk mengidentifikasi pemilihan surat suara pada seorang kandidat lomba, termasuk menulis.

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

Saat beberapa kandidat dirujuk untuk sebuah tiket, terkadang penting untuk mempertahankan urutan kandidat. Dalam kasus ini, kami memperkirakan aplikasi yang menghasilkan daftar referensi Candidate elemen di dalam CandidateIds sesuai dengan skema pengurutan yang ada. Misalnya, urutan kandidat harus sesuai dengan urutan yang sama dari Referensi elemen Office dalam OfficeIds dalam jenis Contest CandidateContest

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

  • Semua kandidat dengan IsTopTicket yang ditetapkan ke true akan dipesan lebih awal kandidat tanpa nilai IsTopTicket. Oleh karena itu, mereka diperintahkan untuk dari semua kandidat dengan IsTopTicket yang ditetapkan ke false. Idealnya, pilihan ditetapkan dengan satu kandidat tanpa nilai IsTopTicket, atau dengan adalah 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 dengan IsTopTicket tidak hadir 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 Candidate yang kurang penting. Gunakan untuk mengaitkan kandidat dengan pilihan kandidat di surat suara tersebut. Juga berguna ketika pemilihan surat suara adalah untuk beberapa kandidat, seperti tiket untuk Presiden dan Wakil Presiden dipilih bersamaan.
EndorsementPartyIds 0 atau lebih IDREFS ID unik untuk dua atau lebih Entitas Party. Hal ini mewakili pengaturan di mana partai politik mencantumkan informasi yang sama kandidat pada surat suara.
IsWriteIn 0 atau 1 boolean Menunjukkan apakah kandidat adalah write-in. 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 pemilihan surat suara yang melibatkan partai, seperti pilihan daftar partai pada surat suara.

PartySelection mewarisi atribut dan elemen BallotSelection. Tujuan 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 Party yang kurang penting. Gunakan untuk mengaitkan satu atau beberapa pihak dengan pihak tersebut pilihan.

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 pemilihan surat suara yang melibatkan 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 pemilihan ukuran balot. J ID stabil tidak diperlukan.
Selection 1 InternationalizedText Memberikan pilihan yang tersedia untuk balot, 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"
            }
          ]
        }
        "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"
          },
        ]
      }
    ]