Skip to content

Installation Upgrade

Jump to bottom
Alberto Fuentes edited this page Mar 12, 2020 · 10 revisions

Download installation files

Healthcare HL7 XML supports only:

  • InterSystems IRIS For Health.
  • Health Connect.
  • Ensemble >=2016.2

Go to Releases and download the latest version.

You can still download latest deprecated release v.2.1 (compatible with older Ensemble releases)

Unzip installation files

Unzip downloaded file in a temporary location (e.g. /tmp).

Load installer

  1. Open an interactive terminal session
  2. In the terminal session, change to your namespace (e.g. TEST) and load the installer.
USER>zn "TEST"
TEST>do $system.OBJ.Load("/tmp/Healthcare-HL7-XML-master/src/ITB/Installer.cls","ck")

Load started on 03/02/2020 16:14:26
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Installer.cls as udl
Compiling class ITB.Installer
Compiling routine ITB.Installer.1
Load finished successfully.

Run installer

Call the Run method of the installer from the Terminal session specifying the temporary directory where installation files were unzipped.

TEST>do ##class(ITB.Installer).Run("/tmp/Healthcare-HL7-XML-master")
START INSTALLER
2020-03-02 16:22:24 0 ITB.Installer: Installation starting at 2020-03-02 16:22:24, LogLevel=3
2020-03-02 16:22:24 3 Evaluate: ${BasePath}/src/ -> /tmp/Healthcare-HL7-XML-master//src/
2020-03-02 16:22:24 3 SetVariable: SourcePath=/tmp/Healthcare-HL7-XML-master//src/
2020-03-02 16:22:24 3 Evaluate: ${BasePath}/config/ -> /tmp/Healthcare-HL7-XML-master//config/
2020-03-02 16:22:24 3 SetVariable: ConfigPath=/tmp/Healthcare-HL7-XML-master//config/
2020-03-02 16:22:24 3 Evaluate: "${CreateNamespace}"="yes" -> "no"="yes"
2020-03-02 16:22:24 3 Evaluate: "${CreateNamespace}"="no" -> "no"="no"
2020-03-02 16:22:24 3 Evaluate: Using namespace ${Namespace} -> Using namespace TEST
2020-03-02 16:22:24 0 : Using namespace TEST
2020-03-02 16:22:24 3 Evaluate: ${Namespace} -> TEST
2020-03-02 16:22:24 3 Evaluate: ${SourcePath}ITB.inc -> /tmp/Healthcare-HL7-XML-master//src/ITB.inc
2020-03-02 16:22:24 1 Import: Loading /tmp/Healthcare-HL7-XML-master//src/ITB.inc (isdir=0) into TEST, recurse=0

Load started on 03/02/2020 16:22:24
Loading file /tmp/Healthcare-HL7-XML-master//src/ITB.inc as udl
ITB.INC Loaded
Load finished successfully.
2020-03-02 16:22:24 3 Evaluate: ${SourcePath} -> /tmp/Healthcare-HL7-XML-master//src/
2020-03-02 16:22:24 1 Import: Loading /tmp/Healthcare-HL7-XML-master//src/ (isdir=1) into TEST, recurse=1

Load of directory started on 03/02/2020 16:22:24

Loading file /tmp/Healthcare-HL7-XML-master/src/ITB.inc as udl
ITB.INC Loaded
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Installer.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Info.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BO/FileXMLOperation.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BO/HTTPXMLOperation.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Utils.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BO/TCPXMLOperation.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BO/TCPOperation.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/XMLHost.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BO/XMLOperation.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BS/FileXMLService.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BS/HTTPXMLService.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BO/XMLReplyStandard.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BP/NACKProcess.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BS/SOAPXMLService.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BS/TCPService.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BS/TCPXMLService.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/BS/XMLService.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/Util/XSDParser.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/Util/Convert.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/Format/HL7XMLv2.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Production/TestNACK.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/HL7/Data/NACK.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Production/TestXMLHL7File.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Production/TestXMLHL7HTTP.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Production/TestXMLHL7SOAP.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Production/TestXMLHL7TCP.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Production/TestXMLHL7TCPLoopback.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/TCP/FramedCommon.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/TCP/FramedInboundAdapter.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Task/PurgeNACK.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/TCP/FramedOutboundAdapter.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/Task/PurgeNoRef.cls as udl
Loading file /tmp/Healthcare-HL7-XML-master/src/ITB/UnitTest/HL7XML.cls as udl

