Global Justice XML Data Model Naming and Design Rules
Total Page:16
File Type:pdf, Size:1020Kb
1 2 Global Justice XML Data Model 3 Naming and Design Rules 4 Draft Version 0.4, 23 August 2005 5 Editor: 6 Webb Roberts, Georgia Institute of Technology 7 Contributors: 8 Abstract: 9 This document specifies the data model, XML artifacts, and XML data for use with the 10 Global Justice XML Data Model. 11 Status: 12 This document is an early draft of a specification for GJXDM-conformant XML 13 components. This document is incomplete, and will undergo considerable revision before 14 being approved for use. This document will be updated by GTRI in concert with the 15 Global XML Structure Task Force (XSTF). 16 Please send comments on this specification to member of the XSTF. GJXDM NDR Draft Version 0.4 August 23, 2005 Page 1 of 49 17 Table of Contents 18 1. Introduction ............................................................................................................................. 5 19 1.1. Audience ........................................................................................................................5 20 1.2. The GJXDM XML Reference Architecture (In Brief) ...................................................... 5 21 1.3. Scope ............................................................................................................................. 7 22 1.4. Document Conventions.................................................................................................. 7 23 1.4.1. Logical Quoting...................................................................................................... 7 24 1.4.2. RFC 2119 Terminology ......................................................................................... 7 25 1.4.3. XML Information Set Terminology......................................................................... 8 26 1.4.4. XML Schema Terminology .................................................................................... 8 27 1.4.5. Normative and Informative Content....................................................................... 8 28 1.5. Syntax and Formatting ................................................................................................... 9 29 2. Guiding Principles ................................................................................................................. 10 30 2.1. Specification Principles ................................................................................................ 10 31 2.1.1. Minimal Specification........................................................................................... 10 32 2.1.2. Schema-Level Specification ................................................................................ 10 33 2.1.3. Specificity and Conciseness................................................................................ 10 34 2.2. Data Model Principles .................................................................................................. 10 35 2.2.1. RDF Data Model.................................................................................................. 10 36 2.2.2. Specialization of Types........................................................................................ 11 37 2.2.3. Specialization of Properties................................................................................. 11 38 2.3. Principles in the use of XML......................................................................................... 11 39 2.3.1. Invariant Content ................................................................................................. 11 40 2.3.2. Order of Data....................................................................................................... 11 41 2.3.3. XML Schema for Validation................................................................................. 12 42 2.3.4. Minimal implementation requirements................................................................. 12 43 2.3.5. Reference Schema Defines Namespace Contents............................................. 12 44 2.3.6. Reuse of Namespaces ........................................................................................ 12 45 2.3.7. Specific Typing .................................................................................................... 13 46 2.3.8. Avoidance of Wildcards....................................................................................... 13 47 2.3.9. Schema Location as a Hint.................................................................................. 13 48 2.3.10. Multi-pass Validation ........................................................................................... 13 49 2.3.11. No Mixed Content................................................................................................ 14 50 2.3.12. Application versus User Information.................................................................... 14 51 2.4. Design for Extensibility................................................................................................. 14 52 3. Relation to Standards ...........................................................................................................15 53 3.1. XML 1.0 ........................................................................................................................ 15 54 3.2. XML Namespaces........................................................................................................ 15 55 3.3. XML Schema................................................................................................................ 15 56 3.4. xml:id ........................................................................................................................ 15 57 3.5. ISO 11179 .................................................................................................................... 16 58 3.5.1. ISO 11179, Part 4................................................................................................ 16 GJXDM NDR Draft Version 0.4 August 23, 2005 Page 2 of 49 59 3.5.1.1. Formulation of data definitions......................................................................................16 60 3.5.2. ISO 11179, Part 5................................................................................................ 16 61 3.5.2.1. Object Class .................................................................................................................16 62 3.5.2.2. Representation Terms ..................................................................................................16 63 4. Normalized Structure ............................................................................................................19 64 4.1. xml:id ........................................................................................................................ 19 65 4.2. Structures Namespace................................................................................................. 19 66 4.2.1. Sequence ID........................................................................................................ 19 67 4.2.2. References .......................................................................................................... 20 68 5. Schema Naming and Design Rules...................................................................................... 23 69 5.1. General Schema Naming and Design Rules ............................................................... 23 70 5.1.1. Naming of Entities ............................................................................................... 23 71 5.1.1.1. Usage of English ..........................................................................................................23 72 5.1.1.2. Characters in Names....................................................................................................24 73 5.1.1.3. Use of Acronyms and Abbreviations.............................................................................24 74 5.1.1.4. Singular and Plural Forms ............................................................................................25 75 5.1.1.5. Character Case ............................................................................................................25 76 5.1.1.6. Mixed Content ..............................................................................................................25 77 5.1.2. Notations.............................................................................................................. 25 78 5.2. Schema Document Element ........................................................................................ 26 79 5.3. Import of Namespaces ................................................................................................. 27 80 5.4. General Type Definitions.............................................................................................. 28 81 5.5. Simple Type Definitions ............................................................................................... 28 82 5.6. Complex Type Definitions ............................................................................................ 29 83 5.6.1. Complex Content................................................................................................. 30 84 5.6.2. Exclusion of Wildcards ........................................................................................ 31 85 5.7. Element and Attribute Definitions................................................................................. 31 86 5.7.1. Specific Typing