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.

On this page:

 

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.

  • No labels