Bir yarışmadaki aday hakkında bilgi vermek için Candidate kullanın. Bir Candidate, CandidateSelection öğesi tarafından referans verilebilir.
Candidate özelliğini ilgili feed türüyle nasıl kullanacağınız hakkında daha fazla bilgi edinmek için aşağıdaki feed türlerinden birini seçin.
Bazı seçimler birden fazla küçük yarışmadan oluşur. Bu türdeki ilgili yarışmalarda, Person yalnızca bir Candidate tarafından referans alınmalıdır.
Aşağıdaki örneği inceleyelim:
- Ulusal bir yarışmayı oluşturan eyalet yarışmasında, 1. Aday, 1. Kişi'ye atıfta bulunuyor.
- Ancak aynı ulusal yarışmadan oluşan başka bir eyalet yarışmasında 1. Kişi, 2. Aday tarafından referans olarak gösteriliyor.
Bu durumda, Aday 1 ve Aday 2 yinelenen girişlerdir. Her iki yarışmada da aynı Candidate'ya referans verilmesi gerekir. Genellikle bir adayı birden fazla alakasız yarışmaya veya sonraki yarışmalara dahil etmeyin.
Özellikler
Aşağıdaki tabloda Candidate öğesinin özellikleri gösterilmektedir:
| Özellik | Zorunlu mu? | Tür | Açıklama |
|---|---|---|---|
objectId |
Zorunlu | ID |
Diğer öğelerin bu öğeye referans vermek için kullandığı benzersiz dahili tanımlayıcı. |
Öğeler
Aşağıdaki tabloda Candidate öğeleri gösterilmektedir:
| Öğe | Çokluk | Tür | Açıklama |
|---|---|---|---|
BallotName |
1 | InternationalizedText |
Adayın oy pusulasında listelenen adını sağlar. |
CampaignSlogan |
0 veya 1 |
InternationalizedText |
Bir adaya veya kampanyasına kampanya sloganının ne olduğunu sorduğunuzda aldığınız slogan. 2020 ABD başkanlık seçimindeki şu örneklere göz atın:
|
ContactInformation |
0 veya daha fazla | ContactInformation |
Kampanya genel merkezinin adresini, telefon numaralarını vb. aday bilgileriyle ilişkilendirin. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Adayla bir kimlik ilişkilendirir. Bir kararlı tanımlayıcı gerekir. |
FileDate |
0 veya 1 | PartialDate |
Adayın yarışmaya resmi olarak başvurduğu tarih. |
IsIncumbent |
0 veya 1 | boolean |
true değeri, adayın yarışmayla ilişkili görevin mevcut sahibi olduğunu gösterir. Bu öğe yoksa varsayılan değer false olur.
|
IsNotable |
0 veya 1 | boolean |
Varlığın dikkate değer olup olmadığı. Belirtilmezse false olduğu varsayılır.
|
IsTopTicket |
0 veya 1 | boolean |
Adayın, birden fazla adayın yer aldığı bir pusulanın en üstünde olup olmadığını gösterir. Bu öğeyi yalnızca bir CandidateSelection nesnesinde birden fazla Candidate olduğunda ekleyin.
Bu öğe yoksa varsayılan değer false olur. |
PartyId |
1 veya daha fazla | IDREF |
Party öğesinin benzersiz tanımlayıcısı. Adayı siyasi partisiyle ilişkilendirmek için kullanılır. |
PartyLabel |
0 veya 1 | InternationalizedText |
Bir adayın oy pusulasındaki adının yanında partisi olarak görünebilen ancak oy pusulasında yer almaya uygun olmayan parti (buna izin verilen yerlerde). |
PersonId |
1 | IDREF |
Person öğesinin benzersiz tanımlayıcısı. Aday hakkında daha ayrıntılı bilgileri ilişkilendirmek için kullanılır. |
PostElectionStatus |
0 veya 1 | CandidatePostElectionStatus |
Adayın nihai durumu (ör. winner veya withdrawn). |
PreElectionStatus |
0 veya 1 | CandidatePreElectionStatus |
Adayın kayıt durumu (ör. filed veya qualified). |
ExternalIdentifiers için ek türler
Candidate öğesinin ExternalIdentifiers öğesinde, OtherType ve Value değerleriyle birlikte other Type ile ek veriler sağlayın. Aşağıdaki tabloda bu öğeler için olası değerler gösterilmektedir:
| OtherType | Örnek değerler | Açıklama |
|---|---|---|
electoral-commission |
H2NY22097 |
İsteğe bağlı Seçim komisyonu kimliği. |
tse-candidate-number |
12345 |
İsteğe bağlı Brezilya seçimlerinde, Yüksek Seçim Mahkemesi (Tribunal Superior Eleitoral – TSE) tarafından verilen aday numarası. |
Örnekler
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-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>