Bir yarışmadaki adayla ilgili bilgileri açıklamak için Candidate kullanın. Candidate, CandidateSelection varlığı tarafından referans olarak kullanılabilir.
Candidate aracını 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 veya bir dizi yarışma içerir. Bu tür ilgili yarışmalarda bir Person yalnızca bir Candidate tarafından referans alınmalıdır. Aşağıdaki örnekleri inceleyin:
- Ulusal bir yarışmayı oluşturan eyalet yarışmasında 1. Kişi, 1. Aday tarafından referans gösterilir.
- Ancak aynı ulusal yarışmayı oluşturan başka bir eyalet yarışmasında 1. kişi, 2. aday tarafından referans gösterilir.
veya:
- Polonya'daki bir seçimin 1. turunda, 1. Kişi'den 1. Aday tarafından bahsediliyor.
- Ancak 2. turda 1. kişi, 2. aday tarafından referans olarak gösterilir.
Bu durumlarda, 1. Aday ve 2. Aday yinelenen öğelerdir. Her iki yarışmanın da aynı Candidate öğesine referans vermesi gerekir. Genellikle bir adayı birden fazla alakasız yarışmaya dahil etmeyin.
Özellikler
Aşağıdaki tabloda Candidate için özellikler 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 adını oy pusulasında belirtildiği şekilde gösterir. |
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çiminden şu örneklere bakın:
|
ContactInformation |
0 veya daha fazla | ContactInformation |
Kampanya merkezinin adresi, telefon numaraları vb. bilgileri aday bilgileriyle ilişkilendirin. |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Adayla bir kimliği ilişkilendirir. Sabit bir tanımlayıcı gereklidir. |
FileDate |
0 veya 1 | PartialDate |
Adayın yarışma için resmi olarak başvurduğu tarih. |
IsIncumbent |
0 veya 1 | boolean |
true değeri, adayın yarışmayla ilişkili makamın 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 içeren bir biletin 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 |
Oy pusulasında adayın adının yanında partisi olarak gösterilebilen ancak oy pusulasında yer almaya hak kazanmış bir parti olmayan metin (buna izin veren yerler için). |
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 advanced-to-runoff).
|
PreElectionStatus |
0 veya 1 | CandidatePreElectionStatus |
Adayın kayıt durumu (ör. filed veya qualified).
|
ExternalIdentifiers için ek türler
Candidate öğesinin ExternalIdentifiers öğesinde, other değerine sahip bir Type ile birlikte OtherType ve Value değerlerini içeren 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>