This action allows you to extract files from a zip archive file. You can choose which files to extract using file masks or just extract all files.
Unzip Options
Files
Zip File
The location of the zip file to extract
Output Directory
The directory where the extracted files will be copied to
Relative Root Dir
This allows you to extract files from an archive that was not created using the relative paths option and still treat it as though it was. In this case you should set Relative Root Dir to the value that you want stripped from the internal path information for each file that is unzipped. For instance, if you had an archive containing the following information:
Filename Path Info
file1.txt backups\subdir1\
file2.txt backups\subdir1\subdir2\
file3.txt backups\subdir1\subdir3\
and you wished to extract these files to an Output Directory of c:\restore\backups and retain the directory structure, normally you would end up with something like the following being extracted:
c:\restore\backups\backups\subdir1\file1.txt
c:\restore\backups\backups\subdir1\subdir2\file2.txt
c:\restore\backups\backups\subdir1\subdir3\file3.txt
when what you really wanted was:
c:\restore\backups\subdir1\file1.txt
c:\restore\backups\subdir1\subdir2\file2.txt
c:\restore\backups\subdir1\subdir3\file3.txt
You can produce the desired results simply by setting Relative Root Dir to "backups\subdir1\".
UnZip Options
Overwrite Mode
Set this property to determine what should be done if a file is about to be extracted and a file of the same name already exists in the destination directory. The possible modes are: Always, Never, If Newer, If Older.
Always: The file will be overwritten.
Never: The file will not be extracted if it would overwrite a file.
If Newer: The file will only overwrite the existing one if the archived file is newer than the existing one.
If Older: The file will only overwrite the existing one if the archived file is older than the existing one.
Recreate Directories
Set this property to True if you want to use directory information in the zipfile when extracting files. The directories will be created relative to the Destination Directory. If this property is False, all files will be extracted to the Destination Directory, which could possibly result in files of the same name overwriting each other if the Overwrite Mode property is set to Always.
Fail if files skipped
The action will report as failed if during the unzip process a file is skipped and not extracted. It will report after the unzip attempt has completed and the number of skipped is returned.
Overwrite Read Only Files
The action will overwrite files which have the read only attribute set.
Retain Attributes
This property should be set to true if you wish unzipped files to retain the attributes that they had when they were originally zipped.
Extract Files
Choose whether to extract all files or only files that match a file mask.
Password
If uncompressing an encrypted password, enter the password here.