การเลือกบัตรลงคะแนน

ใช้BallotSelectionเพื่อระบุการลงคะแนนเลือกตั้งในการแข่งขัน เช่น เมื่อคุณลิงก์ผู้สมัครและพรรคการเมืองกับจำนวนคะแนนเสียง

เอกสารฉบับนี้กล่าวถึง BallotSelection และเอนทิตีย่อย

• BallotSelection
  • CandidateSelection
  • PartySelection
  • BallotMeasureSelection

---

เลือกประเภทฟีดต่อไปนี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ BallotSelection และองค์ประกอบที่มีอยู่ในฟีดประเภทนั้น

ฟีดข้อมูลก่อนการเลือกตั้ง ฟีดผลการเลือกตั้ง

---

หมายเหตุ: เอนทิตีนี้ไม่ใช้กับฟีดผู้ดำรงตำแหน่งทางการเมือง

BallotSelection

BallotSelection เป็นองค์ประกอบเชิงนามธรรมที่มี 3 ประเภทที่ใช้โดยอิงตาม ประเภทของการแข่งขัน

• CandidateSelection: ใช้ type นี้ BallotSelection เมื่อการแข่งขันมีขึ้นสำหรับผู้สมัครอย่างน้อย 1 คน ลิงก์ การลงคะแนนเสียงเลือกตั้งไปยัง Candidate
• PartySelection: ใช้ type จาก BallotSelection เมื่อประเภทการแข่งขันคือสำหรับ Party เช่น การชิงชัยในสัดส่วนพรรค
• BallotMeasureSelection: ใช้รูปแบบนี้ BallotSelection เพื่อแสดงการเลือกที่เป็นไปได้ใน BallotMeasureContest

Attributes

ตารางต่อไปนี้อธิบายแอตทริบิวต์สำหรับ BallotSelection

แอตทริบิวต์	จำเป็นหรือไม่	ประเภท	คำอธิบาย
objectId	ต้องระบุ	ID	ตัวระบุภายในที่ไม่ซ้ำกันซึ่งองค์ประกอบอื่นๆ ใช้เพื่ออ้างอิง องค์ประกอบนี้

องค์ประกอบ

ตารางต่อไปนี้อธิบายองค์ประกอบสำหรับ BallotSelection

องค์ประกอบ	ความหลากหลาย	ประเภท	คำอธิบาย
SequenceOrder	0 หรือ 1	integer	ระบุลำดับเริ่มต้นสำหรับการเลือกบัตรลงคะแนนเพื่อแสดง วัตถุประสงค์ หากไม่มี SequenceOrder ในฟีด แสดงว่าไม่มีลำดับ เท่านั้น

CandidateSelection

ใช้CandidateSelection เพื่อระบุการลงคะแนนเลือกตั้งในผู้สมัครรับเลือกตั้ง รวมถึงการเขียนรายงานไว้ด้วย

หมายเหตุ: เอนทิตีนี้ไม่ได้ใช้กับฟีดผู้ดำรงตำแหน่งทางการเมือง

CandidateSelection รับช่วงแอตทริบิวต์ และองค์ประกอบของ BallotSelection การอ้างอิงถึงหลายรายการ สามารถใส่องค์ประกอบ Candidate ได้ในกรณีต่อไปนี้ จำเป็น เช่น ในกรณีที่เป็นการลงคะแนนเลือกตั้งสำหรับตั๋วหลายใบ ที่เป็นตัวเลือก

เมื่อมีการอ้างถึงผู้สมัครหลายคนสำหรับตั๋ว 1 ใบ ในบางครั้ง เป็นเรื่องสำคัญมาก เพื่อรักษาลำดับของตัวเลือกเอาไว้ ในกรณีเหล่านี้ เราคาดว่า สร้างแอปพลิเคชันเพื่อแสดงรายการอ้างอิง Candidate องค์ประกอบภายใน CandidateIds ตามรูปแบบการสั่งซื้อที่ใช้ ตัวอย่างเช่น ลำดับของผู้สมัครต้องตรงกับ ลำดับเดียวกันของ การอ้างอิงองค์ประกอบ Office ภายใน OfficeIds ใน Contest ของประเภท CandidateContest

หากมีการอ้างอิงออบเจ็กต์ Candidate มากกว่า 1 รายการ ระบบจะแสดงต่อผู้ใช้ ตามลำดับต่อไปนี้

