BallotSelection का इस्तेमाल करके, किसी चुनाव में बैलेट के विकल्पों की पहचान करें. जैसे, जब आपको उम्मीदवारों और पार्टियों को उनके वोटों की संख्या से लिंक करना हो.
इस दस्तावेज़ में BallotSelection और इसकी सब-इकाईयों के बारे में बताया गया है:
BallotSelectionCandidateSelectionPartySelectionBallotMeasureSelectionSpecialBallotSelection
BallotSelection और उसके एलिमेंट को किसी फ़ीड टाइप के साथ इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, यहां दिए गए फ़ीड टाइप में से कोई एक चुनें.
BallotSelection
BallotSelection एक ऐब्स्ट्रैक्ट एलिमेंट है. इसके तीन टाइप होते हैं, जिनका इस्तेमाल प्रतियोगिता के टाइप के आधार पर किया जाता है:
CandidateSelection: अगर चुनाव में एक या उससे ज़्यादा उम्मीदवार हैं, तोBallotSelectionके इसtypeका इस्तेमाल करें. यह मतपत्र चुनने की सुविधा कोCandidateएलिमेंट से लिंक करता है.PartySelection:BallotSelectionके इसtypeका इस्तेमाल तब करें, जब प्रतियोगिता का टाइपPartyहो. जैसे, पार्टी के हिसाब से वोट पाने की प्रतियोगिता.BallotMeasureSelection: इस तरह केBallotSelectionका इस्तेमाल,BallotMeasureContestमें संभावित विकल्पों को दिखाने के लिए करें.SpecialBallotSelection: इस तरह केBallotSelectionका इस्तेमाल, वोटों की गिनती को एग्रीगेट करने के लिए किया जाता है. उदाहरण के लिए, कई उम्मीदवारों को "अन्य" में एग्रीगेट करना. साथ ही, इसका इस्तेमाल अलग-अलग तरह के नॉन-वोट के लिए भी किया जाता है. जैसे, खाली मतपत्र, अमान्य मतपत्र, और "इनमें से कोई नहीं" वोट.
विशेषताएं
यहां दी गई टेबल में, BallotSelection के लिए एट्रिब्यूट के बारे में बताया गया है:
| एट्रिब्यूट | ज़रूरी है? | टाइप | ब्यौरा |
|---|---|---|---|
objectId
|
ज़रूरी है | ID |
यह एक यूनीक इंटरनल आइडेंटिफ़ायर है. इसका इस्तेमाल अन्य एलिमेंट, इस एलिमेंट का रेफ़रंस देने के लिए करते हैं. |
एलिमेंट
इस टेबल में, BallotSelection के एलिमेंट के बारे में बताया गया है:
| एलिमेंट | गुणनफल | टाइप | ब्यौरा |
|---|---|---|---|
SequenceOrder |
0 या 1 | integer |
यह विकल्प, बैलेट के विकल्पों को दिखाने के लिए डिफ़ॉल्ट क्रम तय करता है. अगर फ़ीड में |
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" } } }