Extract ZIP

Operation Name

Extract ZIP

Function overview

Extract the ZIP file format.

Properties

For information about using variables, refer to "variables".

Basic settings

Item name	Required/Optional	Use of Variables	Description	Remarks
Name	Required	Not available	Enter the name on the script canvas.

Required settings

Item name	Required/Optional	Use of Variables	Description	Remarks
Zip file	Required	Available	Enter the path to extract ZIP file. Click [Browse] button to activate the file Selectr and Select the file.	1 ZIP files can only be one. Please specify the absolute path of the DataSpider file system as the file path. Constrained Characters of DataSpider File System cannnot be used, except for the path separator "/"..
Output to	Required	Available	Enter the path of the destination of the moved file. Click [Browse] button to activate the file Selectr and Select the directory.	Please specify the absolute path of the DataSpider file system as the file path. Constrained Characters of DataSpider File System cannnot be used, except for the path separator "/"..

Option

Item name	Required/Optional	Use of Variables	Description	Remarks
Encoding	Optional	Available	Select or specify an encoding of zipped files and/or directories. Use only the canonical name supported by Java SE Runtime Environment 8 when specifying the encoding directly in the field. Refer to "Supported Encodings"(http://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html) for details.	For information regarding the default values used, refer to "Default encoding" . If you omit the value, the default value is set.
Error when file already exists at output destination	Optional	Not available	Select whether to raise error if compressed file/directory already exists in the compressing destination. [Checked]: (default) Raise error. [Not Checked]: Overwrite.

Decryption

Item name	Required/Optional	Use of Variables	Description	Remarks
Password	Optional	Available	Specify a password to decrypt.	Use when the zip file is encrypted.

Comment

Item name	Required/Optional	Use of Variables	Description	Remarks
Comment	Optional	Not available	You can write a short description of this adapter. The description will be reflected in the specifications.

Schema

Input Schema

None.

Output Schema

None.

Transaction

Transaction is not supported.

PSP Usage

PSP is not supported.

Available Component variables

Variable name	Description	Remarks
success	Wither success or failure of the process is stored.	The value defaults to null. If successful the operation is true, returns false if it fails.
message_category	Stroes the category to which corresponding message code belongs to, when an error occurs.	The value defaults to null.
message_code	Stores its corresponding message code of occured error.	The value defaults to null.
message_level	Stores the severity of the corresponding message code of the occured error.	The value defaults to null.
error_type	Stores the type of the occured error.	The value defaults to null. Error is represented in the format depicted below. Example:java.io.FileNotFoundException The message may vary depending on DataSpider Servista version.
error_message	Stores the error message for the occured error.	The value defaults to null. The message may vary depending on DataSpider Servista version.
error_trace	Stores stack trace of the occurred error.	The value defaults to null. The message may vary depending on DataSpider Servista version or the client application used.

Specification Limits

[Zip file] can not use wildcards and regular expressions.

[Zip file] is case-sensitive depending on the specifications of DataSpider file system.
About details, refer to "case-sensitivity".

The last modified time of files decompressed is the time that this operation is executed.

Multi-byte characters in the password in the encrypted zip file are not supported.

Main exceptions

Exception name	Cause	Solution
InvalidPropertyConfigurationException <Property name> is not specified.	[<Property name>] is not specified.	Specify the [<Property name>].
FileExistsException	The specified file exists on the destination.	Check the [Output to].
FileIsLockedException	File specified in the [Zip file] is locked.	Please go to Windows Explorer or CLI to unlock.
java.io.FileNotFoundException	The specified file or directory not found.	Check the [Zip file] or the [Output to].
java.io.FileNotFoundException Another processing is in use.	File specified in the [Zip file] is being used by another process.	Please check whether it is used by other processing.
PathIsNotAbsoluteException	The specified path is a relative path. The path only accepts an absolute path.	Specify an absolute path for the [Zip file] or the [Output to].
ZipOperationException The zip file is encrypted. Please specify a password to decrypt.	The [Password] to decrypt is not specified.	Specify the [Password].
ZipOperationException Password is incorrect.	The [Password] is incorrect.	Check the [Password].
ZipOperationException java.io.FileNotFoundException: Invalid file path	Encoding may be different from the encoding specified upon file compressing.	Specify the same encoding as the one upon file compressing to [Encoding].