Candidate का इस्तेमाल करके, किसी प्रतियोगिता में शामिल उम्मीदवार के बारे में जानकारी दें. CandidateSelection इकाई, Candidate का रेफ़रंस दे सकती है.
Candidate को किसी फ़ीड टाइप के साथ इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, नीचे दिए गए फ़ीड टाइप में से कोई एक चुनें.
कुछ चुनावों में, कई छोटी-छोटी प्रतियोगिताएं शामिल होती हैं या उनमें एक के बाद एक कई प्रतियोगिताएं होती हैं. इस तरह के मिलते-जुलते कॉन्टेस्ट में, एक Person को सिर्फ़ एक Candidate से रेफ़रंस किया जाना चाहिए. नीचे दिए गए उदाहरण पर ध्यान दें:
- पोलैंड में हुए चुनाव के पहले राउंड में, उम्मीदवार 1 ने व्यक्ति 1 का हवाला दिया है.
- हालांकि, दूसरे राउंड में उम्मीदवार 2 ने व्यक्ति 1 को रेफ़र किया है.
इस मामले में, उम्मीदवार 1 और उम्मीदवार 2 डुप्लीकेट हैं. दोनों प्रतियोगिताएं एक ही Candidate से जुड़ी होनी चाहिए. आम तौर पर, किसी उम्मीदवार को एक से ज़्यादा ऐसे कॉन्टेस्ट में शामिल न करें जो एक-दूसरे से जुड़े न हों.
विशेषताएं
यहां दी गई टेबल में, Candidate के लिए एट्रिब्यूट दिखाए गए हैं:
| एट्रिब्यूट | ज़रूरी है? | टाइप | ब्यौरा |
|---|---|---|---|
objectId |
ज़रूरी है | ID |
यह एक यूनीक इंटरनल आइडेंटिफ़ायर है. इसका इस्तेमाल अन्य एलिमेंट, इस एलिमेंट का रेफ़रंस देने के लिए करते हैं. |
एलिमेंट
इस टेबल में, Candidate के लिए उपलब्ध एलिमेंट दिखाए गए हैं:
| एलिमेंट | गुणनफल | टाइप | ब्यौरा |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
इससे उम्मीदवार का नाम मिलता है, जैसा कि बैलेट पर लिखा होता है. |
CampaignSlogan |
0 या 1 |
InternationalizedText |
किसी उम्मीदवार या उसके कैंपेन से कैंपेन के नारे के बारे में पूछने पर मिलने वाला जवाब. अमेरिका में साल 2020 में हुए राष्ट्रपति चुनाव के ये उदाहरण देखें:
|
ContactInformation |
0 या इससे ज़्यादा | ContactInformation |
उम्मीदवार की जानकारी के साथ, कैंपेन के मुख्यालय का पता, फ़ोन नंबर वगैरह जोड़ें. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
यह कुकी, किसी आईडी को उम्मीदवार से जोड़ती है. स्थिर आइडेंटिफ़ायर ज़रूरी है. |
FileDate |
0 या 1 | PartialDate |
वह तारीख जब उम्मीदवार ने आधिकारिक तौर पर चुनाव के लिए आवेदन किया था. |
IsIncumbent |
0 या 1 | boolean |
true की वैल्यू से पता चलता है कि उम्मीदवार, चुनाव से जुड़े पद पर फ़िलहाल मौजूद है. अगर यह
एलिमेंट मौजूद नहीं है, तो डिफ़ॉल्ट वैल्यू false होती है.
|
IsTopTicket |
0 या 1 | boolean |
इससे पता चलता है कि उम्मीदवार, एक से ज़्यादा उम्मीदवारों वाले टिकट में सबसे ऊपर है या नहीं. इस एलिमेंट को सिर्फ़ तब शामिल करें, जब CandidateSelection ऑब्जेक्ट में एक से ज़्यादा Candidate मौजूद हों.
अगर यह एलिमेंट मौजूद नहीं है, तो डिफ़ॉल्ट वैल्यू false होती है. |
PartyId |
एक या इससे ज़्यादा | IDREF |
Party एलिमेंट के लिए यूनीक आइडेंटिफ़ायर. इस कुकी का इस्तेमाल, किसी उम्मीदवार को उसकी राजनैतिक पार्टी से जोड़ने के लिए किया जाता है. |
PersonId |
1 | IDREF |
Person एलिमेंट के लिए यूनीक आइडेंटिफ़ायर. इस कुकी का इस्तेमाल, उम्मीदवार के बारे में ज़्यादा जानकारी को
जोड़ने के लिए किया जाता है. |
PostElectionStatus |
0 या 1 | CandidatePostElectionStatus |
उम्मीदवार की फ़ाइनल स्थिति, जैसे कि winner या
withdrawn. |
PreElectionStatus |
0 या 1 | CandidatePreElectionStatus |
उम्मीदवार के रजिस्ट्रेशन की स्थिति, जैसे कि filed या
qualified. |
ExternalIdentifiers के लिए अन्य टाइप
Candidate के ExternalIdentifiers एलिमेंट में, other के Type के साथ-साथ OtherType और Value की वैल्यू भी दें. यहां दी गई टेबल में, इन एलिमेंट की संभावित वैल्यू दिखाई गई हैं:
| OtherType | उदाहरण मान | ब्यौरा |
|---|---|---|
electoral-commission |
H2NY22097 |
ज़रूरी नहीं चुनाव आयोग का आईडी. |
उदाहरण
XML
<Candidate objectId="can-1001-kenyatta"> <BallotName> <Text language="en">Uhuru Kenyatta</Text> <Text language="sw">Uhuru Kenyatta</Text> </BallotName> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>can-per-100</Value> </ExternalIdentifier> <ExternalIdentifier> <Type>other</Type> <OtherType>electoral-commission</OtherType> <Value>H2NY22097</Value> </ExternalIdentifier> </ExternalIdentifiers> <IsIncumbent>1</IsIncumbent> <IsTopTicket>1</IsTopTicket> <PartyId>par-jubilee</PartyId> <PartyId>par-0002</PartyId> <PersonId>per-001-kenyatta</PersonId> <PostElectionStatus>projected-winner</PostElectionStatus> <PreElectionStatus>qualified</PreElectionStatus> </Candidate>
JSON
"Candidate": [ { "objectId": "can-1001-kenyatta", "BallotName": { "Text": [ { "value": "Uhuru Kenyatta", "language": "en" }, { "value": "Uhuru Kenyatta", "language": "sw" } ] }, "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "can-per-100" }, { "Type": "other", "OtherType": "electoral-commission", "Value": "H2NY22097" }, ] } "IsIncumbent": 1, "IsTopTicket": 1, "PartyId": ["par-jubilee","par-0002"] "PersonId": "per-001-kenyatta", "PostElectionStatus": "projected-winner", "PreElectionStatus": "qualified" } ]