# Presentation: 280519

## Global Justice XML Data ModelNaming and Design Rules

**17 August 2005**

## Outline

- Current status
- Inputs / influences
- What this spec is / is not
- Schedule
- Table of contents
- Introduction and scope
- Principles
- Rules
- Comparison to other NDRs

## Current Status

- Still being vetted by Global XSTF, not yet undergone the debate process
- Primary focus is currently on rule accuracy against 3.1
- Final draft will specify release version 3.1 (31 Oct 2005)
- Anticipate NDR rule modifications/refinements and new rules
- Anticipate changes to GJXDM
- Work remaining:
- new content (definitions and rules)
- explanations
- examples
- revision of relationships
- other conformance profiles

**Notes:**
At this time we are not addressing specific issues with GJXDM NDR draft. 
The GJXDM NDR is still very much preliminary. 

## Inputs and Influences

- Inputs:
- GJXDM
- OASIS LegalXML IJ TC GJXDM draft MNDR
- Fed-XML-NDR Working Group draft NDRG
- OASIS UBL NDR
- Influences:
- NIEM Steering Committee
- Federal Enterprise Architecture
- IJIS Institute
- OASIS LegalXML Integrated Justice TC
- National Center for State Courts
- Federal XML NDR Working Group

## What Spec Will Do or Be

- Product of the Global XSTF
- Technical specification for GJXDM 3.1
- Specify how GJXDM *IS* actually defined
- Format as close as possible to the UBL NDR document (as appropriate)
- Use/copy appropriate wording from other NDR documents (inputs)
- Will include:
- definitions
- principles
- rules, rationales, and explanations
- examples for rules

## What Spec Will NOT Do or Be

- NOT a projection of UBL on GJXDM
- NOT a comparison of UBL and GJXDM
- NOT a methodology for building Information Exchange Package Documentation (IEPDs) (i.e., NOT an “MNDR” – Methodology, Naming, and Design Rules)

## Schedule (tentative)

- 15 Jul	Internal Draft 1 XSTF review/comment
-   8 Aug	Internal Draft 2 XSTF review/comment
- 23 Aug	External Draft 1 review
- ...
- expect about 3 more drafts leading to ...
- 31 Oct	Target GJXDM release v3.1

## Table of Contents

- Introduction
- Scope
- Principles
- Relation to standards
- Normalized structure
- Schema rules
- Annotation rules
- Subset rules
- Instance rules
- Supporting Schemas
- References

## Introduction

- Background (very concise)
- Audience
- Brief description ofreference architecture
- Scope
- Document conventions

**Notes:**
background: system built around real requirements, from existing systems.  

## Scope addressed

- Specification for GJXDM 3.1
- Focused on definition of
- GJXDM-conformant schemas
- GJXDM-conformant reference schemas
- Subsets
- Documentation
- GJXDM-conformant instances

**Notes:**
Don’t get into the data model, just focused on the schemas

## Principles

- Principles guide creation of rules
- Some principles are design criteria
- Only rules are binding (enforceable)
- Format:  [Principle <number>]
- Currently 22 principles

**Notes:**
Principles are the basis, requirements, for the rules.  Foundation.  "all rules spring from the principles."
Arguments over rules may be arguments over principles.  Rules & Principles overlap.

## General Rule Format (example)

- Explanation ...

- Example	      	...

- Rationale		Using the representation term “Type” immediately identifies 			XML types in a GJXDM-conformant schema and prevents 			naming collisions with corresponding elements and attributes.

- [Rule GNR2]	GJXDM-conformant schemas SHALL use the representation 			term “Type” in the name of each non-enumerated XML type.

## Rule Categories

- ATD: Attribute Definition
- ATN: Attribute Naming
- CSR: Constraint Schema
- CTD: Complex Type Definition
- DOC: Documentation
- GNR: General Naming
- GXS: General XML Schema
- IND: Instance Document
- SSR: Subset Schema
- STA: Standards
- STD: Simple Type Definition
- STR: Structures

**Notes:**
VER – hasn’t been placed in here yet, still in discussion within XSTF

## References

- Citations and URIs for source specs
- XML specifications
- RFCs
- Schema for XML Schema
- EBNF notation

**Notes:**
Extended Backus Normal (Naur) Form

## Survey of NDRs

- OASIS IJTC GJXDM draft MNDR:
- 100 Rules
-  37 Definition
- Federal XML draft NDRG (to date):
-  10 Principles
- 159 Rules
- GJXDM draft NDR (to date):
-   22 Principles
- 110 Rules
-    5 Definitions

**Notes:**
Add count

## Summary

- Content development continues
- anticipated content (explanations, examples)
- new content (omissions, changes)
- XSTF vetting continues
- 170 comments databased for 1st draft
- debate, refine, reach consensus
- relationships
- non-conforming schemas
- External vetting as soon as possible
- Changes moving to GJXDM 3.1
- Impact of NIEM
*Change is the only certainty* [Marcus Aurelius]

**Notes:**
Non-conforming schemas - How to use external schemas SAML