Skip to content

Getting Started

Jump to bottom
Alberto edited this page Jan 13, 2016 · 5 revisions

Message Basics

  • WiFIS has been developed based on specific web services and methods that send and receive HL7 v2.5 in XML format.
  • WiFIS Easy Connect use MHS.3 / HD.2 content on each message to identify workflow and action.

For instance, workflow Derivacions and action DemanarNova:

<MSH.3>
  <HD.1>HOSPITAL</HD.1>
  <HD.2>#Derivacions#DemanarNova</HD.2>
</MSH.3>

Sending Messages

Hospital components

  • HIS sends information to an Ensemble Business Service (TCP, SQL, files, etc.).
  • Data is transformed into an HL7 message (EnsLib.HL7.Message) following WiFIS requirements.
  • HL7 message is sent to the WiFIS Easy Connect layer and it is delivered to WiFIS platform.

WiFIS Easy Connect components

  • Data transformation to convert HL7 message (EnsLib.HL7.Message) to WiFIS HL7 v.2.5 XML message.
  • Business Process that determines which operation is needed to send the message.
  • Business Operation that delivers message to WiFIS platform.

Example

WiFIS.V201.Test.Prod

  • Read an HL7 file, transform to WiFIS message and send it to a WiFIS webservice.
Component Description
Leer HL7 ER7 File Reads Files HL7 in ER7 format from a directory and sends them to WiFIS Crear Msg
Leer HL7 XML File Reads Files HL7 in XML format from a directory and sends them to WiFIS Crear Msg
WiFIS Crear Msg Receives an HL7 message, transforms it to XML and build a WiFIS GenericReq. Sends WiFIS GenericReq to WiFIS Router.
WiFIS Router Receives a message WiFIS GenericReq and send it to the appropiate operation
WiFIS X BO Operation which is a WebService client and sends SOAP messages

Receiving messages

WiFIS Easy Connect components

  • Business Service (WebService) for each workflows that will receive messages from WiFIS platform.
  • Data transformation that converts WiFIS messages into EnsLib.HL7.Messages.

Hospital components

  • Data transformation to convert WiFIS incoming EnsLib.HL7.Message to internal hospital format if needed.
  • Operation to send message to hospital system (e.g. SQL, HL7 TCP, files, etc.)

Example

WiFIS.V201.Test.Prod

  • Receives a message from WiFIS, transform to EnsLib.HL7.Message and writes it to file in ER7 and XML format.
Component Description
WIFIS.V.BS.X WebService that receives WiFIS messages. Build a WiFIS GenericReq and sends it to WiFIS ProcesarMsg
WiFIS Procesar Msg Receives a WiFIS GenericReq, transforms it to ER7 and sends it to Escribir HL7 ER7 Fichero and Escribir HL7 XML Fichero.
Escribir HL7 ER7 Fichero Receives an EnsLib.HL7.Message and writes and HL7 file in ER7 format.
Escribir HL7 XML Fichero Receives an EnsLib.HL7.Message and writes and HL7 file in XML format.

SAML Example

WiFIS.V201.Test.ProdSAML

  • This production is the same as WiFIS.V201.Test.Prod except for the use of components that generates SAML header using HC3SA libraries.

It is required to follow SAML Libraries installation to have WiFIS.V201.Test.ProdSAML working.

Component Description
SAMLjava Returns a SAML header which can be used to call to a WiFIS webservice. ConfigurationFile indicates which configuration file will be used to invoke the library HC3SA. ParameterFile indicates which parameter file will be used used to invoke the library HC3SA.
JavaGateway Service that manages the connection to the server JVM to invoke external Java libraries.

This package is an add-on for InterSystems Ensemble 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