• ผู้สมัครทั้งหมดที่มี IsTopTicket ที่ตั้งค่าเป็น true จะมีลำดับก่อนทั้งหมด คำที่แนะนำที่ไม่มีค่า IsTopTicket และในทางกลับกัน โฆษณาก็ได้รับเลือกล่วงหน้า ของตัวเลือกทั้งหมดที่มีการตั้งค่า IsTopTicket เป็น false ตามหลักแล้ว การเลือก ได้รับการตั้งค่าด้วยตัวเลือกอย่างใดอย่างหนึ่งที่ไม่มีค่า IsTopTicket หรือ เป็นคู่ที่รอการพิจารณา และหนึ่งในนั้นตั้งค่า IsTopTicket เป็น true หากไม่เป็นไปตามเงื่อนไขเหล่านี้ สิ่งต่อไปนี้จะเกิดขึ้น
  • ผู้สมัครทั้งหมดที่มี IsTopTicket ซึ่งตั้งค่าเป็น true จะแสดงใน ลำดับที่ไม่ได้กำหนด
  • ผู้สมัครทั้งหมดที่มี IsTopTicket ไม่มีอยู่ใน ลำดับที่ไม่ได้กำหนด
  • ผู้สมัครทั้งหมดที่มี IsTopTicket ซึ่งตั้งค่าเป็น false จะแสดงใน ลำดับที่ไม่ได้กำหนด

ไวยากรณ์ XML สำหรับ CandidateSelection มีดังนี้ <BallotSelection xsi:type="CandidateSelection">

องค์ประกอบ

ตารางต่อไปนี้อธิบายองค์ประกอบสำหรับ CandidateSelection

องค์ประกอบ	ความหลากหลาย	ประเภท	คำอธิบาย
CandidateIds	1	IDREFS	ตัวระบุที่ไม่ซ้ำกันสำหรับ 1 รายการขึ้นไป Candidate จากองค์ประกอบเหล่านี้ ใช้เพื่อเชื่อมโยงผู้สมัครกับตัวเลือกผู้สมัครใน บัตรลงคะแนน มีประโยชน์ในการลงคะแนนเลือกตั้งสำหรับ ผู้สมัคร เช่น คำขอแจ้งปัญหา กับประธานาธิบดีและรองประธานาธิบดี เลือกไว้ด้วยกัน
EndorsementPartyIds	0 ขึ้นไป	IDREFS	ตัวระบุที่ไม่ซ้ำกันสำหรับ 2 รายการขึ้นไป Party เอนทิตี นี่เป็นข้อตกลงที่พรรคการเมืองต่างๆ ระบุถึง ผู้ลงสมัครรับเลือกตั้งในการลงคะแนนเสียง
IsWriteIn	0 หรือ 1	boolean	ระบุว่าผู้สมัครเป็นข้อมูลที่เขียนขึ้นหรือไม่ ค่าเริ่มต้นคือ false

ตัวอย่าง

XML

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

JSON

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

PartySelection

ใช้PartySelection เพื่อระบุการลงคะแนนเสียงเลือกตั้งที่เกี่ยวข้องกับพรรคหนึ่งๆ เช่น ซึ่งเป็นรายชื่อบุคคลในบัตรลงคะแนน

หมายเหตุ: เอนทิตีนี้ไม่ได้ใช้กับฟีดผู้ดำรงตำแหน่งทางการเมือง

PartySelection จะรับแอตทริบิวต์และองค์ประกอบ BallotSelection มา ไวยากรณ์ XML สำหรับ PartySelection คือ <BallotSelection xsi:type="PartySelection" ... />

องค์ประกอบ

ตารางต่อไปนี้อธิบายองค์ประกอบสำหรับ PartySelection

องค์ประกอบ	ความหลากหลาย	ประเภท	คำอธิบาย
PartyIds	1	IDREFS	ตัวระบุที่ไม่ซ้ำกันสำหรับ 1 รายการขึ้นไป Party จากองค์ประกอบเหล่านี้ ใช้เพื่อเชื่อมโยงอย่างน้อย 1 ฝ่ายกับบุคคลดังกล่าว มากมาย

ตัวอย่าง

XML

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

JSON

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

BallotMeasureSelection

ใช้BallotMeasureSelection เพื่อระบุการลงคะแนนเลือกตั้งที่เกี่ยวข้องกับ การลงประชามติ เช่น การลงประชามติ

หมายเหตุ: เอนทิตีนี้ไม่ได้ใช้กับฟีดผู้ดำรงตำแหน่งทางการเมือง

BallotMeasureSelection รับแอตทริบิวต์และองค์ประกอบของ BallotSelection ไวยากรณ์ XML สำหรับ BallotMeasureSelection มีดังนี้ <BallotSelection xsi:type="BallotMeasureSelection" ... />

องค์ประกอบ

ตารางต่อไปนี้อธิบายองค์ประกอบสำหรับ BallotMeasureSelection

องค์ประกอบ	ความหลากหลาย	ประเภท	คำอธิบาย
ExternalIdentifiers	1	ExternalIdentifiers	เชื่อมโยงบัตรประจำตัวกับการลงประชามติที่เลือก ต ตัวระบุแบบคงที่ ต้องระบุ
Selection	1	InternationalizedText	มีตัวเลือกสำหรับการลงคะแนนเสียง เช่น Yes หรือ No

ตัวอย่าง

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