HL7 V2 Authoring and Management Tool --Presentation to IHE-PCD John Garguilo, NIST National Institute of Standards and Technology Contact: john.garguilo@nist.gov WebEx (Recorded) 30 October 2013
IGAMT Overview (Disclaimer) The following slides and recorded presentation (via WebEx) is for informational purposes only The IGAMT is a concept exploring NIST s prototype development effort and is not a tool/application/software available or ready for general use (at this point in time) All feedback is welcome; all software produced by NIST is freely and publically available NIST acknowledges the terrific work by Peter Rontey and hopes that such development builds upon the Messaging Workbench (MWB) and keeps Pete s spirit of collaboration and contribution, continues the pursuit of better conformance criteria and profile definition, and most importantly keeps his wish alive 2
IGAMT Overview (start/intro of presentation) One of the primary goals is to get documentation into specifications that leads to or enables formal implementable and testable assertions This work is part of NIST s overall HITTI architecture and we believe is a key component to help users get at more consistent and accurate implementation guides. and provide in a more automated fashion information which can be directly consumed by the test system(s) and at the core provide context information MWB For those of you familiar w/ MWB, this pilot can be thought of as building on Peter Rontey s work by providing a web-based interface and more componentized functionality; Sara Stewart (NIST Contractor) will provide further details on this point For this demonstration/session the goal is to communicate our thinking and ask for (Industry) feedback (email, otherwise) Rob and Sara have demonstrated this work at the recent HL7 WG mtgs (including a session for the Healthcare Devices Group This work is lead by Rob Snelick and many thanks to Sara for her contributions timelines for the completion or availability of this pilot is not yet established but will be dependent on the next iteration of IHE tool support (e.g., post cycle 8 for PCD) and the next Winter/Spring 2014 MU set of requirements (Jan/Feb 2014) 3
HL7 V2 Authoring and Management Tool Robert Snelick, NIST (slide creator) National Institute of Standards and Technology Contact: rsnelick@nist.gov Sara Stewart, IGAMT Demonstration BAH (NIST Contractor)
IGAMT Productivity tool for creating profiles and implementation guides Standardization of conformance rules, vocabulary and structure Automation and Simplification of creation and editing of profiles and guides Machine-processable profiles and conformance statements, leading to integrated and quicker test tool development 5
Bigger Picture Authoring Tools (Create more testable specifications!) s (Number is increasing rapidly no profile created automatically) IHE HL7 v2 PIX/PDQ Technical Framework HL7 v2 MU Immunization Reporting s HL7 v2 MU Lab Results Interface (LRI) HL7 v2 MU incorporate Lab Results & Reportable Lab Results s ELINCS HL7 v2 Lab Orders and Results HL7 v2 s in General (HL7, CDC, PHIN, ISDS, ONC, etc.) IHE HL7 v2 PCD Technical Framework IHE HL7 v2 Technical Framework In General HL7 v2 MU Syndromic Surveillance 20+ IHE integration profiles using V2! Test Case Management Tool (Let domain experts help write the test cases!) Test Cases and Testing Artifacts Test System (Allow NIST/others to build tools quickly) 6
The Big Picture: HL7 V2 End-to-end Testing Support HL7 V2 Impl. Template Use Cases HL7 v2 Standard Message Definition General Transaction Constraints (e.g., IG, TF, or user input)¹ HL7 v2 Standard Value Sets Import Value Sets Domain Experts IG Template Wizard Use Case Development Message Profiling Vocabulary Profiling Disposition Traceability Utilities DITA XML Document Authoring & Management Tool Test Plan Template Conformance Profile Vocabulary Library Specification Validation Context File Test Case Requirements Impl. English Document Domain Experts and Test Case Developers Test Plan Development Test Case Development Constraint Test Script Data Sheet and Juror Document Document Data Management Message Generation Message Maker Test Case Management and Authoring Tool Conformance Profiles Vocabulary Libraries Test Case Specific Context Files Data Sheets Juror Documents Test Plan Execution Script Test Plan English Document Software Engineers Testing Environments Capabilities Test Agents Execution Engine Validation Engine Message Generation Engine Report Generation Communication Artifact Repository Testing Infrastructure Resource Bundle Test Plan Execution Script Tool Developers Web Applications Domain Specific Tools Testing Infrastructure Components Resource Bundle Management Test Plan Integration Validation Utilities Communication Documentation Testing Tools User Input Tool Generated ¹ Support existing specifications R. Snelick May 8 th, 2012 7
Current NIST process Analyze Manually Written Document Request clarification on conformance from authors and SMEs Analyze SME responses, manually written addendum and conformance guides created based on inquiries, as well as original MWB Constraint Specification Validation Context File Table Library Conformance Profile Value Sets Constraint Test Case Specific Validation Context File Table Library Validation Tool 8
Proposed IGAMT process HL7 V2 Impl. Template IG Template Wizard?? Code Java Library - Parser - Validation Use Cases HL7 v2 Standard Message Definition Use Case Development Message Profiling Vocabulary Profiling Conformance Profile Vocabulary Library Data Management Message Generation Message Maker General Transaction Constraints (e.g., IG, TF, or user input)¹ Disposition Traceability Utilities HL7 v2 Standard Value Sets Import Value Sets DITA XML Document Impl. English Document Domain Experts Authoring & Management Tool User Input Tool Generated 9
Messaging Workbench IGAMT Create Message profiles including XML Create Value Sets Create Data types Create Segment Libraries Create profile components x Validate attributes against standard Compare profiles Generate human readable forms of profiles and IG Provides template for IG x Condition predicate wizard x Conformance statement wizard x Modular reusable components x Deployable as web application x Download local copy of tool 10
Benefits of IGAMT Authors Implementers Testers Automatic validation Standardized implementation guides Machine processable profiles Templated format Standardized conformance statements Easily compare profiles, segments and data type libraries (i.e. any object). Single source publication- Automatic update of documents as changes are being made Easily view different components and sections of document as ballot discussion is happening Ballot tracking and comments (future) Standardized conformance statements Ability to create guide from profile and the profile components they choose. (Individual views of specification) Ability to automatically create own implementation profiles off of IG profiles. Ability to customize base IG to state or local requirements. Machine processable conformance statements Ability to start test tool development as the guide is being created 11
Components of IGAMT Message Profile Profile Components Value set Library Segment Library Data Type Library Comparison Utility 12
DEMO Wrapup 13
Current functionality Creation and editing of data type libraries, segment libraries and message profiles including setting of all attributes and comments These libraries integrate so that they can build upon one another, but remain separate so that pieces may be shared. Creation conformance statements and condition predicates through wizard Allows standardization of these statements towards machine processability. Creation of value sets from HL7 code tables including defining code usage. Validation of component attributes against the standard or another profile Comparison of profiles Creation of implementation guide using provided, editable template which integrates created message profile automatically Creation of printable versions of implementation guide, message profile tables (Abstract syntax and segments) and data type libraries 14
Future functionality Ability to import external value sets into tool Integration of value sets within Creation and integration of profile components Creation of use case and sequence diagrams and integration of those into Ballot and disposition tracking 15