Compilation started on 03/02/2020 16:22:25 with qualifiers 'cuk'
Class ITB.Installer is up-to-date.
Compiling 32 classes, using 6 worker jobs
Compiling class ITB.HL7.Format.HL7XMLv2
Compiling routine ITB.HL7.Format.HL7XMLv2.1
Compiling class ITB.HL7.Util.Convert
Compiling class ITB.HL7.Util.XSDParser
Compiling class ITB.Info
Compiling class ITB.HL7.XMLHost
Compiling class ITB.Production.TestNACK
Compiling class ITB.Production.TestXMLHL7File
Compiling class ITB.Production.TestXMLHL7HTTP
Compiling class ITB.Production.TestXMLHL7SOAP
Compiling class ITB.Production.TestXMLHL7TCP
Compiling class ITB.HL7.BS.TCPService
Compiling class ITB.Production.TestXMLHL7TCPLoopback
Compiling class ITB.TCP.FramedCommon
Compiling class ITB.HL7.BO.TCPOperation
Compiling class ITB.Utils
Compiling class ITB.UnitTest.HL7XML
Compiling class ITB.Task.PurgeNACK
Compiling class ITB.Task.PurgeNoRef
Compiling class ITB.HL7.Data.NACK
Compiling class ITB.HL7.BP.NACKProcess
Compiling class ITB.TCP.FramedOutboundAdapter
Compiling class ITB.TCP.FramedInboundAdapter
Compiling class ITB.HL7.BS.XMLService
Compiling class ITB.HL7.BO.XMLReplyStandard
Compiling class ITB.HL7.BS.TCPXMLService
Compiling class ITB.HL7.BS.HTTPXMLService
Compiling class ITB.HL7.BS.FileXMLService
Compiling class ITB.HL7.BO.XMLOperation
Compiling class ITB.HL7.BS.SOAPXMLService
Compiling class ITB.HL7.BO.TCPXMLOperation
Compiling class ITB.HL7.BO.HTTPXMLOperation
Compiling class ITB.HL7.BO.FileXMLOperation
Compiling table ITB_HL7_BP.NACKProcess_MasterPendingResponses
Compiling table ITB_HL7_BP.NACKProcess_MessagesSent
Compiling table ITB_HL7_BP.NACKProcess_MessagesReceived
Compiling table ITB_HL7_Data.NACK
Compiling table ITB_HL7_BP.NACKProcess
Compiling routine ITB.HL7.Util.XSDParser.1
Compiling routine ITB.HL7.BS.TCPService.1
Compiling routine ITB.HL7.XMLHost.1
Compiling routine ITB.Production.TestNACK.1
Compiling routine ITB.Production.TestXMLHL7File.1
Compiling routine ITB.HL7.Util.Convert.1
Compiling routine ITB.Production.TestXMLHL7HTTP.1
Compiling routine ITB.HL7.BO.TCPOperation.1
Compiling routine ITB.Production.TestXMLHL7SOAP.1
Compiling routine ITB.Production.TestXMLHL7TCPLoopback.1
Compiling routine ITB.Production.TestXMLHL7TCP.1
Compiling routine ITB.UnitTest.HL7XML.1
Compiling routine ITB.TCP.FramedCommon.1
Compiling routine ITB.Task.PurgeNACK.1
Compiling routine ITB.Task.PurgeNoRef.1
Compiling routine ITB.Utils.1
Compiling routine ITB.HL7.Data.NACK.1
Compiling routine ITB.HL7.BP.NACKProcess.1
Compiling routine ITB.HL7.BP.NACKProcessMasterPendingResponses.1
Compiling routine ITB.HL7.BP.NACKProcessMessagesReceived.1
Compiling routine ITB.HL7.BP.NACKProcessMessagesSent.1
Compiling routine ITB.TCP.FramedInboundAdapter.1
Compiling routine ITB.TCP.FramedOutboundAdapter.1
Compiling routine ITB.HL7.BS.XMLService.1
Compiling routine ITB.HL7.BO.XMLReplyStandard.1
Compiling routine ITB.HL7.BS.FileXMLService.1
Compiling routine ITB.HL7.BS.TCPXMLService.1
Compiling routine ITB.HL7.BS.HTTPXMLService.1
Compiling routine ITB.HL7.BS.SOAPXMLService.1
Compiling routine ITB.HL7.BO.XMLOperation.1
Compiling routine ITB.HL7.BO.TCPXMLOperation.1
Compiling routine ITB.HL7.BO.FileXMLOperation.1
Compiling routine ITB.HL7.BO.HTTPXMLOperation.1
Compiling class ITB.HL7.BS.SOAPXMLService.AcceptMessage
Compiling routine ITB.HL7.BS.SOAPXMLService.AcceptMessage.1
Compilation finished successfully in 1.488s.

