बैलोटचुनीन

किसी चुनाव में बैलेट के विकल्पों की पहचान करने के लिए, BallotSelection का इस्तेमाल करें. जैसे, जब आपको उम्मीदवारों और पार्टियों को उनके वोटों की संख्या से लिंक करना हो.

इस दस्तावेज़ में BallotSelection और इसकी सब-इकाईयों के बारे में बताया गया है:

• BallotSelection
  • CandidateSelection
  • PartySelection
  • BallotMeasureSelection

---

BallotSelection और उसके एलिमेंट को किसी फ़ीड टाइप के साथ इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, यहां दिए गए फ़ीड टाइप में से कोई एक चुनें.

चुनाव से पहले के डेटा फ़ीड चुनाव के नतीजों के फ़ीड

---

ध्यान दें: इस इकाई का इस्तेमाल, ऑफ़िसहोल्डर फ़ीड के साथ नहीं किया जाता.

BallotSelection

BallotSelection एक ऐब्स्ट्रैक्ट एलिमेंट है. इसके तीन टाइप होते हैं, जिनका इस्तेमाल प्रतियोगिता के टाइप के आधार पर किया जाता है:

• CandidateSelection: अगर चुनाव में एक या उससे ज़्यादा उम्मीदवार हैं, तो BallotSelection के इस type का इस्तेमाल करें. यह मतपत्र चुनने की सुविधा को Candidate एलिमेंट से लिंक करता है.
• PartySelection: BallotSelection के इस type का इस्तेमाल तब करें, जब प्रतियोगिता का टाइप Party हो. जैसे, पार्टी के हिसाब से वोट पाने वाली प्रतियोगिता.
• BallotMeasureSelection: इस तरह के BallotSelection का इस्तेमाल, BallotMeasureContest में संभावित विकल्पों को दिखाने के लिए करें.

विशेषताएं

यहां दी गई टेबल में, BallotSelection के लिए एट्रिब्यूट के बारे में बताया गया है:

एट्रिब्यूट	ज़रूरी है?	टाइप	ब्यौरा
objectId	ज़रूरी है	ID	यह एक यूनीक इंटरनल आइडेंटिफ़ायर है. इसका इस्तेमाल अन्य एलिमेंट, इस एलिमेंट का रेफ़रंस देने के लिए करते हैं.

एलिमेंट

यहां दी गई टेबल में, BallotSelection के एलिमेंट के बारे में बताया गया है:

एलिमेंट	गुणनफल	टाइप	ब्यौरा
SequenceOrder	0 या 1	integer	यह कुकी, बैलेट के विकल्पों को दिखाने के लिए डिफ़ॉल्ट क्रम तय करती है. अगर फ़ीड में SequenceOrder मौजूद नहीं है, तो कोई ऑर्डर नहीं माना जाता.

CandidateSelection

किसी उम्मीदवार की प्रतियोगिता में बैलेट के विकल्पों की पहचान करने के लिए, CandidateSelection का इस्तेमाल करें. इसमें लिखे गए विकल्प भी शामिल हैं.

ध्यान दें: इस इकाई का इस्तेमाल, ऑफ़िसहोल्डर फ़ीड के साथ नहीं किया जाता.

CandidateSelection, BallotSelection के एट्रिब्यूट और एलिमेंट इनहेरिट करता है. ज़रूरत पड़ने पर, एक से ज़्यादा Candidate एलिमेंट के रेफ़रंस शामिल किए जा सकते हैं. उदाहरण के लिए, जब बैलेट का चुनाव कई उम्मीदवारों के टिकट के लिए किया जाता है.

जब किसी टिकट के लिए एक से ज़्यादा कैंडिडेट का रेफ़रंस दिया जाता है, तो कभी-कभी कैंडिडेट के क्रम को बनाए रखना ज़रूरी होता है. ऐसे मामलों में, हम उम्मीद करते हैं कि कॉन्टेंट जनरेट करने वाला ऐप्लिकेशन, CandidateIds में मौजूद Candidate एलिमेंट के रेफ़रंस को, तय किए गए क्रम के हिसाब से सूची में शामिल करेगा. उदाहरण के लिए, उम्मीदवारों का क्रम, Office एलिमेंट के रेफ़रंस के क्रम से मेल खाना चाहिए. ये रेफ़रंस, CandidateContest टाइप के Contest में मौजूद OfficeIds में होने चाहिए.

अगर एक से ज़्यादा Candidate ऑब्जेक्ट का रेफ़रंस दिया गया है, तो उन्हें उपयोगकर्ता को इस क्रम में दिखाया जाता है:

• IsTopTicket की वैल्यू true पर सेट किए गए सभी उम्मीदवारों को, IsTopTicket की वैल्यू सेट न करने वाले सभी उम्मीदवारों से पहले क्रम में रखा जाता है. इसके बाद, उन सभी उम्मीदवारों को रखा जाता है जिन्होंने IsTopTicket को false पर सेट किया है. आमतौर पर, किसी एक उम्मीदवार को बिना IsTopTicket वैल्यू के चुना जाता है. इसके अलावा, दो उम्मीदवारों में से किसी एक के लिए IsTopTicket एट्रिब्यूट की वैल्यू true पर सेट की जाती है. अगर ये शर्तें पूरी नहीं होती हैं, तो ये काम किए जाते हैं:
  • IsTopTicket को true पर सेट करने वाले सभी उम्मीदवारों को किसी क्रम में नहीं दिखाया जाता.
  • जिन उम्मीदवारों के पास IsTopTicket मौजूद नहीं है उन्हें किसी क्रम में नहीं दिखाया जाता.
  • IsTopTicket को false पर सेट करने वाले सभी उम्मीदवारों को किसी क्रम में नहीं दिखाया जाता.

CandidateSelection के लिए एक्सएमएल सिंटैक्स यह है: <BallotSelection xsi:type="CandidateSelection">.

एलिमेंट

यहां दी गई टेबल में, CandidateSelection के एलिमेंट के बारे में बताया गया है:

एलिमेंट	गुणनफल	टाइप	ब्यौरा
CandidateIds	1	IDREFS	एक या उससे ज़्यादा Candidate एलिमेंट के लिए यूनीक आइडेंटिफ़ायर. इस प्रॉपर्टी का इस्तेमाल, बैलेट पर उम्मीदवार को चुनने के लिए किया जाता है. यह तब भी काम आता है, जब बैलेट में एक से ज़्यादा उम्मीदवारों को चुना जाता है. जैसे, राष्ट्रपति और उपराष्ट्रपति को एक साथ चुना जाता है.
EndorsementPartyIds	0 या इससे ज़्यादा	IDREFS	दो या उससे ज़्यादा 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 के एट्रिब्यूट और एलिमेंट इनहेरिट करता है. PartySelection के लिए एक्सएमएल सिंटैक्स यह है: <BallotSelection xsi:type="PartySelection" ... />.

एलिमेंट

यहां दी गई टेबल में, PartySelection के एलिमेंट के बारे में बताया गया है:

एलिमेंट	गुणनफल	टाइप	ब्यौरा
PartyIds	1	IDREFS	एक या उससे ज़्यादा Party एलिमेंट के लिए यूनीक आइडेंटिफ़ायर. इस कुकी का इस्तेमाल, पार्टी चुनने की सुविधा के साथ एक या एक से ज़्यादा पार्टियों को जोड़ने के लिए किया जाता है.

उदाहरण

XML

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

JSON

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

BallotMeasureSelection

BallotMeasureSelection का इस्तेमाल करके, बैलेट के उन विकल्पों की पहचान करें जिनमें बैलेट मेज़र शामिल है. जैसे, जनमत संग्रह.

ध्यान दें: इस इकाई का इस्तेमाल, ऑफ़िसहोल्डर फ़ीड के साथ नहीं किया जाता.

BallotMeasureSelection, BallotSelection के एट्रिब्यूट और एलिमेंट इनहेरिट करता है. 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"
            }
          ]
        },
        "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"
            }
          ]
        }
      }
    ]