New JIEM Release FAQs


What is the latest JIEM release?

The Justice Information Exchange Modeling (JIEM®) 5.0 Tool is an evolution of the previous Web-based tool, initially developed in 1998, and the Eclipse-based tool JIEM 4.1. Just like the previous tools, JIEM 5.0 continues to promote standards-based documentation of justice information sharing requirements. JIEM 5.0 supports best practices across the nation and maintains support of the JIEM methodology, which enables justice practitioners to form consensus around a small but powerful set of concepts that underlie the sharing of information: which agencies exchange information, under what conditions, in response to what events, and as part of what business processes. It improves the usability and efficiency of the tool, supports more rapid and economical addition of new features in the future, and provides more robust support for XML and integration with other modeling and development tools. JIEM 5.0 improves the tool's alignment with several Global Justice Information Sharing Initiative work products and allows more robust, seamless development of National Information Exchange Model (NIEM) Information Exchange Package Documentation (IEPD) artifacts.

Development of the JIEM methodology, Web-based JIEM Tool, reference models, and the new Eclipse-based version of JIEM have all been funded by the U.S. Department of Justice Bureau of Justice Assistance.

What additional features are included in JIEM 5.0?

The new JIEM 5.0 features enable users to:
  1. Document Privacy and Access Control Policies. Users can now document existing information exchange policies and rules in a structured, electronic manner that conforms to the Global Technical Privacy Framework. It allows the user to:
    1. Define metadata to create rules and policies, and (via JIEM reference models) reuse metadata that have been defined by national efforts, such as the Global Federated Identity and Privilege Management (GFIPM) initiative.
    2. Create reusable policies across exchanges.
    3. Use metadata to categorize elements in the JIEM Information dimension, linking data to policy. For example, a user can define a particular element in a NIEM IEPD as personally identifiable information (PII) and then write the policy constraints for PII, keeping all the policy and data categorization information in the JIEM model.
  2. Generate Global Reference Architecture (GRA) Service Specification Packages. In the GRA, each service must have a set of artifacts that describe its interface; this set of artifacts is called a Service Specification Package (SSP). Since users are able to model services in JIEM and link those services to JIEM exchanges, it is easy for JIEM to export the SSP for each service.
  3. Develop NIEM Information Exchange Package Documentation artifacts. JIEM 5.0 provides new features that assist users with creating NIEM-conformant IEPDs. A few of these features are:
    1. Full IEPD development. JIEM 5.0 allows users to build document, extension, constraint, and subset namespaces, and to export those namespaces as an IEPD schema set that conforms to the NIEM Naming and Design Rules (NDR). JIEM 5.0 gives users full control over the sharing of extension and subset/constraint namespaces across documents.
    2. NIEM wantlist import. JIEM 5.0 allows IEPD developers to make maximum use of existing IEPDS by supporting the import of NIEM and Global Justice XML Data Model (GJXDM) wantlists. (A wantlist file represents user requirements.) Users can import any wantlist that has ever been created by the NIEM Subset Schema Generation Tool (SSGT) into the JIEM Information dimension; users can then modify the resulting namespace contents to address new requirements.
    3. Conform to emerging NIEM guidelines. JIEM 5.0 supports the recent IEPD changelog and catalog files developed by the NIEM Technical Architecture Committee (NTAC). The JIEM Tool automatically generates the catalog from artifacts that it creates, reducing user workload.
    4. Create enumerated code lists. JIEM users can create their own code lists — known as enumerations — to meet local or project requirements. As with JIEM 4.1, code lists defined in NIEM or GJXDM are also available.

These new features provide JIEM users with a single tool that they can use to capture exchange requirements, information content and semantics, and service information, all in alignment with guidelines from NIEM and Global, and export finished artifacts critical to downstream development and implementation activities.

What is the Eclipse platform?

Eclipse is an open source tools platform that provides much of the basic infrastructure and functionality necessary to create analysis, modeling, and software development tools. Specific tool functionality is made available through software components called plug-ins. Tool developers have developed plug-ins for a vast array of tools since the Eclipse platform initially appeared in the late 1990s. Information on the Eclipse platform is available.

Why is the JIEM Tool deployed on the Eclipse platform?

There are several reasons behind the change from the Web platform to the Eclipse platform. SEARCH heard consistently from the JIEM user community that users wanted a version of the tool that could operate disconnected from the Internet. Users also desired more ability to customize the JIEM environment to suit their preferences, and to have the tool look and feel more like other requirements analysis or modeling tools that they have used. SEARCH also recognizes that it is important for JIEM to integrate easily and smoothly with other tools used to document information exchange requirements and develop exchange specifications, especially with XML standards such as the NIEM.

