बैलोटचुनीन

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

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

  • BallotSelection
    • CandidateSelection
    • PartySelection
    • BallotMeasureSelection
    • SpecialBallotSelection

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


BallotSelection

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

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

विशेषताएं

यहां दी गई टेबल में, 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 इकाइयों के लिए यूनीक आइडेंटिफ़ायर. इससे पता चलता है कि राजनैतिक पार्टियों ने बैलेट पर एक ही उम्मीदवार का नाम लिखा है.
IncludedInAggregation 0 या 1 boolean इससे पता चलता है कि चुनाव में, चुने गए विकल्प के वोटों की गिनती को AggregateBallotSelection में शामिल किया गया है या नहीं. अगर इसकी वैल्यू नहीं दी गई है, तो इसे false माना जाता है.
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 के एलिमेंट के बारे में बताया गया है:

एलिमेंट गुणनफल टाइप ब्यौरा
IncludedInAggregation 0 या 1 boolean इससे पता चलता है कि चुनाव में, चुने गए विकल्प के वोटों की गिनती को AggregateBallotSelection में शामिल किया गया है या नहीं. अगर इसकी वैल्यू नहीं दी गई है, तो इसे false माना जाता है.
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 0 या 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"
            }
          ]
        }
      }
    ]

SpecialBallotSelection

इस तरह के BallotSelection का इस्तेमाल, वोटों की गिनती को एग्रीगेट करने के लिए किया जाता है. उदाहरण के लिए, कई उम्मीदवारों को "अन्य" में एग्रीगेट करना. साथ ही, इसका इस्तेमाल अलग-अलग तरह के नॉन-वोट के लिए भी किया जाता है. जैसे, खाली बैलेट, अमान्य बैलेट, और "इनमें से कोई नहीं" वोट.

SpecialBallotSelection का इस्तेमाल, Contest के सामान्य BallotSelection सब-एलिमेंट में नहीं किया जाना चाहिए. इसके बजाय, Contest में इसके अपने अलग-अलग फ़ील्ड होते हैं. जैसे, AggregateBallotSelection, BlankBallotSelection, NoneOfTheAboveBallotSelection, और NullBallotSelection. ज़्यादा जानकारी के लिए, Contest एलिमेंट देखें.

एलिमेंट

इस टेबल में, SpecialBallotSelection के एलिमेंट के बारे में बताया गया है:

एलिमेंट गुणनफल टाइप ब्यौरा
CountedInTotal 0 या 1 boolean क्या इकाई चुनने के लिए डाले गए वोटों की संख्या को, कुल वोटों में गिना जाता है. अगर true की वैल्यू नहीं दी गई है, तो इसे true फ़ॉर्मैट माना जाता है.
ExternalIdentifiers 0 या 1 ExternalIdentifiers यह कुकी, मतदान के लिए चुने गए विकल्प के साथ आईडी को जोड़ती है. स्थिर आइडेंटिफ़ायर ज़रूरी है.
Selection 1 InternationalizedText इस बैलेट के विकल्प को एक नाम देता है, जैसे कि "अन्य" या "इनमें से कोई नहीं".

उदाहरण

XML

    <AggregateBallotSelection objectId="selection3">
      <Selection>
        <Text language="en">Other Candidates</Text>
      </Selection>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>selection3</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </AggregateBallotSelection>
    <!-- Counts of ballots left blank -->
    <BlankBallotSelection objectId="selection4">
      <Selection>
        <Text language="en">Blank ballots</Text>
      </Selection>
      <!-- These ballots count in the total and can affect majorities -->
      <CountedInTotal>true</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>selection4</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </BlankBallotSelection>
    <!-- Votes for "None of the above" option on the ballot -->
    <NoneOfTheAboveBallotSelection objectId="selection5">
      <!--
        The NOTA selection optiona as it appears on the ballot, often
        "None of the above", "None", or "Uncommitted"
      -->
      <Selection>
        <Text language="en">None</Text>
      </Selection>
      <!-- These ballots count in the total and can affect majorities -->
      <CountedInTotal>true</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>selection5</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NoneOfTheAboveBallotSelection>
    <!--
      Counts of null or spoiled ballots, i.e. ballots that have been marked in
      a way that the vote cannot be counted
    -->
    <NullBallotSelection objectId="selection5">
      <!--
        How these ballots are often called in a given country, often
        "null" or "spoiled"
      -->
      <Selection>
        <Text language="en">Spoiled ballots</Text>
      </Selection>
      <!--
        These ballots do count in the total and are treated as the same as
        if this vote did not happen at all
      -->
      <CountedInTotal>false</CountedInTotal>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>selection5</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
    </NullBallotSelection>
      

JSON

    "AggregateBallotSelection": {
      "objectId": "selection3",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Other Candidates"
        }
      },
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection3"
        }
      },
    },
    "BlankBallotSelection": {
      "objectId": "selection4",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Blank Ballots"
        }
      },
      "CountedInTotal": true,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection4"
        }
      }
    },
    "NoneOfTheAboveBallotSelection": {
      "objectId": "selection5",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "None"
        }
      },
      "CountedInTotal": true,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection5"
        }
      }
    },
    "NullBallotSelection": {
      "objectId": "selection5",
      "Selection": {
        "Text": {
          "@language": "en",
          "#text": "Spoiled ballots"
        }
      },
      "CountedInTotal": false,
      "ExternalIdentifiers": {
        "ExternalIdentifier": {
          "Type": "other",
          "OtherType": "stable",
          "Value": "selection5"
        }
      }
    }