This document specifies general conformance guidance, principles, and rules for the National Information Exchange Model (NIEM) version 5.0.
This document is a draft of the specification for general NIEM conformance. It represents the collaborative work of the NIEM Business Architecture Committee (NBAC) and the NIEM Technical Architecture Committee (NTAC).
This document is a product of the NIEM Management Office (NMO).
Updates, revisions, and errata for this specification are posted to https://github.com/NIEM/NIEM-Conformance-Spec. Please submit comments on this specification as issues at https://github.com/NIEM/NIEM-Conformance-Spec/issues.
This document specifies general conformance guidance, principles, and rules for the National Information Exchange Model (NIEM) version 5.0.
This is a high-level document that defines NIEM conformance including how it applies and to what it does and does not apply. The intended audience includes NIEM developers and users.
This specification includes other NIEM specifications by reference. Non-normative information, including tools and implementation guidance are also published at https://niem.github.io.
Conformance to NIEM is defined in terms of artifacts. NIEM defines various conformance targets as the classes of artifacts to which sets of normative rules apply, as defined in the [NIEM Conformance Targets Attribute Specification 3.0] Section 3.1, Conformance Target Defined.
NIEM conformance targets include:
Documents may use the attribute defined in the [NIEM Conformance Targets Attribute Specification 3.0] Section 1.3, Description of the Conformance Targets Attribute to claim that the document conforms to one or more NIEM conformance targets.
A conformant instance document is an instance of a conformant schema document set that conforms to all applicable rules in the [NIEM NDR 5.0].
A conformant schema document set is a collection of schema documents that conform to all applicable rules in the [NIEM NDR 5.0].
A schema document that copies, maps to, or uses the data component names of NIEM document schemas or the data components they contain without importing corresponding NIEM target namespaces does NOT conform to NIEM. Conforming to NIEM requires that a schema document reuse NIEM by importing through xs:import the target namespaces of NIEM reference schema documents or schema subset documents of NIEM reference schema documents.
A conformant message specification is a package of files that conforms to the rules specified in the [NIEM IEPD Specification 5.0].
NIEM conformance is NOT defined in terms of implementations, databases, systems, or tools.
In describing an implementation that employs NIEM, an author should be as descriptive as is necessary to convey clear understanding of how NIEM is used and which conformance targets are supported.
An implementation that sends and receives NIEM-conformant instance documents on a transmission medium is considered a NIEM-based information exchange. An implementation may apply encryption, compression, encoding (e.g. Efficient XML Interchange (EXI) encoding [Efficient XML Interchange (EXI)]), or other security and/or efficiency techniques to an NIEM instance document as required; and it will still represent a NIEM information exchange. NIEM is a payload layer and, as such, a NIEM-conformant instance document may be contained within a standard envelope (such as SOAP, LEXS, etc.).
A tool or system, such as a database, may have capabilities designed to support:
Such tools and systems may be considered NIEM-aware or NIEM-supporting.
A registry of NIEM-aware tools is available at [NIEM Tools Catalog].
If an existing NIEM component matches the business semantics required by the message specification, then that component is used by the message specification, either directly or as the basis for derived components. That is, the message specification does not unnecessarily duplicate NIEM components.
Each NIEM schema component used by the message specification, either directly or as the basis for derived components, is used in a manner consistent with the component's structural definition and business semantics. That is, the message specification preserves semantic and structural consistency.
Reference schema document sets (i.e., NIEM releases, domain updates, and core updates) are subject to rigorous quality and conformance testing by the NIEM MO to ensure they conform to the [NIEM NDR 5.0].
Message specifications, message instances, and schema document sets other than those listed above are not under the control of the NIEM MO and no formal certification process exists. Therefore, it is important for NIEM users and developers to understand and make a concerted effort to ensure message specifications they produce conform to the [NIEM IEPD Specification 5.0].
[NIEM Conformance Targets Attribute Specification 3.0]: Attribute Specification, Version 3.0,
NIEM Technical Architecture Committee (NTAC). Available from https://reference.niem.gov/niem/specification/conformance-targets-attribute/3.0/.
[NIEM NDR 5.0]: NIEM Naming and Design Rules, Version 5.0,
NIEM Technical Architecture Committee (NTAC). Available from https://reference.niem.gov/niem/specification/naming-and-design-rules/5.0/.
[NIEM IEPD Specification 5.0]: NIEM Information Exchange Package Documentation (IEPD) Specification, Version 5.0,
NIEM Technical Architecture Committee (NTAC). Available from https://reference.niem.gov/niem/specification/model-package-description/5.0/.
[NIEM Tools Catalog]: NIEM Tools Catalog,
NIEM Management Office (MO). Available from https://www.niem.gov/tools-catalog.
[Efficient XML Interchange (EXI)]: Efficient XML Interchange (EXI) Format 1.0 (Second Edition),
W3C. Available from https://www.w3.org/TR/exi/.