Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference...
-
Upload
hillary-hutchinson -
Category
Documents
-
view
213 -
download
0
Transcript of Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference...
![Page 1: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/1.jpg)
Case Studies on Information Exchange Package Documentation (IEPD) Development
GJXDM Users ConferenceAtlanta, Georgia
June 9, 2005
![Page 2: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/2.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
IEPD Goals and Objectives
Define IEPDs (Information Exchange Package Documentation) to support interoperability among justice systems
Expand and refine GJXDM/DD through experienced feedback; resolve vague definitions
Constrain/restrict down to key choices to support interoperability
![Page 3: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/3.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Goals of the IEPD Process
More consistent development of GJXDM conformant schemas
Produce artifacts that help project stakeholders
Provides a mechanism to synthesize domain/business knowledge of SMEs
Supports artifact reuse Leverages open standards Works with standards based tools that are
readily available in the public domain Shares lessons learned/best practices
![Page 4: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/4.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
IEPDs Developed 2004-2005
Sentencing Order Amber Alert Field Interview Report Charging Document Incident Reporting Uniform Rap Sheet Booking/Arrest Report
![Page 5: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/5.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Information Exchange Package Documentation Process
![Page 6: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/6.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
IEPD Business Issues
Business goals are the primary driverParticipation by business representativesIEP built upon use caseJustice exchange data does not belong
to only one domain Example: Protection from Abuse Order
GJXDM conformanceReuse of artifactsEvery IEP is a potential model
![Page 7: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/7.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
IEPD Workgroup
Representative group of exchange partners
Inclusion of business SMEs and technical experts
Selection of members is importantConsensus process IEPs cannot be built by technical staff or
business staff in isolation, partnership is critical
Skilled, experienced facilitator important
![Page 8: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/8.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Workgroup: Facilitator skills
Organization and project managementNeutralityUnderstanding of the domainUnderstanding of IEPD processUnderstanding of domain modeling
UML Object-oriented design
Understanding of GJXDM Awareness of national reference
material
![Page 9: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/9.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Workgroup: SME member skills
Understanding of business processes Triggering and subsequent processes Required content Relationships
Ability to describe the semantic meaning of the data
Ability to “think outside the box” As-is processes versus to-be processes Openness to change semantic concepts to
align with GJXDM
![Page 10: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/10.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Workgroup: Tech member skills
Understanding of GJXDM Source of good ideas for domain model Think ahead to mapping
Understanding of data availability and needs at exchange endpoints
Understanding of basic domain modeling concepts (including O/O design)
![Page 11: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/11.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Project planning
Obviously, depends on the documentRough guidelines:
Domain modeling (face-to-face, 2-3 days) Mapping (face-to-face for 1-2 days,
another 1-2 days remote) Schema building (facilitator or tech
member(s) only, 2-3 days) Packaging (1 day)
![Page 12: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/12.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
IEPD Process
JIEM/Exchange Requirements Domain Modeling GJXDM Mapping Subset Schema (SSGT) Extension, Document, Constraint Sample XML Instance Packaging Horizontal Analysis/Reuse Education and Outreach
![Page 13: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/13.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Incident Reporting IEPD
Project funded by COPS OfficeParticipants:
Local Law Enforcement State Law Enforcement
NIBRS, UCR, Repository FBI Prosecution Statistical Crime Reporting
![Page 14: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/14.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Domain Modeling: Incident Report
![Page 15: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/15.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Domain Modeling: Motivation
In building an IEP, it is very helpful to have:
A precise definition/description of document structure
A description that can be understandable and verifiable by all stakeholders (bridge the communication gap)
A description technique that facilitates interactive design
![Page 16: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/16.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Domain Modeling: UML
Pros Precise and formal,
yet… Graphical and
understandable by stakeholders
Supports O/O concepts inherent in XML Schema
Supported by low-cost tools
Industry/developer buy-in and adoption
![Page 17: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/17.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Domain Modeling: UML
Cons Need to educate
stakeholders about notation
Learning curve for modeler (learning notation)
Can lock into tools if you’re not careful
![Page 18: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/18.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Domain Modeling: Associations
Associations describe how the classes relate to one another
Example: A police officer issues a citationCan be verbs from the domain, or simply
descriptions of relationshipsWhen modeling hierarchical document
structures, associations are navigable (uni-directional)
Associations indicated with open-ended arrowsCan be named; if not, read as “relates to,”
“contains,” or “has”
![Page 19: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/19.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
GJXDM as source of domain concepts
XSTF has already done a lot of good thinking about concepts in the justice domain
GJXDM contains 400 nouns (complex types)Use these if they fit…don’t reinvent the wheelDon’t use them if they don’t fit…don’t restrict
your domain model to what’s in GJXDMRemember: need to build a model that the
business people can understand and agree toMost business people struggle to validate
structures documented in schema
![Page 20: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/20.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Domain Modeling: Incident Report
![Page 21: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/21.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Mapping to GJXDM
To build schema, each class/property in the domain model must be mapped to a type/element in GJXDM
Sometimes mapping can be represented in path-like notation
Sometimes it can only be described in proseMakes automated mapping (and schemas
generated from the domain model) very difficult
Sometimes domain concepts are missing from GJXDM; these are mapped to elements in an extension schema (your own namespace)
![Page 22: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/22.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Mapping to GJXDM
Spreadsheet with four columns: Class Property or Association GJXDM Mapping (path or prose,
extensions color-coded) Notes
![Page 23: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/23.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
GJXDM Mapping: Incident Report
Incident Report Mapping
![Page 24: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/24.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
![Page 25: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/25.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
SSGT Want List
![Page 26: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/26.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
SSGT Want List
![Page 27: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/27.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Packaging
Subset Schema Constraint Schema Extension Schema Document Schema Sample XML Instance IEPD
![Page 28: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/28.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Tools
Wide tool support for UML Visio Eclipse plug-ins ArgoUML Rational Rose and XDE
Keep in mind that the primary purpose of a domain model is communication.
Many people beyond you (and your IT department) will be reading the model, so it has to be accessible to them using tools they already have (or can acquire cheaply).
![Page 29: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/29.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
XMI
XML Metadata Interchange standardEvolved by the Object Management Group
(OMG)XML representation of object-oriented modelsUseful for custom reporting from the data in
your modelDoes not contain information about the
graphicsXMI allows generic metadata to be stored along
with the entities in your model
![Page 30: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/30.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
XMI
Metadata can then be extracted and reported
Use ordinary XML technologies for reporting
SAX, DOM parsing XML-object binding XSLT
Example: documenting information sources and reporting with XSLT
![Page 31: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/31.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Lessons Learned
Facilitation is criticalCan be successful in bringing together
business and technical expertsIterative processDomain modeling can accelerate the
development processFor most domain structures GJXDM is a
good fit, Exceptions: AssociationsProject completed with low cost open
tools
![Page 32: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/32.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Resources
Information Exchange Package Documentation Guidelines
Process Overview whitepaper (by justiceintegration.com, adopted by IJIS XML Advisory Committee)
Example IEPDs
![Page 33: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/33.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Resources
Domain-Driven Design, by Eric EvansUML Distilled, by Martin FowlerAnalysis Patterns, by Martin FowlerModeling XML Applications with UML,
by David CarlsonObject-Oriented Design Heuristics, by
Arthur Riel
![Page 34: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/34.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
IEPD Goals and Objectives
Remember: the goal is to exchange messages, not to build databases
The more we standardize the container and the payload of components, the more it supports our goals
Standard, non-proprietary, consistently structured artifacts helps all of us to leverage IEPDs as models for information sharing
![Page 35: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/35.jpg)
2004 SEARCH, The National Consortium for Justice Information and Statistics | www.search.org
Thank you!
Catherine [email protected]
Scott [email protected]
Jeff [email protected]
![Page 36: Case Studies on Information Exchange Package Documentation (IEPD) Development GJXDM Users Conference Atlanta, Georgia June 9, 2005.](https://reader030.fdocuments.in/reader030/viewer/2022032518/56649cca5503460f94993128/html5/thumbnails/36.jpg)
Case Studies on Information Exchange Package Documentation (IEPD) Development
GJXDM Users ConferenceAtlanta, Georgia
June 9, 2005