IEEE P1622 Meeting                               October 24-25, 2011     Guide to using OASIS EML v7.0 for UOCAVA         ...
Outline          Mapping of OASIS EML transactions to           UOCAVA information exchange needs          Examining str...
UOCAVA Information Needs           Mapping of OASIS EML transactions to           UOCAVA information exchange needsIEEE P1...
Ballot Delivery System (BDS)             Many aspects to this need to be considered                  Web site and portal...
Ballot Web Site Considerations          Information can change dynamically to match legal and other           information...
Ballot Construction and Delivery          Two approaches – pre-built ballots and styles, or dynamic ballot           gene...
Summarizing Information Needs        Qualified voter records        Election details: Federal, State, Local        Cand...
Mapping to OASIS EML V7.0          Elections Information = EML 110          Candidates Information = EML 230          B...
The EML 505       Created to make it easier for states to start using EML        schemas       Combines elements from ot...
The EMLs 330 and 470       Used to facilitate ballot tracking as required in MOVE Act       EML 330 used for VRDB export...
The EMLs 110, 230 and 410       EML 110 contains information about the elections and        their management       Data ...
Example files       Example files included to show structures within        EMLs 110, 230, 330, 470, 505, and SEAL       ...
Examining EML Schema           Examining the structure of the EML           transactions and their make-upIEEE P1622 Meeti...
Overview of EML schema       The EML schema provide a consistent approach to        assembling the information exchange a...
External Schema and Standards      The EML schema use standard schema from other       specifications and reference them ...
EML Schema Common Construct                                                  Namespace                                    ...
EML Schema Header Construct                                     Packaging   Key:   ? = optional   * = repeatable          ...
EML dictionary and Models             Modelling tools available and             Vocabulary alignmentIEEE P1622 Meeting, Oc...
EML dictionaries             Two dictionaries                  EML Core components                  Complete EML compon...
Vocabulary Alignment             Definitions of EML Core components                  Significantly improved in V7       ...
EML Core V7                                 Components and                                 definitions used               ...
Person Name                                  OASIS CIQ                                  specification –                   ...
Address                               OASIS CIQ                               specification –                             ...
The SEAL Structure           An EML element for holding digital signatures, i.e., for signing            the EML file.   ...
EML Schema for UOCAVA           Drill-down of the structure of the EML           transactions and their detailsIEEE P1622 ...
Election:                               EML 110IEEE P1622 Meeting, Oct 2011               Page 26
Candidates:                               EML 230IEEE P1622 Meeting, Oct 2011            Page 27
Voters:                               EML 330                               (aka poll                               book)I...
Ballots:                               EML 410IEEE P1622 Meeting, Oct 2011              Page 29
also in EML 110                                                 EML 505                                                 sp...
VToken:                               EML 470IEEE P1622 Meeting, Oct 2011             Page 31
Using OASIS CAM templates           Power tools for assembling XML           transactions, examples, models,           doc...
Beyond XML and Schema           OASIS CAM templates provide enhanced            capabilities:                XPath valid...
Dictionary Tools             Ability to work with dictionaries of canonical              components             Generate...
Available open source tools                                             Editor and                                        ...
Using EML Test Suites           Accelerating conformance testing and           examples verificationIEEE P1622 Meeting, Oc...
Test Suites Introduction     A key need in working with XML information exchanges, is developing      examples and matchi...
EML Transactions Delivery Lifecycle                                  Component                                   Dictionar...
CAM Validation Framework        Structure                                                            SQL Query        Rule...
CAMV / ANT Test Suites Environment                                 CAM                               template            C...
CAMV Test Control Script XML  Multi-Test Folder Example                    Test case name  <camvTestSuite>                ...
Running CAMV details  Batch Command Line Execution Window             Viewing Same Template in Visual Editor    From with...
Summary      OASIS EML V7.0 provides comprehensive standard       for UOCAVA elections management and services      Comp...
Upcoming SlideShare
Loading in …5
×

EML V7 Election Standard Overview

1,673 views

Published on

