Setting Up and Running the HL7 Examples

Use the following information to set up and run ActiveMatrix BusinessWorks Plug-in for HL7 with FHIR examples.

Note: You should be familiar with the plug-in before running the examples.

Copy Guidelines and Maps

The HL7 examples make use of guidelines and maps. Before using any of the examples, you must copy the associated files to the appropriate directory.

For each example, guidelines and map files are found in the \Guidelines directory for the example. For example, \bw\palettes\hl7\<version_number>\samples\ParserAndRenderer\DataAndGuidelines\Guidelines.

Copy the guideline and map files as follows:

  1. Copy the .std, .xsd, and .map files to the \Database directory of Foresight Translator.
  2. Copy the .std files to the \Database directory of Foresight Instream.

Note that the .std files are copied to the \Database directory for Foresight Translator and Foresight Instream.

Importing an Example

Use the following steps to import an example:
  1. Select File > Import.

    The Import screen appears.

  2. Select Existing Studio Projects into Workspace.

    The Browse For Folder screen appears.

  3. Browse to the location of the desired HL7 samples. By default this is the <BW_Home>\palettes\hl7\<version_number>\samples directory, as shown here:

    Note: The path is different if you have saved the samples to another location.

Optional: Set Environment Variables for the Process

Instream and Translator environment variables should have been set as part of the ActiveMatrix BusinessWorks Plug-in for HL7 with FHIR Post-installation tasks (refer to TIBCO ActiveMatrix BusinessWorks™ Plug-in for HL7 with FHIR Installation). Doing so tells ActiveMatrix BusinessWorks where to access the Instream and Foresight Translator executables when the products are used in an ActiveMatrix BusinessWorks Plug-in for HL7 with FHIR process.

It is also possible to specify environment variables on a per-process basis. The following procedure instructs the process to utilize the variables specified for the process instead of those specified for ActiveMatrix BusinessWorks at the higher level.

Refer to the appropriate section for your operating system:

For Windows Platforms
  1. Open the desired process and click within the process.
  2. Select Run > Run Configurations....

    The Run Configuration screen appears.

  3. Select the environment tab and double click PATH.

    The Edit Environment Variable screen appears.

  4. Add the path to the desired location of the Instream\bin and Translator\bin directories at the beginning of the string, before the first $ character, and with a ; at the end of each segment of added text.
    Note: Do not delete the existing string, simply add information at the beginning.

    Example:

    C:\tibco64\instream\8.5\bin;C:\tibco64\translator\3.5\bin;${env_var:FTL_HOME}...

  5. Select Apply.
  6. Select Close.

For Unix Platforms

  1. Open the desired process and click within the process.
  2. Select Run > Run Configurations....

    The Run Configuration screen appears.

  3. Select the environment tab and double click LD_LIBRARY_PATH.

    The Edit Environment Variable screen appears.

  4. Add the path to the desired location of the Instream/bin and Translator/bin directories at the beginning of the string, before the first $ character, and with a : at the end of each segment of added text.
    Note: Do not delete the existing string, simply add information to the beginning.

    Example

    /home/bw/bw630/instream/8.5/bin:/home/bw/bw630/translator/3.5/bin:${env_var:FTL_HOME}...

  5. Select Apply.
  6. Select New.
  7. Add a new variable FSINSTREAMINI and specify the desired location of the Instream\bin directory.
  8. Select Apply.
  9. Select New.
  10. Add a new variable FSTRANSLATORINI, and specify the desired location of the Translator\bin directory.
  11. Select Apply.
  12. Select Close.

This example shows a sample Run Configuration screen after the variables have been set for Unix.

Verify File Paths in the Examples

Before running an example, verify the file path used in the example is correct for your environment.

  1. Open the desired example.

    In this image, the IllustrateAL.bwp process is opened.

  2. Check the file path. In this example the FilePoller activity is set to pick up the input file at the following path <BW_HOME>\samples\palette\hl7\<version_number>\samples\LLP\DataAndGuidelines\Data\ADT_A05AL.hl7. You might have to alter the file path if you have saved the samples to a different location.

Running an Example

  1. Open the desired example.
  2. To run the example, click Run > Run.

    Note: After the process executes successfully, a Success message is written to the Console. Select Window > Show Console in TIBCO Business Studio to view the log messages.
  3. Optional: To debug the application, click Run > Debug.

    The perspective changes to Debug from Modeling. You can view the job details in the Console view from the Debug perspective.