The NIEM Naming and Design Rules (NDR) describes the architecture of the NIEM data model and its representation in XML. It specifies principles and enforceable rules for NIEM data components and schemas.
NDR rules are intended to establish and, more importantly, enforce a degree of standardization across a broad set of users in order to improve precision and interoperability across the NIEM community.
The NDR describes and defines rules for four different kinds of documents, each identified by its own NDR conformance target.
Refer to the section about the Conformance Targets Attribute Specification for more information, including how to specify a conformance target in a NIEM schema.
|REF||REF||Reference Schema Document||A NIEM schema that provides authoritative definitions of broadly reusable schema components and follows a stricter syntax. NIEM release schemas are REFs.||Link|
|EXT||EXT||Extension Schema Document||A NIEM schema for special-purpose content with little reuse expected. EXTs may thus follow a slightly more relaxed syntax. IEPD extension schemas are often EXTs.||Link|
|SET||SET||Conformant Schema Document Set||A single conceptual XML schema that represents the sum of all rules and definitions within a collection of NIEM REF and EXT schemas, such as an IEPD.||Link|
|INS||INS||Conformant Instance Document||An XML instance document which is valid against a conformant schema document set (SET).||Link|
Reference schema documents (REFs) are NIEM schemas that provide authoritative definitions of broadly reusable schema components and follow a stricter syntax, as specified by the NDR. NIEM release schemas are REFs.
The conformance rules for reference schema documents are generally stricter than those for extension schema documents (EXTs). This is because REFs are intended for reuse and must be defined in a way that supports a broad variety of requirements.
Extension Schema Documents (EXTs) are NIEM schemas for special-purpose content that is not expected to be reused outside of the specific package in which it is defined. EXTs may thus follow a slightly more relaxed syntax, as specified by the NDR. IEPD extension schemas are usually EXTs, but may be designated as REFs instead if needed.
Extension schema documents (EXTs), like reference schema documents (REFs), are a fundamental part of NIEM model design. They contain components that use, extend, or limit the components defined in REFs and express additional vocabulary above and beyond the vocabulary available from REFs.
A Conformant Schema Document Set (SET) is a single conceptual XML schema that represents the sum of the rules and definitions defined within a collection of NIEM REF and EXT XML schemas, such as an IEPD.
Because schema document sets are composed of NIEM-conformant schema documents (either REF or EXT), each member document must adhere to the rules designated by their individual conformance targets. Furthermore, the document set must also adhere to the rules applicable to the conformance target SET.
A SET defines a schema that may be used to validate an instance document. This rule ensures that a SET under consideration contains definitions for everything that it references; it has everything necessary to do a complete validation of instance documents without any unresolved references.
An Conformance Instance XML Document (INS) is an XML instance document which is valid against a conformant schema document set (SET).
While some rules in the NDR require subjective judgment (like determining if component names and definitions are semantically meaningful), other rules are capable of being automated. Starting with NDR version 3.0, such rules have been written as Schematron rules. Schematron is an ISO specification that describes a validation language for assertions about XML documents.
Schematron representations of NDR rules provide several key benefits. There is a single, normative interpretation of each rule. This eliminates the possibility that different users might read read a free-text rule description and apply it in different ways.
Schematron rules can also be used to validate XML documents. This makes it substantially easier for users to test NIEM REF and EXT XML schemas against the NDR to see if those schemas conform to the given NDR conformance target.
Refer to the NDR for the full set of rules. Descriptions, principles, and/or examples often accompany each rule. The NDR Table of Contents and the rules index in the Appendix can be used to jump directly to particular topics.
XML sub-pages in the Concepts section to a collection of rules relating to particular topics. For example, the Namespaces XML page contains a list of NDR rules related to a namespace and its representation in NIEM XML (a XML schema).
The image below shows a small excerpt from the NDR.
Rule 10-47is a descriptive, free-text rule. Conformance for this rule must be checked manually.
Rule 10-48is written in Schematron and can be tested via ConTesA or Oxygen.
See more information about the Naming and Design Rules Specification: