Provide Path to annotations-2.0.3.jar

To run the ActiveMatrix BusinessWorks Plug-in for HL7 with FHIR in the TIBCO Business Studio Container Edition environment, the file annotations-2.0.3.jar is required. Before deploying the TIBCO Business Studio Container Edition runtime zip to a Docker image, you must:
  • Obtain a copy of annotations-2.0.3.jar.
  • Run the utility annotationupdate found in BWCE_HOME/bw/palettes/hl7/<version_number>/bin.
Note: These steps are in addition to those found in Adding the Plug-in to TIBCO BusinessWorks Container Edition.

To provide a path to the annotations jar file, perform the following steps:

  1. Obtain a copy of annotations-2.0.3.jar from https://mvnrepository.com/artifact/com.google.code.findbugs/annotations/2.0.3 and save it to the directory of your choice.
  2. Ensure that you have downloaded TIBCO Business Studio Container Edition runtime zip. (See Adding the Plug-in to TIBCO BusinessWorks Container Edition, Step 3.)
  3. Navigate to BWCE_HOME/bw/palettes/hl7/<version_number>/bin, and locate the utility annotationupdate.
  4. Run the utility specific to your platform (see the annotationupdate Utility Samples section).
    Note: As shown in the samples, you must provide the absolute path for both annotation-2.0.3.jar and TIBCO Business Studio Container Edition runtime zip.
  5. After the utility has succesfully run, the annotations-2.0.3.jar is added to the folder \com.tibco.bw.tpcl.fhir.hapi_<version_number>\lib.
    To verify:
    1. Extract the TIB_bwpluginhl7_<version_number>_bwce-runtime.zip.
    2. Open the directory TIB_bwpluginhl7_<version_number>_bwce-runtime\runtime\plugins.
    3. Extract the com.tibco.bw.tpcl.fhir.hapi_<version_number>.jar.
    4. Note the file annotations-2.0.3.jar in the folder \com.tibco.bw.tpcl.fhir.hapi_<version_number>\lib.

Samples of the annotationupdate Utility

This section provides samples of the annotationupdate utility for both Linux and Windows platforms. Fields that require input are shown in bold type and the version numbers used might vary depending on the versions you are working with.

Linux Sample 

******On Linux BWCE******
[fsqa@localhost bin]$ ./annotationupdate 
Buildfile: /home/fsqa/BW234HL7800/bwce/palettes/hl7/8.0/setup/post-install.xml

specifyAnnotationJar:
    [input] Please specify absolute path of the annotation jar:
/home/fsqa/build/HL7800/annotations-2.0.3.jar
     [echo] 
    [input] Please specify absolute path of the bwce-runtime.zip:
/home/fsqa/BW234HL7800/bwce/2.3/docker/TIB_bwpluginhl7_8.0.0_v9.3_bwce-runtime.zip
     [echo] 
     [echo] tibco.annotation.jar.esc=/home/fsqa/build/HL7800/annotations-2.0.3.jar
     [echo] tibco.bwce.zip.esc=/home/fsqa/BW234HL7800/bwce/2.3/docker/TIB_bwpluginhl7_8.0.0_v9.3_bwce-runtime
     .zip

updateAnnotationJar:
    [unzip] Expanding: /home/fsqa/BW234HL7800/bwce/2.3/docker/TIB_bwpluginhl7_8.0.0_v9.3_bwce-runtime.zip into 
    /home/fsqa/BW234HL7800/bwce/2.3/docker/tmp
     [echo]   com.tibco.bw.tpcl.fhir.hapi_8.0.0.007.jar 
    [unzip] Expanding: /home/fsqa/BW234HL7800/bwce/2.3/docker/tmp/runtime/plugins/com.tibco.bw.tpcl.fhir.hapi
     _8.0.0.007.jar into /home/fsqa/BW234HL7800/bwce/2.3/docker/tmp/runtime/plugins/temp
     [copy] Copying 1 file to /home/fsqa/BW234HL7800/bwce/2.3/docker/tmp/runtime/plugins/temp/lib
      [zip] Updating zip: /home/fsqa/BW234HL7800/bwce/2.3/docker/tmp/runtime/plugins/com.tibco.bw.tpcl.fhir
      .hapi_8.0.0.007.jar
   [delete] Deleting directory /home/fsqa/BW234HL7800/bwce/2.3/docker/tmp/runtime/plugins/temp
      [zip] Updating zip: /home/fsqa/BW234HL7800/bwce/2.3/docker/TIB_bwpluginhl7_8.0.0_v9.3_bwce-runtime.zip
   [delete] Deleting directory /home/fsqa/BW234HL7800/bwce/2.3/docker/tmp

BUILD SUCCESSFUL
Total time: 35 seconds
[fsqa@localhost bin]$ pwd
/home/fsqa/BW234HL7800/bwce/palettes/hl7/8.0/bin

Windows Sample 

******On Windows BW******

C:\TIBCO\BW642\bw\palettes\hl7\8.0\bin>annotationupdate.exe
Buildfile: C:\TIBCO\BW642\bw\palettes\hl7\8.0\setup\post-install.xml

specifyAnnotationJar:
    [input] Please specify absolute path of the annotation jar:
E:\Foresight\FHIR\V9\annotations-2.0.3.jar
     [echo]
    [input] Please specify absolute path of the bwce-runtime.zip:
E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\TIB_bwpluginhl7_8.0.0_v9.3_bwce-runtime.zip
     [echo]
     [echo] tibco.annotation.jar.esc=E:\Foresight\FHIR\V9\annotations-2.0.3.jar
     [echo] tibco.bwce.zip.esc=E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\TIB_bwpluginhl7_8.0.0_v9.3
     _bwce-runtime.zip

updateAnnotationJar:
    [unzip] Expanding: E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\TIB_bwpluginhl7_8.0.0_v9.3_bwce-runtime.zip 
    into E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\tmp
     [echo]   com.tibco.bw.tpcl.fhir.hapi_8.0.0.007.jar
    [unzip] Expanding: E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\tmp\runtime\plugins\com.tibco.bw.tpcl.fhir
    .hapi_8.0.0.007.jar into E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\tmp\runtime\plugins\temp
     [copy] Copying 1 file to E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\tmp\runtime\plugins\temp\lib
      [zip] Updating zip: E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\tmp\runtime\plugins\com.tibco.bw.tpcl
      .fhir.hapi_8.0.0.007.jar
   [delete] Deleting directory E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\tmp\runtime\plugins\temp
      [zip] Updating zip: E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\TIB_bwpluginhl7_8.0.0_v9.3_bwce-runtime.zip
   [delete] Deleting directory E:\build\HL7_EDI_plugin\FHIR\v9.3\temp\tmp

BUILD SUCCESSFUL
Total time: 52 seconds

C:\TIBCO\BW642\bw\palettes\hl7\8.0\bin>