משתמשים ב-ElectionReport כישות שורש. הוא מגדיר פריטים שקשורים לסטטוס ולפורמט של הדוח, ולזמן שבו הוא נוצר.
ElectionReport כולל את הרכיבים העיקריים הבאים:
בדומה ל-Election, ElectionReport 'עוטף' מופעים של הרכיבים, למעט Election, ברכיבי קונטיינר. כך קל יותר לתפעל את קובצי המופע בעורכי XML ובצופים.
לפעמים חשוב לשמור על סדר מסוים של פריטים, כמו משרדים או מפלגות פוליטיות. במקרים כאלה, אנחנו מצפים שהאפליקציה היוצרת תגדיר את הרכיבים האלה בהתאם לכל תוכנית הזמנות שכבר קיימת.
רכיבים
בטבלה הבאה מפורטים הרכיבים של ElectionReport:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
CommitteeCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של Committee. פרטים נוספים זמינים במאמר בנושא ישויות אוסף. |
DataSourceCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של DataSource. פרטים נוספים זמינים במאמר בנושא ישויות אוסף.
|
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"> <DataSourceCollection> <DataSource objectId="ds-1">…</DataSource> </DataSourceCollection> <Election>…</Election> <GpUnitCollection> <GpUnit objectId="ru-gpu0">…</GpUnit> <GpUnit objectId="ru-gpu1">…</GpUnit> </GpUnitCollection> <OfficeCollection> <Office objectId="off-0001a">…</Office> </OfficeCollection> <GovernmentBodyCollection> <GovernmentBody objectId="gb-0001a">…</GovernmentBody> </GovernmentBodyCollection> <PartyCollection> <Party objectId="par-001">…</Party> <Party objectId="par-002">…</Party> </PartyCollection> <PersonCollection> <Person objectId="per-001">…</Person> <Person objectId="per-002">…</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>