Unzip Task Configuration

Configure the following properties for the Unzip file operation task:

Field Description
Task name Type a unique name for the task.
File filter Type the name of the file if you want to filter files with specific names. By default, IBM webMethods Managed File Transfer considers all files. If you want to use a regular expression, specify a valid regular expression in the File filter and select the Use regular expression option.
Note: Use wildcard characters to filter the file names. For example, type *.zip to trigger the action only when ZIP files are uploaded or downloaded. To trigger an action based on a name string in the ZIP files, use the name string in the File filter box, preceded and followed by wildcard characters. For example, type *invoice*.zip to trigger the action based on the file URLs, when ZIP files containing the character string invoice in their file names are uploaded or downloaded. If you define a File filter for a task, the task acts only on files that are filtered out.
A few examples of regular expressions are:
  • ^(?!.*purchaseorder).*$: Excludes files with the file URL containing purchaseorder.
  • */out/.*: Include files with the file URL containing the folder out.^abc(.*)123$
  • NEW-((*.doc)⏐(*_backup_*)): Includes anything starting with NEW- that either ends in .doc, or is followed by the string _backup_.
Delete original ZIP file Select this option to delete the original ZIP file after it is unzipped.
Destination location Select one of the following options to configure the location to which the contents of the file will be extracted:
  • Remote path. If the destination location is on a remote server, select a protocol (transport mechanism) from the list, and type or browse to the file path location. For example, protocol://<host\>:<port\>/DestinationFolder/.
    • Type the User name and Password for the remote system.
    • Select High availability download recovery if you want to recover from a download that was not completed.
    • Click Test Connection to check the connection to the remote server.
      Tip: If you want to connect to a remote server using a secure protocol (FTPES, FTPS, HTTPS, or SFTP) and want to configure authentication using secure key exchange, create a folder for the remote server and configure the certificate alias parameters. Use the folder that you configured in the Virtual folder option of the Source location in the task.
  • Virtual folder. To specify a virtual folder, type or browse to the location of the folder. If you want to point to a subfolder within the folder, append the URL in the box with the details of the subfolder.
Note: The virtual folder that you select should be configured on the same instance on which the action is configured.
Assign partner
Select this option if you want to assign a partner for the action and do one of the following:
  • Select the partner to assign from the list of configured partners in IBM webMethods Managed File Transfer.
  • Type a parameterized value for the partner in the following format: [partner_name], where [partner_name] is a server variable or an action parameter that contains the actual partner name during the execution of an action.
Note: For virtual folders, use this option only if you want to override the partners configured for the folders.
Execute error task Select this option to execute an error task if the file operation fails.

The unzip task decompresses the specified zip file. After a successful unzip task, both the original zip file and the extracted files are passed on to the subsequent task. If the unzip task occurs after parallel processing starts, all the files resulting from the unzip task are treated as part of a single thread. Therefore, in the Activities section of the Action Log page, IBM webMethods Managed File Transfer maintains the File Seq No of the original zip file for the particular thread until the action execution is completed.