Technology Introduction of Election data standards presented at workshop at NIST, October, 2011

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,673
On SlideShare
0
From Embeds
0
Number of Embeds
4
Actions
Shares
0
Downloads
15
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

EML V7 Election Standard Overview

  1. 1. IEEE P1622 Meeting October 24-25, 2011 Guide to using OASIS EML v7.0 for UOCAVA Implementations David RR Webber Information Architect, Oracle http://vote.nist.govIEEE P1622 Meeting, Oct 2011
  2. 2. Outline  Mapping of OASIS EML transactions to UOCAVA information exchange needs  Examining structure of EML transactions  EML v7 dictionary and models  Each of EML transactions examined  Using OASIS CAM templates  Test suites configuration and examplesIEEE P1622 Meeting, Oct 2011 Page 2
  3. 3. UOCAVA Information Needs Mapping of OASIS EML transactions to UOCAVA information exchange needsIEEE P1622 Meeting, Oct 2011 Page 3
  4. 4. Ballot Delivery System (BDS)  Many aspects to this need to be considered  Web site and portal for voter access  Supporting information and processes  Ballot delivery, confirmation and return  Security and traceability  Voter privacy  We are not trying to design a BDS only anticipate the information it will need!IEEE P1622 Meeting, Oct 2011 Page 4
  5. 5. Ballot Web Site Considerations  Information can change dynamically to match legal and other informational needs as election unfolds  Voters need access various links to supporting information, official sites and help resources  Support for priority informational messages and alerts  Voting authorities addresses and contact information  Varied means to authenticate voters and required access checks  Tracking of web site usage and ballot delivery and returns  Voter privacy and security protectionsIEEE P1622 Meeting, Oct 2011 Page 5
  6. 6. Ballot Construction and Delivery  Two approaches – pre-built ballots and styles, or dynamic ballot generation from ballot templates and candidate/issues records  Voter needs to identify their voting district and precinct  System can either dynamically match ballot to voter, or retrieve from election voter registration record  Similarly return address information for voter to send completed ballot has to be matched  UOCAVA attestation statement questions have to be answered and results incorporated into ballot materialsIEEE P1622 Meeting, Oct 2011 Page 6
  7. 7. Summarizing Information Needs  Qualified voter records  Election details: Federal, State, Local  Candidate / Issues details  Ballot formatting and rendering details  Ballot delivery, voter verification, return  UOCAVA web site content and managingIEEE P1622 Meeting, Oct 2011 Page 7
  8. 8. Mapping to OASIS EML V7.0  Elections Information = EML 110  Candidates Information = EML 230  Ballot Information = EML 410  Voter Election List = EML 330  Voter Ballot Delivery = EML 470  UOCAVA delivery = EML 505  EML 505 can combine EML 110, 230, 410 dataIEEE P1622 Meeting, Oct 2011 Page 8
  9. 9. The EML 505  Created to make it easier for states to start using EML schemas  Combines elements from other schemas:  EML 110 Election Event: structures dealing with information about the elections  EML 230 Candidate List: details for contests and candidates  EML 410 Ballot List: structures for the contest ballots.  A basic 505 file can be created from a VIP feed file via an XSLT transform (samples available from Virginia 2010)IEEE P1622 Meeting, Oct 2011 Page 9
  10. 10. The EMLs 330 and 470  Used to facilitate ballot tracking as required in MOVE Act  EML 330 used for VRDB export:  Can be loaded with UOCAVA voters and sent to a BDS.  Can also include ballot status, i.e., accepted, rejected.  EML 470 used for ballot tracking:  Can be sent from a BDS when voter downloads a ballot, sets up a „channel‟ for the voter.  When precinct receives the ballot, precinct can respond with the 330 using the channel. * VRDB = Voter Record Database – subset only needed for UOCAVA needsIEEE P1622 Meeting, Oct 2011 Page 10
  11. 11. The EMLs 110, 230 and 410  EML 110 contains information about the elections and their management  Data constructs mirrored in EML 505  US precinct-aware structuring  EML 230 used for ballot candidate and issue information  Can contain much more information than typical US usage demands  EML 410 used for ballot details and provides cross- referencing to candidate and election information  Formal record of ballots to be used in the electionIEEE P1622 Meeting, Oct 2011 Page 11
  12. 12. Example files  Example files included to show structures within EMLs 110, 230, 330, 470, 505, and SEAL structure.  Must download EMLv7 files, then unpack example files within EML directory.  EMLv7 available from OASIS, example files available from IEEE P1622 site.IEEE P1622 Meeting, Oct 2011 Page 12
  13. 13. Examining EML Schema Examining the structure of the EML transactions and their make-upIEEE P1622 Meeting, Oct 2011 Page 13
  14. 14. Overview of EML schema  The EML schema provide a consistent approach to assembling the information exchange and its components  The EML core schema provides a common set of components across the entire EML schema  Each EML schema has a header and a body of components  Built-in capabilities such as digital signatures and seals are included in each schema  Packaging support allows information to be “chained” across sets of schema exchangesIEEE P1622 Meeting, Oct 2011 Page 14
  15. 15. External Schema and Standards  The EML schema use standard schema from other specifications and reference them as external component imports  Geospatial information (GIS for OASIS), Digital Signatures (W3C), OASIS Time Stamps (used for digital signatures), Names and Addresses (OASIS CIQ)  The EML V7 schema have been enhanced to improve their NIEM consistency (NIEM = National Information Exchange Model approach – www.niem.gov)  OASIS CIQ V4 Schema provide significantly easier to use constructs for USA style names and address conventions  Aligns with NIEM core names and addresses approachIEEE P1622 Meeting, Oct 2011 Page 15
  16. 16. EML Schema Common Construct Namespace declarations Shared functional components Universal core components External functional componentsIEEE P1622 Meeting, Oct 2011 Page 16
  17. 17. EML Schema Header Construct Packaging Key: ? = optional * = repeatable Optional CAM rules, symbol = has facets XSLT, etc Internationalization Responsible authorities and authenticity Versioning control Rendering support Verification and Security PayloadIEEE P1622 Meeting, Oct 2011 Page 17
  18. 18. EML dictionary and Models Modelling tools available and Vocabulary alignmentIEEE P1622 Meeting, Oct 2011 Page 18
  19. 19. EML dictionaries  Two dictionaries  EML Core components  Complete EML component reference  Can be viewed as Excel spreadsheet  Available as mind map models and XMI/UML physical componentsIEEE P1622 Meeting, Oct 2011 Page 19
  20. 20. Vocabulary Alignment  Definitions of EML Core components  Significantly improved in V7  Not everything is documented in all schema – still more work needed to close the gap  Focus on providing essential definitions for UOCAVA mapping purposesIEEE P1622 Meeting, Oct 2011 Page 20
  21. 21. EML Core V7 Components and definitions used globally across all EML transactionsIEEE P1622 Meeting, Oct 2011 Page 21
  22. 22. Person Name OASIS CIQ specification – aligned with NIEM name componentsIEEE P1622 Meeting, Oct 2011 Page 22
  23. 23. Address OASIS CIQ specification – aligned with UPU postal addressing for 207 postal authorities globallyIEEE P1622 Meeting, Oct 2011 Page 23
  24. 24. The SEAL Structure  An EML element for holding digital signatures, i.e., for signing the EML file.  Based on W3C guidance for digital signatures.  The Manifest element can hold hash of objects referenced in <URL> element, e.g., a PDF ballot – to allow authentication of ballot binary objects and their correct delivery  Conformance requires ability to use a SEAL with EML transactions  See W3C documentation and links to NIST web site in P1622 specification for using digital signaturesIEEE P1622 Meeting, Oct 2011 Page 24
  25. 25. EML Schema for UOCAVA Drill-down of the structure of the EML transactions and their detailsIEEE P1622 Meeting, Oct 2011 Page 25
  26. 26. Election: EML 110IEEE P1622 Meeting, Oct 2011 Page 26
  27. 27. Candidates: EML 230IEEE P1622 Meeting, Oct 2011 Page 27
  28. 28. Voters: EML 330 (aka poll book)IEEE P1622 Meeting, Oct 2011 Page 28
  29. 29. Ballots: EML 410IEEE P1622 Meeting, Oct 2011 Page 29
  30. 30. also in EML 110 EML 505 specific to also in EML 110 EML 505 also in EML 410 also in EML 230IEEE P1622 Meeting, Oct 2011 Page 30
  31. 31. VToken: EML 470IEEE P1622 Meeting, Oct 2011 Page 31
  32. 32. Using OASIS CAM templates Power tools for assembling XML transactions, examples, models, documentation, dictionaries and more…IEEE P1622 Meeting, Oct 2011 Page 32
  33. 33. Beyond XML and Schema  OASIS CAM templates provide enhanced capabilities:  XPath validation rules and logic  External Code Lists support  SQL database lookup support  XML test case generation  Automated documentation generation  Generation of modelsIEEE P1622 Meeting, Oct 2011 Page 33
  34. 34. Dictionary Tools  Ability to work with dictionaries of canonical components  Generate dictionaries from schema automatically  Verify dictionaries and component consistent  Compare to NIEM naming and design rules (NIEM NDR)IEEE P1622 Meeting, Oct 2011 Page 34
  35. 35. Available open source tools Editor and CAMV validation engine – open platform Download the CAM editor toolkit from: http://www.cameditor.orgIEEE P1622 Meeting, Oct 2011 Page 35
  36. 36. Using EML Test Suites Accelerating conformance testing and examples verificationIEEE P1622 Meeting, Oct 2011 Page 36
  37. 37. Test Suites Introduction  A key need in working with XML information exchanges, is developing examples and matching templates including rules, context, and roles for correctly managing information exchange content between partners. The W3C Schema by themselves are not sufficient.  Using open source tooling, XPath rules, and the OASIS CAM templates standard to create automated testing tools.  Integrating SQL table lookup validation rules  Ability to use external XML code list lookups  Pre-configured test suite available for EML UOCAVA examples:  http://www.cameditor.org/#CAMV_Testing Slide 37IEEE P1622 Meeting, Oct 2011
  38. 38. EML Transactions Delivery Lifecycle Component Dictionary EML Schema Templates Open source toolkit sponsored by EML standard updates Oracle Design EML Monitor Map and Template XML Test Samples Deploy XSD Test Suite Log Results Schema XMI / UML Compiled Models Templates DocumentationIEEE P1622 Meeting, Oct 2011
  39. 39. CAM Validation Framework Structure SQL Query Rules Database Template Lookup (compiled) Code Lists (optional) Results XML XML Java Handler instance CAMV Errors and WarningsIEEE P1622 Meeting, Oct 2011
  40. 40. CAMV / ANT Test Suites Environment CAM template CAMV Control Reports Script XML XML Test Instances XSLT 2 ANT 1 XML Validation CAMV Results Examples and instructions: http://www.cameditor.org/#CAMV_TestingIEEE P1622 Meeting, Oct 2011
  41. 41. CAMV Test Control Script XML Multi-Test Folder Example Test case name <camvTestSuite> Validation Template <testCase> <Example-Test-With-Folder> <cxxfile>../samples/templates/EML-330-list-v7.cxx</cxxfile> <testdir>../samples/XMLsamples/UOCAVA/330</testdir> <verbose>true</verbose> <inlineErrors>true</inlineErrors> Test XML instances folder <parameters> <abc>Param1</abc> <cde>Param2</cde> Optional items </parameters> </Example-Test-With-Folder> </testCase> </camvTestSuite> Slide 41IEEE P1622 Meeting, Oct 2011
  42. 42. Running CAMV details Batch Command Line Execution Window Viewing Same Template in Visual Editor From within the Test Suite folder on the command line execute > Ant runALL Slide 42IEEE P1622 Meeting, Oct 2011
  43. 43. Summary  OASIS EML V7.0 provides comprehensive standard for UOCAVA elections management and services  Complete suite of supporting tools available to assist implementers  Dictionaries and Models for data alignment  Test suite tools for accelerated verification  Examples to guide usage  Open source and online resources  http://www.cameditor.org & http://www.oasis-open.orgIEEE P1622 Meeting, Oct 2011 Page 43

×