ZIP Adapter Reference

zipFile

String

in

Specify name and path of the target ZIP file.

any string

files

Array of String

in

Specify a list of files and/or directories to be zipped relative to a base directory (see baseDirectory below).

The files to be zipped are calculated by the base directory andthe file specifications that may be with or without path information (relative or absolute).

• If baseDirectory is not set, make sure that all files in the files array are provided with path information (relative or absolute). In this case the files will be stored with this path information to the ZIP file.

• However, if you set a base directory, provide the file names without path information or with a path relative to the base directory. This way the xUML Runtime will look for the files directly in the base directory and also store the files without path information to the ZIP file.

a list of valid files/directories

baseDirectory

String

in

Specify an base directory for the list of files to be zipped (optional). This part of the file path will not be stored to the ZIP file.
See the note for parameter files above for more information.

a valid directory

parameter provided

All files need to be provided with path information (relative or absolute). This path information will be stored to the ZIP file.

parameter not provided

All files should be provided

password

String

in

Specify a password to protect the ZIP file with (optional).

any string

encryption

String

in

Specify an encryption method if you want to encrypt the ZIP file (optional).

traditional

Alias for zipcrypt. Encrypt target ZIP file with zipcrypt.

zipcrypt

Encrypt target ZIP file with zipcrypt (default).

aes128

Encrypt target ZIP file with aes128.

aes256

Encrypt target ZIP file with aes256.

zipFile

String

in

Specify name and path of the source ZIP file.

a valid ZIP file name

overwrite

Boolean

in

Specify if the extracted files should overwrite already existing files with the same name.

if true, then extracted files are overwritten if they are already there. Otherwise (this is the default), the adapter will extract all files, which are not already there and will return an exception.

true

Extract all files, and overwrite already existing ones.

false

• Default setting.

• Only extract files which are not already existing in the target directory.

• Return an exception if some files could not be extracted because a file with the same name was already existing in the target directory.

baseDirectory

String

in

Specify an base directory for the files to be extracted to.

Where the files will be extracted to depends on the base directory and the file paths stored in the ZIP file.

• If base directory is not set, the files will be extracted according their path specification (relative or absolute) stored in the ZIP file.

• If you set a base directory,the files will be extracted directly to this directory, if they do not have a path specified (see option base directory for action "zip").If they have a relative path specification, the location will be calculated starting with the base directory as root.

a valid directory

password

String

in

Specify a password to access the file if the ZIP file is protected.

a valid password

extractedFiles

Array of String

out

Returns a list of all extracted files.