This wiki has undergone a migration to Confluence found Here

RMIM Designer Documentation (VisioReleaseDifferences)

From HL7Wiki
Revision as of 21:37, 3 March 2009 by Gwbeeler (talk | contribs)
Jump to navigation Jump to search

Changes At Time Visio 2003/7 Became a Viable RMIM Designer Platform

When the RMIM Designer was upgraded so that it could be run on Visio 2003/7 as well as Visio 2002, the software had additions for converting files from one format to the other; identifying the last version on which a static model design was edited; and a means of "reviving" a moribund RMIM Designer. These changes are summarized below.

File Conversions For Visio 2002-2003/7

It is necessary to convert drawings from Visio 2002 to Visio 2003/7 (and back) in order to maintain the correct display of the content. The upgrade addressed these as follows:

Update Designs for Visio 2003/7

This ONLY runs in Visio 2003/7

  • Auto-update and re-write
    Open Vis2002 diagram in Vis2003 - you will see a dialog box titled “Start Auto-Update” and “Starting Auto-update/Save of <file name>” Click OK and the drawing will be converted AND saved with the SAME NAME - over-writing the source Visio 2002 file.
  • Manual control
    To gain a LITTLE manual control, Select Menu...HL7...Shape updating...Change auto-updating for Vis2003 And then click “Yes” to switch to MANUAL control. In that case, opening a Vis2002 document in Vis 2003 presents a dialog “You are opening a Visio 2002 Design in Visio 2003. This file should be converted to Visio 2003 and have its shapes “revised”. Do you wish to do this automatically now?” Clicking “Yes” does the same as above. Clicking “No” requires manual updating as:
    1. Choose Menu...HL7...Shape Updating...ReviseShapes... (and confirm)
    2. Save the diagram to what ever directory and name you choose, and IF prompted to choose format, select “Current Visio Format” (meaning Vis2003)
  • Batch (bulk) upgrades.
    Click on the Template (RMIM2.vss) which now has its own menu. Select “Menu...HL7...Batch conversion/export ...Upgrade drawings from 2002 up to 2003 format (Batch)” This will allow you to select multiple files from a single directory. These will be automatically converted and the result will OVER-WRITE the source (like step 1)

Reverting Designs from Visio 2003/7 to Visio 2002

There is code available to automatically revert Visio 2003/7 drawings to Visio 2002. This only runs in Visio 2003/7.

  • Manual control
    Open a Visio 2003 design. Use File...Save as” and in the dialog, use the drop-down for “Save as type” and select “Visio 2002 Drawing(*.vsd)”
  • Batch (bulk) reversion
    Click on the Template (RMIM2.vss) which now has its own menu. Select “Menu...HL7...Batch conversion/export ...Revert drawings from 2003 back to 2002 format (Batch)” This will allow you to select multiple files from a single directory. These will be automatically reverted and the result will OVER-WRITE the source (like step 1)

Saving RMIM2.vss Stencil File

If you ever have to save the RMIM2.vss file in Visio 2003/7 select “Current Visio Format” (Visio 2003). Do not save this file as Visio 2002, as it will corrupt your future drawing changes

Reviving a Moribund RMIM Designer

Occasionally when you open a file or the software stops, you will find that the “Menu” items are all disabled, and the shape-based event processing does not work (Double-clicking a shape does not open the Clone editor). In this case, you need to re-connect the RMIM designer software to the drawing. Use the “AwakenDesigner” module from:

  • Use the Stencil menu (click on stencil window) and select:
    • Menu...HL7...Awaken RMIM Designer OR
    • Menu...Tools...Macros...(RMIM2)...AwakenDesigner...AwakenRMIMDesigner

The AwakenRmimDesigner entry runs a routine that:

  • Starts the EventCatcher if needed
  • Checks that RIM etc are loaded and active
  • Checks that all open windows have correct menus
  • Checks that all open windows are bound to the RMIM2 template

Tagging Designs as to Their Visio Version

I proved to be impossible to use the Visio “standard” document properties to distinguish designs in Visio 2002 format from those in Visio 2003/7 format. The RMIM Designer software saves a string in the Document.Category Property of the document as either “Visio2003-2007” or “Visio2000-2002”. This will be set by Visio 2003 whenever it “saves” a drawing programamatically, whenever it creates a new document, and whenever else it detects a mis-match.

If the category is not set (equivalent to “VisioUnknown” it assumes that the category should be “Visio2000-2002”, since most (hopefully all) Vis2003/7 documents will have the category assigned programatically.