Decompression

The Decompression component is used to decompress the incoming data or file and send it forward. This component can decompress the file and store it to a target directory. It makes use of the APIs available in the java.util.zip package. The component decompresses the text and the hash table values existing in the incoming document, and then sends the document forward.

Configuration and Testing

Attributes

Decompress File?

This checkbox has to be enabled for decompressing the input file.

After this property is enabled, below attributes (which appear when Decompress File attribute is selected) need to be specified.

Binary Output Required (explained later) property is not applicable when Decompress File is enabled.

Source File Directory

The directory from where the microservice picks the files to be decompressed. Provide absolute path here.

Source File Name

The name of the file that needs to be decompressed. Provide the full file name with extension .zip, for example, inputfile.zip

Target File Directory

The directory to which the microservice sends the compressed file/s. Provide absolute path here.

Auto Create Target Directory

Set this property to create the target directory. If this is not set, the directory has to be created explicitly.

Action if same file exist

If the file with the same name exists in the target folder, choose the action to be taken from the below options:

• Overwrite: Overwrites the existing file and hence the old file gets replaced with the new one.
• Rename: Renames the file with "filename + MMddyyHHmmss + counter(optional)".

Postprocessing Action

Action to be taken on the file after it is decompressed successfully. The figure below shows the postprocessing actions that are allowed. 

• DELETE
  Deletes the source file after decompressing it successfully.
• MOVE
  Moves the file to a different location (specified by the property Postprocessing Directory property which appears when the MOVE option is selected).
  When 'MOVE' is selected as the Postprocessing Action, two other properties become visible—"Postprocessing Directory" and "Append timestamp ?".
  
  

  

  
  Figure 5: MOVE action
  
  
• NO_ACTION
  Takes no action on the file.
  

Postprocessing Directory

The directory to which files are to be moved after they are decompressed successfully when 'MOVE' is selected as the Postprocessing Action.
The directory can be specified in the text field or clicking the ellipsis 

This option is visible only when MOVE is selected as the Postprocessing Action.

Append timestamp?

Specifies if a time stamp has to be appended to the file names after they have been moved to the Postprocessing Directory.

• If enabled, the microservice adds a time stamp. The format for the timestamp is provided through the Timestamp format property and a counter (if Append counter? is enabled).

• If disabled, no timestamp is added to the files that are moved to the Postprocessing directory.
  
  

This option is visible only when MOVE is selected as the Postprocessing Action.

When Append timestamp option is enabled, two more supporting options appear: "Timestamp format" and "Append Counter ?".

Timestamp format

The format of the time stamp to be appended to the file name can be specified here. The descriptions of the symbols that can be used in the time stamp formats are shown below.

Example: ddMMyyyy_HHmm.

• This property is visible only when the Appendtimestamp is enabled.

• Avoid using slashes ('/' or '\') in the time stamp format as they can be misinterpreted as File Separators and can lead to confusion.

• Special characters that are not allowed in file names should not be included in the timestamp format (This can be platform specific).

Append counter?

• If selected, a counter is appended to the file name of each processed file in addition to the time stamp. Appending counter to file names ensures that no two files in the Postprocessing directory will have the same name. The name of the file would look like <filename><time stamp><counter>.

• If disabled, no counter is added to the files that have been moved to the Postprocessing directory.

Allow File Patterns in Input Request

Enabling this will allow File patterns in the input request. All the files in the Source Directory are checked against this pattern and are suitably processed. 

Binary Output Required

Enable this to have the decompressed message as binary instead of text.

• For the Expert Properties Cleanup resources (excluding connection) after each document and Target Namespace, please refer the respective sections in Common Configurations page.
• For Monitoring configuration property too, refer the respective section in the above-mentioned page.

Scheduler Configurations

Please refer the respective section in Common Configurations page.

Transport Configurations

Please refer the respective section in Common Configurations page.

Transport Configurations panel will be available only if scheduling is enabled in Scheduler Configurations panel.

Error Handling

Please refer the sections Request Processing Error and Invalid Request Error in the Error Handling section of Common Configurations page for details.

Testing

The configuration can be tested by clicking the Test button in the Interaction Configuration panel.

Sample Input

Message for the compressed file in the Compression component, as below, acts as the input for Decompression component.

Output

Output Message tab shows the response when Execute button clicked.

Functional Demonstration

Scenario 1

Decompress the incoming data.

Configure the Decompression adapter and use Feeder, Compression and Display components to create an event process.  When we send the input from the Feeder as in the Sample Input below, the compression adapter compresses it and forwards it to the Decompression adapter which in turn decompresses the input and forwards the output to Display adapter.

Binary as well as Text outputs are generated (as shown in the figures below) corresponding to the configuration made in the CPS (enabling and disabling Binary Output Required property respectively) of Decompression adapter.

Sample Input

Provide Sample input as "Hello World" in the Feeder window and click Send.

Binary Output

Below will be the output if Binary Output Required property is enabled.

Below will be the output if Binary Output Required property is disabled.

Useful Tip

• If compressed zip file contain more than one file than output of decompression has multiple output message each containing file name and file path.
• When component configuration sends multiple messages, messages contain the following JMS properties which help to identify the first and last messages:
  
  • First document -  START_EVENT=true
  • All documents -  RECORD_INDEX=<index of output message>
  • Last document -  CLOSE_EVENT=true