The Eclipse platform makes available a set of key capabilities for accomplishing these objectives in a cost-effective way. The JIEM Tool does not require a connection to the Internet. It allows considerable user customization of the tool's look and feel, and employs many "rich client" features that users experience in other modeling tools.

How does JIEM store my requirements?

JIEM stores requirements in an XML file. This file is maintained within an Eclipse "project," which is simply a folder in the user's file system. Projects can be stored on the user's workstation, on network drives, or in source control systems supported by Eclipse. A project can contain any number of JIEM models, and the user is able to create new models and projects as often as desired. All information in the model is stored in the XML file; no connection to external databases is necessary.

How can I share my JIEM models with others?

Because a JIEM model in JIEM 5.0 is simply an XML file, users are able to share models through ordinary means (email, shared file systems, etc.). SEARCH hosts the JIEM Community Site where JIEM-certified users can download JIEM models that other users have shared with SEARCH for publication. The current Adult Felony Reference Model is available on this site for download, and future JIEM reference models developed by SEARCH based on research will be made available on the JIEM Community Site as well.

JIEM allows users to create new JIEM site models by copying selected content from existing site models (including those created by other users, as well as reference models published by SEARCH).

What are the system requirements for using JIEM 5.0? How do I install it?

All that is required to run the JIEM Tool is a Java runtime, at version 1.6 or above. SEARCH is unable to distribute Java runtimes, but the standard Java runtime can be downloaded free of charge from Sun Microsystems.

The JIEM Tool installation process is covered in the JIEM training offered by SEARCH to individuals who are not yet JIEM-trained and -certified, or through the JIEM 5.0 Quick Start Screencast offered by SEARCH to current JIEM-certified users. The JIEM 5.0 Tool is installed using a simple installation program. The tool makes no registry edits or other changes to the user's workstation, so uninstalling the tool (if desired) is accomplished by simply deleting the directory into which the tool is copied.

SEARCH can provide users with assistance in installing the tool, if needed. Contact jiem@search.org to request assistance.

The Java runtime, Eclipse platform, and JIEM Tool plug-ins are all available free of charge, so there continues to be no cost involved in obtaining the tool.

If I'm certified in a previous version of JIEM, how do I obtain a copy of the JIEM 5.0 Tool?

JIEM-certified users may obtain a copy of the tool by accessing the JIEM 5.0 Quick Start Screencast and Installation file download links on the JIEM Community Site. This screencast is available to any previous version JIEM-certified users. The screencast takes approximately 90 minutes and provides instruction on obtaining the new tool, installation, and usage of new features in JIEM 5.0. SEARCH will continue to develop and offer new "Quick Start" screencasts for each future released version of JIEM.

If I'm not JIEM-certified, how to I obtain a copy of the JIEM 5.0 Tool?

Those who are not currently JIEM-certified may take online JIEM Certification Training and become certified in JIEM 5.0. During the self-paced certification course, users will receive download and installation instructions for the JIEM 5.0 Tool.

How will I obtain updated versions of the tool over time?

SEARCH will continue to develop and offer "Quick Start" training screencasts for each future released version of JIEM. Each screencast will provide users with the ability to download the latest version of the JIEM Tool, along with descriptive information about the new features.

Is training available on the JIEM 5.0 Tool?

Yes, SEARCH currently provides online training for the JIEM 5.0 Tool. For new users, the online course includes instructional modules, the certification exam, and the JIEM installation files. For users who are already certified in a previous version of JIEM, we offer a shorter JIEM 5.0 Quick Start Screencast to train them on using the new features of JIEM 5.0. JIEM training is provided through grant funding from the U.S. Department of Justice Bureau of Justice Assistance.

How long will the Web-based version of JIEM continue to be available?

SEARCH no longer offers the web-based version of the Justice Information Exchange Model (JIEM 3.4) and, after December 31, 2010, will no longer offer support for the site models.

The latest JIEM Tool, version 5.0, was released on November 10, 2010. JIEM version 4.1 will continue to be supported and available to users. All features of the web-based version of JIEM have been migrated into the new JIEM tools, and all JIEM program resources are now devoted to assisting users with the latest version.

Existing JIEM 3.4 users are able to gain support for their transition to either JIEM 4.1 or the latest JIEM 5.0 before December 31, 2010, and should contact jiem@search.org for assistance. SEARCH will archive the JIEM 3.4 database on December 31, 2010, and store a backup for the foreseeable future, allowing SEARCH to retrieve any data in the future, if necessary.

