משתמשים ב-ElectionReport
בתור הישות ברמה הבסיסית (root). הוא מגדיר פריטים שקשורים למצב ולפורמט של הדוח, ולתאריך שבו הוא נוצר.
ElectionReport
כולל את הרכיבים העיקריים הבאים:
בדומה ל-Election
, הרכיב ElectionReport
'עוטף' את המופעים של הרכיבים, מלבד Election
, ברכיבי מאגר. כך קל יותר לבצע פעולות בקובצי המכונות בתוכנות לצפייה ולעריכה של קובצי 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 |
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 }