26/06/2015

[TIBCO] BusinessWorks 6 Compress Plugin for ZIP

UPDATE: check latest version 1.2.0.FINAL here

Happy to announce the availability of the 1.0.0.FINAL version of the TIBCO BW6 Compress palette. It includes Zip and Unzip activities. This is developed in my free time and it's not endorsed, verified or supported by TIBCO in any way (yet?).

It uses Apache Common Compress library 1.8.1 with no modifications and it's packaged within the plugin.



Description:

- Zip: creates a zip from a file or folder. Parameters are

location - String - Location of the file or folder to zip. May or may not end with path separator
filename - String - Name of the file or folder to zip
zipLocation - String - Location where to save the generated zip. May or may not end with path separator
zipFilename - String - Name of the zip file to create. A .zip extension will be appended to the name
createDirs - Boolean - (Optional) Specify whether to create missing directories that build up the zipLocation path. Default is false
overwrite - Boolean - (Optional) Specify whether to overwrite an already existing file with same zipName.zip name under zipLocation. Default is false. A backup copy of the existing file with .bak appended to the name is created and removed ONLY if the activity ends successfully

- Unzip: extracts a zip archive contents to a specified dir. Parameters are

zipLocation - String - Location of the zipfile to extract. May or may not end with path separator
zipFilename - String - Name of the zipfile to extract. Must include extension. Must be in ZIP format.
unzipLocation - String - Location where to extract the archive contents. May or may not end with path separator
createDirs - Boolean - (Optional) Specify whether to create missing directories that build up the unzipLocation path. Default is false
overwrite - Boolean - (Optional) Specify whether to overwrite an already existing item with same as the one being extracted under unzipLocation. Default is false

Output is:

retCode - Integer - Status code of the activity. 0 if everything went fine
retMsg - String - (Optional) Status message for the activity. Usually empty

Faults are:

code - String - Fault code
message - String - Fault message

I would urge anyone wanting to try this to take all necessary precautions even though the version number says FINAL

Logging is dynamic and it's based on the application log level.

Check GitHub https://github.com/steghio/TIBCO_BW6_Compress_Plugin/
for the source code, sample project, Eclipse (BW6) installer. If you want to manipulate it, READ THE GUIDE first.

Please do not shove this in a production environment and complain that it caused velociraptors to appear out of nowhere and eat your sysadmins. Download the installer, check the code out, test and verify it, maybe ask for TIBCO support, potentially edit it to your linking, THEN go live.

No comments:

Post a Comment

With great power comes great responsibility