استخدِم Candidate لوصف معلومات عن مشارك في مسابقة. يمكن الإشارة إلى Candidate من خلال الكيان CandidateSelection.
اختَر أحد أنواع الخلاصات التالية لمعرفة المزيد حول كيفية استخدام
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.
|
IsNotable |
0 أو 1 | boolean |
تُستخدَم لتحديد ما إذا كان الكيان يُعدّ جديرًا بالملاحظة. يتم استخدام false
تلقائيًا في حال عدم تحديدها.
|
IsTopTicket |
0 أو 1 | boolean |
تشير إلى ما إذا كان المرشّح هو الأعلى في بطاقة تتضمّن مرشّحين متعدّدين. لا تضمِّن هذا العنصر إلا عندما يكون هناك أكثر من Candidate واحد في عنصر CandidateSelection.
إذا لم يكن هذا العنصر متوفّرًا، تكون القيمة التلقائية هي false. |
PartyId |
1 أو أكثر | IDREF |
تمثّل هذه السمة المعرّف الفريد لعنصر
Party. تُستخدَم لربط مرشّح بحزبه السياسي. |
PersonId |
1 | IDREF |
تمثّل هذه السمة المعرّف الفريد لعنصر
Person. يُستخدَم لربط معلومات أكثر تفصيلاً حول المرشّح. |
PostElectionStatus |
0 أو 1 | CandidatePostElectionStatus |
الحالة النهائية للمرشّح، مثل winner أو withdrawn |
PreElectionStatus |
0 أو 1 | CandidatePreElectionStatus |
حالة تسجيل المرشّح، مثل filed أو qualified |
أنواع إضافية لـ ExternalIdentifiers
في العنصر ExternalIdentifiers من Candidate،
قدِّم بيانات إضافية مع Type بقيمة other،
بالإضافة إلى قيمتَي 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" } ]