This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Requirements-Metadata

From HL7Wiki
Revision as of 08:04, 16 July 2009 by Lmckenzi (talk | contribs)
Jump to navigation Jump to search

This section lists metadata that is common to all HL7 stand-alone artifacts. In some cases, parts of this metadata also appears on child artifacts or components of artifacts. When this occurs, those artifacts will include a reference to this section.


Requirement All versions of HL7 specifications and stand-alone artifacts must have a unique identifier that permits: human readability, human recognizability and distributed assignment
Rationale Without a unique identifier, HL7 artifacts and their versions cannot be safely referenced by other HL7 artifacts or by other documents (RFPs, conformance claims) which use them. However in order to be useful in publications such as RFPs and within HL7 specifications, those identifiers need to be ones that can be recognized and interpreted by humans. Because HL7 artifacts will be created by a variety of organizations and groups, both within HL7.org and its affiliates as well as by implementers (e.g. templates and conformance profiles), it's essential that the identification scheme make provision for delegation of issuance of identifiers within discrete namespaces.
Methodology HL7 has adopted a "package-based" naming approach for both definitional and published versions of artifacts. This approach uses a hierarchy of packages to identify the type of artifacts within the package, the affiliate or other organizational namespace responsible for the artifact, the healthcare domain associated with the artifact, a unique identifier for the artifact within the context of the above and the version of the artifact.

Not all of these components will be present for all types of artifacts. The specific components, their order, their allowed values and lengths are all defined by HL7.

MIF
  • mif-core-base.xsd/Package/packageLocation
  • mif-core-base.xsd/Package/@name
  • mif-core-base.xsd/Package/@type


Requirement Most versions of HL7 specifications and stand-alone artifacts require a descriptive title
Rationale "DEFN=PO=RX=MT=123456=UV=01" is not terribly meaningful to most readers. Therefore a more semantically meaningful label for an artifact is required. This label should ideally be unique but is not subject to the same namespacing requirements as it is used for understanding, not for reference
MIF mif-core-base.xsd/Package/@title


Requirement Some HL7 specifications and stand-alone artifacts require a globally unique non-HL7-style identifier
Rationale These artifacts may need to be placed in a registry that is not HL7 specific and need a persistent identifier that can be used across multiple such repositories
MIF mif-core-base.xsd/Package/@secondaryId


Requirement HL7 specifications and stand-alone artifacts must be able to identify the artifacts they supersede or that have superseded them.
Rationale The standards world is dynamic. A specification that exists now may be replaced in a few years by a new version or even a completely different specification, or its requirements may be split across multiple specifications or merged together with other content into a new specification. When looking at a particular specification it's essential to know whether it's current, if it's not current, where to look for more current information and what information you already have that has been made obsolete by this new specification.
MIF
  • mif-core-base.xsd/Package/replaces
  • mif-core-base.xsd/Package/replacedBy


Requirement When looking at a particular serialized version of an artifact, it's useful to know information about the software that created that specification, including the time it was persisted, the application responsible for persisting it and any other rendering information
Rationale Tools occasionally have problems and knowing what tool created something when can be useful. It also provides a "non-dangerous" place for a tool to advertise itself.
MIF mif-core-base.xsd/Package/header/renderingInformation


Requirement Artifacts must be capable of expressing legal constraints including copyright information, licensing terms, disclaimers, policies around version management and any similar information
Rationale Artifacts are intellectual property, usage of artifacts may suggest legal responsibility. These and similar legal issues create the need for clear information about the rights and restrictions associated with the use of a particular artifact.
MIF mif-core-base.xsd/Package/header/legalese


Requirement With many specifications and stand-alone artifacts there's a need to capture information about the group and/or organization responsible for the artifact.
Rationale Knowing responsibility for an artifact can influence the level of comfort an implementer has in using the artifact. It's also a key piece of metadata for searching and cataloging artifacts.
MIF mif-core-base.xsd/Package/header/responsibleGroup


Requirement Specifications and stand-alone artifacts must be able to capture the contributors to that artifact including such information as name, role, affiliation, contact and other information.
Rationale Attribution is important for recognition, for level of trust in the artifact and to allow for follow-up if there are questions
MIF mif-core-base.xsd/Package/header/contributor


Requirement Specifications and stand-alone artifacts need to capture keywords
Rationale Keywords are a common mechanism within catalogs and repositories to allow discovery of a specification or artifact
MIF mif-core-base.xsd/Package/header/subject


Requirement There is a need to flag artifacts with the realms or organizations they're associated with.
Rationale Some artifacts are created with the intention of being used within multiple realms. Thus it's not possible to use only the realm included within the artifact id to determine "associated realm". Because this is a key piece of information for searching and cataloging artifacts, it needs to be captured.
MIF mif-core-base.xsd/Package/header/realmNamespace


Requirement Within a specification or stand-alone artifact there's a need to capture information about the approval status of that artifact
Rationale Reliance on an artifact is significantly changed if an artifact is draft vs. active vs. withdrawn. In addition, HL7 and ANSI rules require approval information when rendering artifacts for publication
MIF mif-core-base.xsd/Package/header/approvalInfo


Requirement Within the approval information for each artifact, there's a need to know the "status" of the artifact.
Rationale Artifacts may go through a variety of approval states. The level of approval indicates the reliability of the artifact and the level of review it's received and the level of review that is currently expected
Methodology
  • Draft: Content that is under development and is not intended to be used.
  • Non-standard - Available for use: Content developed independently by an organization or individual that is declared to be 'usable' but for which there is no present intention to submit through the standards submission and review process.
  • Proposal: Content submitted to a committee for consideration for future inclusion in the standard.
  • Committee Ballot - Normative: Content prepared by a committee and submitted for internal consideration as a normative standard.
  • Committee Ballot - Informative: Content prepared by a committee and submitted for internal consideration as an informative standard.
  • Membership Ballot - Normative: Content prepared by a committee and submitted for membership consideration as a normative standard.
  • Membership Ballot - Informative: Content prepared by a committee and submitted for membership consideration as an informative standard.
  • Membership Ballot - DSTU: Content prepared by a committee and submitted for membership consideration as a draft standard for trial use.
  • Approved Normative Standard: Content that has passed ballot as a normative standard
  • Approved Informative Standard: Content that has passed ballot as a normative standard
  • Approved DSTU: Content that has passed ballot as a draft standard for trial use
  • Affiliate Ballot - Normative: Content that is being presented to an international affiliate for consideration as a realm-specific normative standard
  • Affiliate Ballot - Informative: Content that is being presented to an international affiliate for consideration as a realm-specific informative standard
  • Reference: Content that is not intended to be balloted, but which exists to support other balloted content
  • Approved Affiliate Normative Standard: Content that has passed ballot as a realm-specific normative standard
  • Approved Affiliate Informative Standard: Content that has passed ballot as a realm-specific informative standard
  • Approved Affiliate DSTU: Content that has passed ballot as a realm-specific draft standard for trial use
  • Localized Adaptation: Content that represents an adaption of a implementable balloted material to represent the needs or capabilities of a particular installation.
  • Withdrawn: Content that represents an item that was at one point a normative or informative standard, but was subsequently withdrawn
MIF mif-core-base.xsd/Package/header/approvalInfo/@approvalStatus


Requirement
Rationale
MIF mif-core-base.xsd/Package/header/


Requirement
Rationale
MIF mif-core-base.xsd/Package/header/


Requirement
Rationale
MIF mif-core-base.xsd/Package/header/