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

Difference between revisions of "Template:SAIF Generic IM Technology"

From HL7Wiki
Jump to navigation Jump to search
 
(11 intermediate revisions by the same user not shown)
Line 7: Line 7:
 
The '''primary distribution technology''' for this model SHALL be in a file that conforms to the [http://www.hl7.org/v3ballot/html/infrastructure/mif/mif.html HL7 Model Interchange Format] (MIF).  
 
The '''primary distribution technology''' for this model SHALL be in a file that conforms to the [http://www.hl7.org/v3ballot/html/infrastructure/mif/mif.html HL7 Model Interchange Format] (MIF).  
  
==="Ideal" model creation tool for this artifact===
+
The [[#Ideal model creation tool for this artifact|Ideal model creation tool for this artifact]] is defined in the
Would be a UML Modeling tool that has been customized to:
+
[[#Tooling Considerations|Tooling Considerations]] section of this document.  The "ideal tool" is used as "requirements" in the following discussion of current tooling and alternatives.
# Capture and represent the HL7-defined properties that are applicable to this model
 
#:
 
# Able to "read" and "write" the content in MIF format
 
## Including the graphic layout of the model
 
#:
 
#Able to define and document:
 
##Entry Points
 
##:
 
##Common model (CMET) references
 
##:
 
##Other model references, and
 
##:
 
##"Stub" classes
 
#:
 
# Able to enforce derivation constraints on the model using the RIM and Vocabulary Model (from MIF files) to configure these constraints dynamically
 
#:
 
#Able to configure the tool user interface using the RIM, Vocabulary Model and InterfacePackage (CMET file), provided as MIF files) to provide selections that are proper constraints and/or content from, these key derivation sources.  
 
#:
 
#Able to represent the graphic expressing on model classes using the HL7 [[Static Model BNF Grammar]]
 
  
 
===Current (April 2011) model creation tool for this artifact===
 
===Current (April 2011) model creation tool for this artifact===
<b>HL7 RMIM Designer</b> in Visio accomplishes all of the functions listed above, except 2., 2.1 and 3.3.  This tool is:
+
<b>[http://gforge.hl7.org/gf/project/visio-rmim-desi HL7 RMIM Designer]</b> in Visio accomplishes all of the functions listed for the [[#Ideal model creation tool for this artifact|''ideal tool'']], except 2., 2.1 and 3.3.  This tool is:
*Written in Microsoft Visio VBA (releases 2002, 2003, 2007, or 2010)
+
*Written in Microsoft Visio VBA (runs in releases 2002, 2003, 2007, or 2010)
 
*:
 
*:
 
*Has configurable editors - Clone [class] Editor, Vocabulary Selection pane, and CMET Selector - all of which
 
*Has configurable editors - Clone [class] Editor, Vocabulary Selection pane, and CMET Selector - all of which
**Get RIM configuration from Design Repository via RoseTree DLLs
+
**Get RIM configuration from a [http://gforge.hl7.org/gf/project/design-repos Design Repository] via [http://gforge.hl7.org/gf/project/rose-tree RoseTree] DLLs
 
**:
 
**:
**Get Vocabulary configuration from a Vocabulary "core MIF" file via RoseTree DLLs
+
**Get Vocabulary configuration from a Vocabulary "core MIF" file via [http://gforge.hl7.org/gf/project/rose-tree RoseTree] DLLs
 
**:
 
**:
 
**Get data types content and constraints from an RMIM Designer-specific text file
 
**Get data types content and constraints from an RMIM Designer-specific text file
Line 45: Line 26:
 
**Using Visio "VSD" files as the Visio-readable source and as the primary graphic storage
 
**Using Visio "VSD" files as the Visio-readable source and as the primary graphic storage
 
**:
 
**:
**Using an HL7-defined XML file of all content and annotations that includes all data needed to create a MIF representation.
+
**Using an HL7-defined XML file of all content and annotations that includes all data needed to create a [http://gforge.hl7.org/gf/project/mif-schemas MIF] representation.
 
**:
 
**:
 
*Has VBA functions to extract the graphic data as PNG files and a corresponding "mapped overlay" to provide "clickable graphics" that link to textual renderings of the model
 
*Has VBA functions to extract the graphic data as PNG files and a corresponding "mapped overlay" to provide "clickable graphics" that link to textual renderings of the model
 
*:
 
*:
*Requires support functions from the V3 Generator to:
+
*Requires support functions from the [http://gforge.hl7.org/gf/project/v3-generator V3 Generator] to:
**Create a MIF "output" file that includes graphic data (starting with the XML output from the RMIM Designer), and
+
**Create a [http://gforge.hl7.org/gf/project/mif-schemas MIF] "output" file that includes graphic data (starting with the XML output from the RMIM Designer), and
 
**:
 
**:
 
**Produce "table views" of the data to which the mapped overlays link.
 
**Produce "table views" of the data to which the mapped overlays link.
Line 62: Line 43:
 
**HL7-defined properties for many elements
 
**HL7-defined properties for many elements
 
*:
 
*:
* The model must be distributed as a machine-processable model represented in the [http://www.hl7.org/v3ballot/html/infrastructure/mif/mif.html HL7 Model Interchange Format] (MIF) in support of:
+
* The model must be distributed as a machine-processable model represented in the [http://gforge.hl7.org/gf/project/mif-schemas HL7 Model Interchange Format] (MIF) in support of:
 
**Using any particular model artifact as the "'''derived from'''" source for another model;
 
**Using any particular model artifact as the "'''derived from'''" source for another model;
 
**:
 
**:
**Support V3 Generator process that creates schemas for HL7 V3 specifications  
+
**Support [http://gforge.hl7.org/gf/project/v3-generator V3 Generator] process that creates schemas for HL7 V3 specifications  
 
**:
 
**:
**Support V3 Publishing and Normative Edition packaging processes  
+
**Support V3 Publishing and Normative Edition packaging and publication processes  
 
*:
 
*:
* The model must be derived from a predecessor model whose ultimate derivation source is the Reference Information Model (RIM)
+
* The model must be derived from a predecessor model whose ultimate derivation source is the [[Reference Information Model Artifact Definition|Reference Information Model]] (RIM)
 
*:
 
*:
 
* The model must declare bindings to:
 
* The model must declare bindings to:
** A Data Types Model to which its attributes are bound
+
** A [[Abstract Data Types Artifact Definition|Data Types Model]] to which its attributes are bound
 
**:
 
**:
** A Vocabulary Model to define the terminology bindings for its encoded attributes
+
** A [[Vocabulary Model Artifact Definition|Vocabulary Model]] to define the terminology bindings for its encoded attributes
 
**:
 
**:
** An Interface Package from which its interfaces are drawn
+
** An [[Interface Model Artifact Definition|Interface Model]] from which its interfaces are drawn
 
*:   
 
*:   
 
* Within the model the textual representation for properties governing class attributes is governed by the [[Static Model BNF Grammar]] specified by the Modeling and Methodology Work Group.
 
* Within the model the textual representation for properties governing class attributes is governed by the [[Static Model BNF Grammar]] specified by the Modeling and Methodology Work Group.
Line 82: Line 63:
 
=== Alternatives ===
 
=== Alternatives ===
 
<!-- What other technical solutions might have been possible that were discarded, what did they offer and why were they not chosen? -->
 
<!-- What other technical solutions might have been possible that were discarded, what did they offer and why were they not chosen? -->
An alternative tool, the NHS-supported Static Model Designer (SMD) has intended characteristics that meet all of the characteristics of the "ideal" tool (above) (except, in the early releases, 2.2 and 3.3) has been under development. As of April 2011, there is not sufficient funding to advance the tool to the point that it could replace the current tool suite.
+
An alternative tool, the NHS-supported [https://www.projects.openhealthtools.org/sf/projects/staticmodeldesigner/ Static Model Designer] (SMD) has intended characteristics that meet all of the characteristics of the [[#Ideal model creation tool for this artifact|"ideal" tool]] (except, in the early releases, 2.2 and 3.3) has been under development. As of April 2011, there is not sufficient funding to advance the tool to the point that it could replace the current tool suite.

Latest revision as of 22:02, 11 April 2011

Generic Artifact Technology content for SAIF Information models.
         Only the content appearing below in black font will appear in the inclusion.
These elements are intended to appear under the following section:

Artifact Technology

The primary distribution technology for this model SHALL be in a file that conforms to the HL7 Model Interchange Format (MIF).

The Ideal model creation tool for this artifact is defined in the Tooling Considerations section of this document. The "ideal tool" is used as "requirements" in the following discussion of current tooling and alternatives.

Current (April 2011) model creation tool for this artifact

HL7 RMIM Designer in Visio accomplishes all of the functions listed for the ideal tool, except 2., 2.1 and 3.3. This tool is:

  • Written in Microsoft Visio VBA (runs in releases 2002, 2003, 2007, or 2010)
  • Has configurable editors - Clone [class] Editor, Vocabulary Selection pane, and CMET Selector - all of which
    • Get RIM configuration from a Design Repository via RoseTree DLLs
    • Get Vocabulary configuration from a Vocabulary "core MIF" file via RoseTree DLLs
    • Get data types content and constraints from an RMIM Designer-specific text file
    • Get Interface Package contents from an RMIM Designer-specific text file
  • Saves primary content in dual files as:
    • Using Visio "VSD" files as the Visio-readable source and as the primary graphic storage
    • Using an HL7-defined XML file of all content and annotations that includes all data needed to create a MIF representation.
  • Has VBA functions to extract the graphic data as PNG files and a corresponding "mapped overlay" to provide "clickable graphics" that link to textual renderings of the model
  • Requires support functions from the V3 Generator to:
    • Create a MIF "output" file that includes graphic data (starting with the XML output from the RMIM Designer), and
    • Produce "table views" of the data to which the mapped overlays link.

Rationale

This information model artifact has several primary characteristics that act as requirements for the selected technology. These characteristics are:

  • The model is a UML Class model with extensions to UML to represent:
    • New shapes to represent Entry Points, Interfaces and stubs
    • HL7-defined properties for many elements
  • The model must be distributed as a machine-processable model represented in the HL7 Model Interchange Format (MIF) in support of:
    • Using any particular model artifact as the "derived from" source for another model;
    • Support V3 Generator process that creates schemas for HL7 V3 specifications
    • Support V3 Publishing and Normative Edition packaging and publication processes
  • The model must be derived from a predecessor model whose ultimate derivation source is the Reference Information Model (RIM)
  • The model must declare bindings to:
  • Within the model the textual representation for properties governing class attributes is governed by the Static Model BNF Grammar specified by the Modeling and Methodology Work Group.

Alternatives

An alternative tool, the NHS-supported Static Model Designer (SMD) has intended characteristics that meet all of the characteristics of the "ideal" tool (except, in the early releases, 2.2 and 3.3) has been under development. As of April 2011, there is not sufficient funding to advance the tool to the point that it could replace the current tool suite.