Load finished successfully.
2020-03-02 16:22:26 3 Evaluate: ${ConfigPath} -> /tmp/Healthcare-HL7-XML-master//config/
2020-03-02 16:22:26 1 Import: Loading /tmp/Healthcare-HL7-XML-master//config/ (isdir=1) into TEST, recurse=1

Load of directory started on 03/02/2020 16:22:26

Loading file /tmp/Healthcare-HL7-XML-master/config/hl7_ITB.LUT as xml
Imported document: hl7_ITB.LUT
Loading file /tmp/Healthcare-HL7-XML-master/config/hl7_2.6.LUT as xml
Imported document: hl7_2.6.LUT
Loading file /tmp/Healthcare-HL7-XML-master/config/hl7_2.5.LUT as xml
Imported document: hl7_2.5.LUT
Loading file /tmp/Healthcare-HL7-XML-master/config/ITB.HL7 as xml
Imported document: ITB.HL7

Compilation started on 03/02/2020 16:22:27 with qualifiers 'cuk'
Compilation finished successfully in 1.503s.

Load finished successfully.
2020-03-02 16:22:29 0 ITB.Installer: Installation succeeded at 2020-03-02 16:22:29
2020-03-02 16:22:29 0 %Installer: Elapsed time 4.744894s
[2020-03-02 16:22:29] Version checking
[2020-03-02 16:22:29] __ITB.Info.VERSION=3.0
[2020-03-02 16:22:29] Version checking ended
[2020-03-02 16:22:29] UnitTest
===============================================================================
Directory: /opt/hl7xml/app/src/ITB/UnitTest/
===============================================================================
  src\ITB\UnitTest begins ...
Load of directory started on 03/02/2020 16:22:29 '*.xml;*.XML;*.cls;*.mac;*.int;*.inc;*.CLS;*.MAC;*.INT;*.INC'

Loading file /opt/hl7xml/app/src/ITB/UnitTest/HL7XML.cls as udl

Compilation started on 03/02/2020 16:22:29 with qualifiers ''
Compiling class ITB.UnitTest.HL7XML
Compiling routine ITB.UnitTest.HL7XML.1
Compilation finished successfully in 0.025s.

