U.S. Department of Justice Offi ce of Justice Programs Bureau of Justice Assistance Building Exchange Content Using the Global Justice XML Data Model: A User Guide for Practitioners and Developers SEARCH Developed in partnership with SEARCH, The National Consortium for Justice Information and Statistics * * * This document was prepared under the leadership, guidance, and funding of the Bureau of Justice Assistance (BJA), Office of Justice Programs, U.S. Department of Justice in collaboration with SEARCH, The National Consortium for Justice Information and Statistics. This project was supported by Award No. 2003-DD-BX-K014, awarded by the Bureau of Justice Assistance. i U. S. Department Of Justice Bureau of Justice Assistance June 2005 Dear Colleague: The U.S. Department of Justice Global Justice In March 2005, this information-sharing initiative Information Sharing Initiative and the resulting expanded to a new collaboration between the product, the Global Justice XML Data Model Department of Justice and the U.S. Department (GJXDM), represent an unprecedented government of Homeland Security. Recognizing that critical paradigm. Not only is GJXDM the result of a data regarding offenders and crimes is often local true partnership among local, state, and federal information, local agencies have begun adopting the practitioners, but it is also the result of an model and can now share information more effectively extraordinary collaboration with industry and than ever before. Placing the right information in the the private sector. Most important, GJXDM was right hands at the right time is a powerful resource in developed from the “ground up” by local users. the collective fight against terrorism and crime. Building GJXDM on this local vision is critical to From the novice user to the experienced technology the effectiveness and success of the initiative. While practitioner, the Global Justice XML User Guide I am currently the Director of the Office of Justice provides clear and consistent guidelines for GJXDM Programs’ Bureau of Justice Assistance, my nearly implementation, as well as reference architecture 20 years of justice experience at the state and local and best practices that have evolved since GJXDM’s level reinforce two axioms: that local control must release in 2004. Still in the early stages of information be at the core of every new policy and product, and sharing, we are nonetheless “ahead of the curve” and collaborations provide insight and a network for long- setting a new course for future generations. lasting change. Once a vision, Global Justice XML is now a reality in Pennsylvania’s Justice Network (JNET) system; in Maricopa County, Arizona; in Domingo S. Herraiz Los Angeles’s and Southern California’s regional Director information sharing; in the Wisconsin Justice Bureau of Justice Assistance Information Sharing Initiative (WIJIS) Gateway project; in my home state of Ohio; and in many other jurisdictions across America. ii Contents Acknowledgments ............................................ iv Part 4 Domain-Global Justice XML Data Model Mapping ........................................ 86 Executive Summary ........................................... v Part 5 Schema Building .................................. 89 Introduction: Part 6 Building Schema-valid Instances What This User Guide Is and Why It Is and Packaging ............................................... 103 Important Now ..................................................1 Module 005: Module 001: Global Justice XML Data Model Use Cases for Background/Overview of Global Justice XML Justice and Public Safety Data Model Development Part 1 Field Interview Report ........................ 104 Part 1 General Overview ..................................4 Part 2 Incident Report .................................. 109 Part 2 Enterprise Architectural Overview ........ 14 Part 3 Sentencing Order ............................... 118 Module 002: Part 4 Uniform Rap Sheet .............................121 General Object-oriented and XML Concepts Module 006: Part 1 Overview of the Global Justice XML Global Justice XML Data Model Funding and Data Model Framework ................................... 17 Conformance Part 2 Properties and Types ............................ 25 Part 1 Funding Requirements: U.S. Department Part 3 XML Schema Definition Standard ......... 30 of Justice and U.S. Department of Homeland Security Special Conditions ........................... 125 Part 4 Global Justice XML Data Model Naming Conventions ....................................... 32 Part 2 Global Justice XML Data Model Conformance Guidelines ................................ 127 Part 5 Namespaces ........................................ 36 Part 3 Global Justice XML Data Model Part 6 Metadata ............................................. 40 Conformance Guide for the Practitioner ..... 129 Module 003: Appendix 1: Global Justice XML Data Global Justice XML Data Model Content Model Feedback, Release Process, and Part 1 Architecture of the Global Justice Documentation .............................................. 131 XML Data Model .............................................. 50 Appendix 2: Global Justice XML Data Part 2 Global Justice XML Data Dictionary Model Tools and Resources .......................... 136 Core Components ........................................... 52 Part 3 Metadata in the Global Justice XML Appendix 3: Glossary of Justice and Data Model ...................................................... 59 Information Technology Terms ................... 141 Part 4 Code Tables and Enumerations in Appendix 4: Global Justice XML Data the Global Justice XML Data Model .................. 63 Model Partners ............................................... 154 Part 5 XML Schema Elements Versus Attributes ........................................................ 67 Part 6 Global Justice XML Data Model DocumentType ................................................70 Module 004: Using the Global Justice XML Data Model To Describe Real-life Justice Data Part 1 Exchange Document Development Process ........................................................... 74 Part 2 Exchange Document Project Inception ........................................................ 76 Part 3 Domain Modeling ................................. 79 iii Acknowledgments The Bureau of Justice Assistance (BJA) would like to thank the following members of SEARCH, The GJXDM User Guide Review National Consortium for Justice Information and Committee Statistics, for their dedication in producing this document: Scott Came Francis X. Aumand III, Chair Justice Integration Solutions Ronald P. Hawley, Executive Director Jeff Harmon Kelly J. Harris, Deputy Executive Director Maximus Catherine Plummer, Justice Information Gerry Coleman Systems Specialist Wisconsin Department of Justice Twyla R. Putt, Manager, Corporate Communications Ken Bouche Jane L. Bassett, Publishing Specialist Illinois State Police Pam Scanlon This User Guide would not have been possible Automated Regional Justice Information System without the significant contribution of the (ARJIS) engineers at the Georgia Tech Research Institute, who developed much of the technical Steve Prisoc content for this document. New Mexico Supreme Court John Ruegg BJA also acknowledges members of the Global Los Angeles County (California) Information XML Structure Task Force, who continue to guide Systems Advisory Body (ISAB) the development of the Global Justice eXtensible Markup Language Data Model (GJXDM). Robin Gibson Missouri Office of the State Court Administrator Last, but not least, BJA extends its thanks to Mark Kindl the members of the GJXDM User Guide Review Georgia Tech Research Institute (GTRI) Committee, a small cadre of justice practitioners Joe Mierwa with direct experience in the implementation VisionAir of GJXDM. Their contribution to the successful completion of this guide is very much Winfield Wagner appreciated. Crossflo Jim Cabral and Ellen Perry MTG Management Consultants Paul Embley Global XML Structure Task Force (XSTF) iv Executive Summary technologies, and have incorporated them into their systems’ architecture. However, they may still Accurate and germane sharing of information need instruction and examples defining information across jurisdictions is a critical issue for justice and exchange packages, queries, and messages using public safety. Although there has been significant GJXDM in a form that will ensure interoperability progress in the field of information technology, the among the justice and public safety community. lack of standards for exchanging justice data has In developing the outline for the User Guide, BJA not only been a major obstacle to, but also the realized that the guide could not focus on only one principal reason for, the high costs involved with audience; it needed to speak to users covering a justice information exchange. The development wide range of technical proficiency and readiness of a Global Justice XML Data Model (GJXDM) for implementation. represents a significant achievement in the process of developing standards for sharing justice For the new user, this User Guide provides a information. background and overview of the development of GJXDM, a general enterprise architectural Integral to the success of the Global Justice XML overview, and a baseline set of technical concepts standards effort is the promulgation of written derived from training material and documentation guidelines to facilitate GJXDM implementation by developed by the