Note: If you are a consultant requesting the conversion of a WebJIEM site database on behalf of a jurisdiction, please see the question below: "I am a consultant and wish to request conversion of WebJIEM information on behalf of a jurisdiction with which I've been working. How do I do that?"

What will happen to models/requirements that I have documented in WebJIEM?

The new JIEM Tool includes a feature allowing users to import an archive file created in the Web-based tool. This allows complete transfer of all data from the Web-based tool into the new tool; no information is lost in the transfer.

SEARCH will assist in archiving Web-based site databases and creating site model XML files usable in JIEM 4.x and JIEM 5.0; this service is covered in the JIEM 5.0 Quick Start Screencast, and is available upon request to jiem@search.org.

Note: If you are a consultant requesting the conversion of a WebJIEM site database on behalf of a jurisdiction, please see the question below: "I am a consultant and wish to request conversion of WebJIEM information on behalf of a jurisdiction with which I've been working. How do I do that?"

What will happen to models/requirements that I have documented in JIEM 4.x?

The new JIEM Tool includes a feature allowing users to import an archive file created in previous versions of the tool. This allows complete transfer of all data from the earlier version of the tool into the new tool; no information is lost in the transfer.

SEARCH will assist in archiving site databases and creating site model XML files usable in JIEM 5.0; this process is covered in the JIEM 5.0 Installation instructions available on the JIEM Community Website.

Note: If you are a consultant requesting the conversion of a JIEM site database on behalf of a jurisdiction, please see the question below: "I am a consultant and wish to request conversion of WebJIEM or JIEM 4.x information on behalf of a jurisdiction with which I've been working. How do I do that?"

I am a consultant and wish to request conversion of WebJIEM or JIEM 4.x information on behalf of a jurisdiction with which I've been working. How do I do that?

SEARCH believes that practitioners who invest their resources in capturing information exchange requirements in JIEM should remain in control of that information while it resides on SEARCH's servers. As such, if a third party (e.g., consultant) wishes to request conversion of a WebJIEM site database for use in JIEM 4.x or JIEM 5.0 on behalf of a practitioner or justice agency, we require that the practitioner (or a representative of the practitioner's agency) submit a request for the conversion that authorizes our disclosure of the information to the third party. The request should be sent via email to jiem@search.org and should identify the WebJIEM site database(s) that SEARCH is authorized to convert.

Is the JIEM Adult Felony Reference Model still available?

Yes. SEARCH has created a site model XML version of the Adult Felony Reference Model and it is available at the JIEM Community Site for JIEM-certified users to download and use in JIEM 4.x or JIEM 5.0.

How does a team or workgroup collaborate on a Site Model using JIEM?

Five options are available to allow collaborative team work on a Site Model using JIEM 5.0:

Network storage/access — Team members can save JIEM Site Models as XML files on a shared network device to facilitate collaboration. Once the Site Model is on the shared network device, team members may open, view, edit, and save the Site Model. The advantage to this approach is that it requires no special set-up other than defining a common accessible storage location. The disadvantage to this approach is that it does not maintain copies of each version of a site model (for "rollback" purposes). This approach also permits simultaneous (and potentially conflicting) edits to the site model.

Email — JIEM Site Models may be shared with others as simple email attachments, allowing one user to take over editing when another user is finished. This is also a simple solution, but has the major drawback that simultaneous edits to multiple copies of a site model would need to be integrated back into a single model.

Source Control — Eclipse, the platform on which JIEM is based, supports source control environments, allowing version control of Site Models that can be checked in and out by team members for viewing and editing. Eclipse has a built-in capability to interface to CVS, and clients are available for most common environments, such as Subversion, Perforce, Clear Case, etc. Subversion and CVS are both open source tools that can be installed at no cost.

Reports — The most common way users have collaborated over site model development is the old-fashioned way: on paper. In our experience, many users prefer to review and validate the site models by reviewing printed reports or by viewing the site model together. SEARCH has developed a complete set of reports that document all aspects of the site model and can be used in this fashion.

Information Exchange Package Documents (IEPD) — JIEM 5.0 can export an information dimension model for one or more JIEM documents as a NIEM-conformant IEPD. The export wizard creates schemas, mapping spreadsheets and other artifacts, per established best practices and guidelines, necessary for subsequent development and implementation. The IEPD can be shared with team members and exchange partners for collaboration.