Load finished successfully.

    ITB.UnitTest.HL7XML begins ...
      TestBigField() begins ...
        AssertEquals:generated big stream of 6250 KB (passed)
        AssertStatusOK:er7->xml (passed)
        AssertStatusOK:xml->er7 (passed)
        AssertEquals:big stream with same size (passed)
        LogMessage:Duration of execution: .64664 sec.
      TestBigField passed
      TestER7ToXML() begins ...
        AssertStatusOK:Looping over *.hl7 files in /opt/hl7xml/app/unittest/hl7/ (passed)
        AssertEquals:2.5_OBX5-ST.hl7: reference HL7 XML file exists (passed)
        AssertStatusOK:2.5_OBX5-ST.hl7: import er7 file (passed)
        AssertStatusOK:2.5_OBX5-ST.hl7: doctype=2.5:ORM_O01 (passed)
        AssertStatusOK:2.5_OBX5-ST.hl7: ER7ToXML (passed)
        AssertEquals:2.5_OBX5-ST.hl7: XML conversion (passed)
        AssertEquals:2.5_ORMO01.hl7: reference HL7 XML file exists (passed)
        AssertStatusOK:2.5_ORMO01.hl7: import er7 file (passed)
        AssertStatusOK:2.5_ORMO01.hl7: doctype=2.5:ORM_O01 (passed)
        AssertStatusOK:2.5_ORMO01.hl7: ER7ToXML (passed)
        AssertEquals:2.5_ORMO01.hl7: XML conversion (passed)
        AssertEquals:ITB_ADTA01-EscapeField.hl7: reference HL7 XML file exists (passed)
        AssertStatusOK:ITB_ADTA01-EscapeField.hl7: import er7 file (passed)
        AssertStatusOK:ITB_ADTA01-EscapeField.hl7: doctype=ITB:ADT_A01 (passed)
        AssertStatusOK:ITB_ADTA01-EscapeField.hl7: ER7ToXML (passed)
        AssertEquals:ITB_ADTA01-EscapeField.hl7: XML conversion (passed)
        AssertEquals:ITB_OBX5.hl7: reference HL7 XML file exists (passed)
        AssertStatusOK:ITB_OBX5.hl7: import er7 file (passed)
        AssertStatusOK:ITB_OBX5.hl7: doctype=ITB:ORM_O01 (passed)
        AssertStatusOK:ITB_OBX5.hl7: ER7ToXML (passed)
        AssertEquals:ITB_OBX5.hl7: XML conversion (passed)
        AssertEquals:ITB_ORUR01-FT.hl7: reference HL7 XML file exists (passed)
        AssertStatusOK:ITB_ORUR01-FT.hl7: import er7 file (passed)
        AssertStatusOK:ITB_ORUR01-FT.hl7: doctype=ITB:ORU_R01 (passed)
        AssertStatusOK:ITB_ORUR01-FT.hl7: ER7ToXML (passed)
        AssertEquals:ITB_ORUR01-FT.hl7: XML conversion (passed)
        LogMessage:Duration of execution: .037302 sec.
      TestER7ToXML passed
      TestXMLToER7() begins ...
        AssertStatusOK:Looping over *.hl7.xml files in /opt/hl7xml/app/unittest/hl7/ (passed)
        AssertEquals:2.5_OBX5-ST.hl7.xml: reference HL7 ER7 file exists (passed)
        AssertStatusOK:2.5_OBX5-ST.hl7.xml: import er7 file (passed)
        AssertStatusOK:2.5_OBX5-ST.hl7.xml: doctype=2.5:ORM_O01 (passed)
        AssertStatusOK:2.5_OBX5-ST.hl7.xml: XMLToER7 (passed)
        AssertEquals:2.5_OBX5-ST.hl7.xml: ER7 conversion (passed)
        AssertEquals:2.5_ORMO01.hl7.xml: reference HL7 ER7 file exists (passed)
        AssertStatusOK:2.5_ORMO01.hl7.xml: import er7 file (passed)
        AssertStatusOK:2.5_ORMO01.hl7.xml: doctype=2.5:ORM_O01 (passed)
        AssertStatusOK:2.5_ORMO01.hl7.xml: XMLToER7 (passed)
        AssertEquals:2.5_ORMO01.hl7.xml: ER7 conversion (passed)
        AssertEquals:ITB_ADTA01-EscapeField.hl7.xml: reference HL7 ER7 file exists (passed)
        AssertStatusOK:ITB_ADTA01-EscapeField.hl7.xml: import er7 file (passed)
        AssertStatusOK:ITB_ADTA01-EscapeField.hl7.xml: doctype=ITB:ADT_A01 (passed)
        AssertStatusOK:ITB_ADTA01-EscapeField.hl7.xml: XMLToER7 (passed)
        AssertEquals:ITB_ADTA01-EscapeField.hl7.xml: ER7 conversion (passed)
        AssertEquals:ITB_OBX5.hl7.xml: reference HL7 ER7 file exists (passed)
        AssertStatusOK:ITB_OBX5.hl7.xml: import er7 file (passed)
        AssertStatusOK:ITB_OBX5.hl7.xml: doctype=ITB:ORM_O01 (passed)
        AssertStatusOK:ITB_OBX5.hl7.xml: XMLToER7 (passed)
        AssertEquals:ITB_OBX5.hl7.xml: ER7 conversion (passed)
        AssertEquals:ITB_ORUR01-FT.hl7.xml: reference HL7 ER7 file exists (passed)
        AssertStatusOK:ITB_ORUR01-FT.hl7.xml: import er7 file (passed)
        AssertStatusOK:ITB_ORUR01-FT.hl7.xml: doctype=ITB:ORU_R01 (passed)
        AssertStatusOK:ITB_ORUR01-FT.hl7.xml: XMLToER7 (passed)
        AssertEquals:ITB_ORUR01-FT.hl7.xml: ER7 conversion (passed)
        LogMessage:Duration of execution: .03812 sec.
      TestXMLToER7 passed
    ITB.UnitTest.HL7XML passed
  src/ITB/UnitTest passed

Use the following URL to view the result:
http://192.168.96.2:52773/csp/sys/%25UnitTest.Portal.Indices.cls?Index=1&$NAMESPACE=TEST
All PASSED
[2020-03-02 16:22:30] UnitTest ended

INSTALLER SUCCESS

This package is an add-on for InterSystems products and does not form part of the official release. InterSystems standard technical assistance will not attend issues related with this package.

Clone this wiki locally