משתמשים ב-ElectionReport כיישות הבסיסית. הוא מגדיר פריטים שקשורים לסטטוס ולפורמט של הדוח, ולזמן שבו הוא נוצר.
ElectionReport כולל את הרכיבים העיקריים הבאים:
בדומה ל-Election, ElectionReport 'עוטף' מופעים של הרכיבים, למעט Election, ברכיבי קונטיינר. כך קל יותר לתפעל את קובצי המופעים בעורכי XML ובכלי צפייה ב-XML.
לפעמים חשוב לשמור על סדר מסוים של פריטים, כמו משרדים או מפלגות. במקרים כאלה, אנחנו מצפים שהאפליקציה היוצרת תגדיר את הרכיבים האלה בהתאם לכל תוכנית הזמנות שכבר קיימת.
רכיבים
בטבלה הבאה מפורטים הרכיבים של ElectionReport:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
CommitteeCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של Committee. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
Election |
0 או יותר | Election |
משייך בחירות לדוח. |
ElectoralCommissionCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של ElectoralCommission. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
ExternalIdentifiers |
0 או 1 | ExternalIdentifiers |
משייך מזהה לדוח. |
Format |
1 | ReportDetailLevel |
מציין את רמת הפירוט של הדוח, למשל אם זה סיכום של תחרות או תוצאות ברמת האזור. |
GeneratedDate |
1 | dateTime |
התאריך והשעה שבהם נוצר דוח הבחירות. |
GpUnitCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של GpUnit. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
Issuer |
1 | string |
זיהוי של מנפיק הדוח. |
IssuerAbbreviation |
0 או 1 | string |
קיצור של שם הגורם שהנפיק את הדוח, למשל קיצור של שם המדינה או המחוז שעליהם מדווחים התוצאות. |
IsTest |
0 או 1 | boolean |
מציין אם הדוח הוא דוח בדיקה. אם הרכיב הזה לא מופיע, ערך ברירת המחדל הוא false. |
Notes |
0 או 1 | string |
הפרמטר הזה משמש להוספת הודעה שרירותית לדוח. |
OfficeCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של Office. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
GovernmentBodyCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של GovernmentBody. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
PartyCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של Party. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
PersonCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של Person. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
SequenceStart |
1 | integer |
המספר של הדוח כחלק מרצף של דוחות. הרכיב הזה משמש עם SequenceEnd כדי לקרוא, למשל, '1 מתוך 1', '1 מתוך 2' או '2 מתוך 2'. מתחיל ב-1. |
SequenceEnd |
1 | integer |
הגבול העליון של רצף הדוחות. לדוגמה, 1 אם יש רק דוח אחד, או 2 אם יש שני דוחות ברצף. |
Status |
1 | ResultsStatus |
הסטטוס של דוח הבחירות, למשל לפני הבחירות או לא רשמי. |
TestType |
0 או 1 | string |
תיאור של סוג הבדיקה, למשל בדיקה לפני בחירות או בדיקה של לוגיקה ודיוק. |
VendorApplicationID |
1 | string |
מזהה של אפליקציית הספק שיוצרת את דוח הבחירות. לדוגמה, X-EMS version 3.1.a. |
VoterInformationCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של VoterInformation. פרטים נוספים זמינים במאמר בנושא יחידות של אוסף. |
דוגמאות
XML
<ElectionReport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Election>…</Election> <GpUnitCollection> <GpUnit objectId="ru-gpu0">…</GpUnit> <GpUnit objectId="ru-gpu1">…</GpUnit> </GpUnitCollection> <OfficeCollection> <Office objectId="off0001a">…</Office> </OfficeCollection> <GovernmentBodyCollection> <GovernmentBody objectId="gov0001a">…</GovernmentBody> </GovernmentBodyCollection> <PartyCollection> <Party objectId="par001">…</Party> <Party objectId="par002">…</Party> </PartyCollection> <PersonCollection> <Person objectId="per001">…</Person> <Person objectId="per002">…</Person> </PersonCollection> <Issuer>Example Data Provider</Issuer> <IssuerAbbreviation>EDP</IssuerAbbreviation> <Format>summary-contest</Format> <GeneratedDate>2013-11-05T14:25:28</GeneratedDate> <Status>unofficial-partial</Status> <VendorApplicationId>Hand-Generated v0.1</VendorApplicationId> <SequenceStart>1</SequenceStart> <SequenceEnd>1</SequenceEnd> </ElectionReport>
JSON
{ "@type": "ElectionReport", "Election": [ ... ], "GpUnitCollection": { "GpUnit": [ {...}, {...} ] }, "OfficeCollection": { "Office": [ { "objectId": "off0001a", ... } ] }, "PartyCollection": { "Party": [ { "objectId": "par001", ... }, { "objectId": "par002", ... } ] }, "PersonCollection": { "Person": [ { "objectId": "per001", ... }, { "objectId": "per002", ... } ] }, "Issuer": "Example Data Provider", "IssuerAbbreviation": "EDP", "Format": "summary-contest", 'GeneratedDate": "2013-11-05T14:25:28", "Status": "unofficial-partial", "VendorApplicationId": "Hand-Generated v0.1", "SequenceStart": 1, "SequenceEnd": 1 }