Preparation for Tooling related Tutorials

From HL7Wiki
Jump to navigation Jump to search

With the development of a new Static Model Designer and other related enhancements to the HL7 specification publishing stream, the Tooling WG will be sponsoring updated Tutorials for at least two audiences - Modeling Facilitators in HL7 WGs and Projects, a more general audience interested in an overview of the tools HL7 uses to produce their specifications, and finally to potential tool development contributors. The target for the Oct WG meeting in Boston is for the Modeling Facilitators, with the other audiences as second and third priority, respectively.

The Tooling WG needs to consider Tutorials from both a Strategic and a Tactical perspective:

  • Strategically, what do we want our various audiences to know about Tooling in HL7
  • Tactically, what do we need to do to help modelers work with the new tooling environment.

Tactical

In Oct. there are two potential slots:

  • MnM Sunday Q4
  • Thursday Q3&4

Notes on what we'll need to prepare:

  • Presentation handout material needs to be assembled in machine readable form - HL7 is moving away form hardcopy handouts to save trees.
  • Participants are encouraged to bring laptops so some hands-on help to install and try out the new SMD is expected for the Modeling Facilitator audience and probably at least some for the other audiences
  • The old Tooling Tutorial that Woody and Lloyd were faculty for would need some major updating
  • We will need to identify faculty for the tutorials, and it would be good if more people were qualified to be faculty

Tutorials at October 2010 WGM in Cambridge MA

Background

Have two sessions scheduled or Cambridge:

  • Q4 on Sunday - targeted at existing Facilitators
  • Q3 and Q4 - Targeted at all users
    [Note: Be sure that existing facilitators can register at no cost.]
  • Suggest that core objectives are the same for each. The level of detail will be different.

Major objectives and Prerequisites

  1. Prerequisites for Attendees
    1. Will have completed the V3 Tutorials
    2. Will be familiar with the display and interpretation of "RMIM Designs" as presented in V3 Ballots and Normative Editions
    3. Will be familiar with the goals and overall capabilities of Model Interchange Format (MIF) representation of HL7 static model designs.
    4. Should be comfortable discussing the artifacts (file types) needed and the general issues surrounding the management of such files (source control, SVN, etc.)
  2. Objectives for Attendees in Building/Modifying Static models
    1. Installing the Static Model Designer(SMD) -
      1. Be able to install the SMD on a common (Windows-based) workstation or laptop
      2. Be able to distribute requisite source files, including previous design files in MIF
    2. Opening/creating a static model design
      1. Able to define a new SMD project (model)
      2. Able to import/open a static model defined by SMD
      3. Able to import/open a static model from a "UV" MIF file
    3. Ability to create/modify elements of static model
      1. Ability to change layout of design
      2. Ability to add classes, attributes, relationships
      3. Ability to set/change data types, vocabulary constraints, annotations
    4. Closing/saving a static model design
      1. Ability to save design and express as MIF file
      2. Ability to create graphic expression and an HTML-map for same
  3. Objectives for Attendees in Migrating UV Designs from Visio to SMD
    1. Importing and converting UV MIF files for use in SMD
    2. Laying out existing models in SMD
      1. Tricks to simplify layout
      2. Preferred layout patterns (based on previous layout?)
    3. Validating model content
    4. Verifying complete content from MIF to new Model
    5. File management of content from SMD (in contrast to Visio)