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

Difference between revisions of "RMIM Designer Documentation (DatatypeReleaseSupport)"

From HL7Wiki
Jump to navigation Jump to search
Line 1: Line 1:
 
{{RmimDesDoc/TabsSimple|4=1}}
 
{{RmimDesDoc/TabsSimple|4=1}}
 
<div style="margin-top:0.7em; margin-bottom:0.5em; text-align:left; font-size:98%; vertical-align:bottom; padding:3px">
 
<div style="margin-top:0.7em; margin-bottom:0.5em; text-align:left; font-size:98%; vertical-align:bottom; padding:3px">
<span style="font-weight:bold; font-Size=108%">[[{{PAGENAME}}#|Introduction]]&nbsp;·&nbsp;
+
<span style="font-weight:bold; font-Size=108%">[[{{PAGENAME}}#|Introduction]]&nbsp;</span>
[[{{PAGENAME}}#Data Type Conversion on Opening a Model|ConversionWhenModelOpens]]&nbsp;·&nbsp;
+
([[{{PAGENAME}}#Data Types Release Governed by RIM Loaded in RMIM Designer|DataTypeRelSetByLoadedRIM]]&nbsp;)
[[{{PAGENAME}}#Selecting_Vocabulary_Constraints|ConstraintSelection]]</span>
+
<span style="font-weight:bold; font-Size=108%">[[{{PAGENAME}}#Data Type Conversion on Opening a Model|ConversionWhenModelOpens]]&nbsp;·&nbsp;
([[{{PAGENAME}}#Proper Constraints by Attribute Kind|ProperConstraints]])&nbsp;·&nbsp;
+
[[{{PAGENAME}}#Fidelity Of Round-Trip Conversions|RoundTripConversionNote]])</span>
<span style="font-weight:bold; font-Size=108%">[[{{PAGENAME}}#Vocabulary_Browser|VocabBrowser]]</span>
 
([[{{PAGENAME}}#Selection Controls|Controls]]&nbsp;·
 
[[{{PAGENAME}}#Searching Content|Searching]])
 
 
</div>
 
</div>
 
==Introduction==
 
==Introduction==
Line 33: Line 30:
  
 
Note further, that this '''''conversion process does not save the converted model'''''.  The user must be sure to do this manually after the conversion process.
 
Note further, that this '''''conversion process does not save the converted model'''''.  The user must be sure to do this manually after the conversion process.
 +
==Fidelity Of Round-Trip Conversions==
 +
By and large, a properly constrained model in data types release one should convert to a properly constrained model in data types R2, and return to its original settings when re-converted to data types R1.

Revision as of 05:54, 8 October 2009

Overview   2010/11 Updates   VocabMIF   DataTypeReleases   BatchProcess   CommandLine   Errors/Install   Vis2002-3-7-10-13    

Introduction  (DataTypeRelSetByLoadedRIM ) ConversionWhenModelOpens ·  RoundTripConversionNote)

Introduction

With the advent of HL7 Data Types Release 2, it became necessary to provide the ability to migrate a design from data types R1 to data types R2, and vice versa. This is possible because the RIM expresses a specific mapping to be followed, and, with one exception, this process can be reversed with no changhe in the base model.

Data Types Release Governed by RIM Loaded in RMIM Designer

The RMIM Designer actually has two "states" - one in which it supports only data types R1, and one where it supports only R2. These states are established when the RMIM Designer first loads a RIM from an HL7 Design Repository. Historically, all RIMs from RIM version 0.8 through RIM version 2.26 are bound to data types R1. RIMs with versions 2.27 and later are planned to be bound solely to data types R2. If the loaded RIM is based on Data Types R1, the RMIM Designer will only support that data type release, and vice-versa.

At any given time, the current state of the RMIM Designer can be determined by selecting Menu...HL7...About This selection displays an "About" window, and the second section lists the version of the RIM (and data types) that are loaded along with the version of the Vocabulary that is loaded.

Data Type Conversion on Opening a Model

Whenever an RMIM Design is opened, whether manually or as part of a batch process, the RMIM Designer first ascertains the data type release of the model. (This is determined by a document tag discussed elsewhere.) If the data type release of the model does not match the current state of the RMIM Designer, the model cannot be opened without converting the data types.

If the document was opened manually, the following dialog will be opened. (Batch processing is covered in a separate section.)

Dialog when data types do not match on model load.

As seen in the dialog, if the RMIM designer and Model data types do not match, the user has three choices - change the model, change the loaded data types, or "back-out - as:

  • Continue and convert the model to the appropriate data type release. (Select: Yes)
  • Reload the RMIM Designer with a new RIM whose data types match the model. (Select: No)
    Be advised that this option will also cause the Vocabulary to be re-loaded, and the size of the Visio application in memory will become quite large. Each vocabulary load consumes about 500 MB of memory.
  • Terminate the loading process (back out). (Select: Cancel)

At the end of the conversion process, there will be an "Error" dialog that lists each attribute of the model for which the data type specification is not a proper restriction of the RIM data type for that attribute. This is an advisory note to the user. The "improper" data type will be assigned to the attribute.

Note further, that this conversion process does not save the converted model. The user must be sure to do this manually after the conversion process.

Fidelity Of Round-Trip Conversions

By and large, a properly constrained model in data types release one should convert to a properly constrained model in data types R2, and return to its original settings when re-converted to data types R1.