Description

Decompresses files from the specified compressed file into the destination folder specified. To specify more than one file to decompress use wildcards ( e.g. * or ? )

Practical Usage

Usually used to decompress files received from the Internet via email or FTP or when restoring from a backup.

Declaration

<AMDECOMPRESS ZIPFILE="text" DEST="text" OVERWRITE="yes/no" ISNEWER="yes/no" PASSWORD="text" EXCLUDE="text" ISNEWERTHAN="datetime" ISOLDERTHAN="datetime">

Example

<AMDECOMPRESS FILE="C:\sourcefolder\sourcezipfile.zip" DESTINATION="c:\targetfolder\">

<AMUNZIPFILES FILE="C:\sourcefolder\sourcezipfile.zip" DESTINATION="c:\targetfolder\" OVERWRITE="YES" ISNEWER="YES" PASSWORD="ads" EXCLUDE="ads" ISNEWERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%" ISOLDERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%">

General Tab Parameters

Archive File: Specifies the file(s) to decompress. This parameter should be a fully qualified path and filename (preferred) or a single file (requires use of the Change Folder action). Wildcards ( e.g. *.* or ? ) may be used to decompress all files matching a certain mask.

Text, Required
MARKUP:
a) FILE="c:\sourcefoldername\zipfilename.zip"
b) FILE="c:\sourcefoldername\*.zip"

Extract to Folder: Specifies the destination folder for the file(s) being decompressed. This should be a fully qualified path.

Text, Required
MARKUP:DESTINATION="c:\sourcefoldername\"

Compression Type: Specifies the type of compression that is used. Automated Workflow supports the following compression types: ZIP, CAB, LHA, JAR, GZIP, TAR, Ace, Arj, Arc.

Options Tab Parameters

Restore Folder Structure: When set to YES (selected), specifies that, if present in source compressed file, subfolders should be automatically created and files placed in their corresponding subfolders.

Yes/No, Optional default - YES
MARKUP: CREATEFOLDERS="NO"

Overwrite if exist: When set to YES (selected), specifies that, if matching file(s) already exist in the destination folder they should be overwritten.

Yes/No, Optional default - NO
MARKUP: OVERWRITE="YES"

Only if newer: Valid only if the "Overwrite if exist" [OVERWRITE] parameter is YES. When set to YES (selected), specifies that only matching files that are newer than those in the destination folder will be overwritten.

Yes/No, Optional default - NO
MARKUP: ISNEWER="YES"

Password protect files: If specified, uses this password to decompress a password protected file.

Text, Optional default - (none) no password
MARKUP: PASSWORD="mypassword"

Exclude Mask: Causes the action to not decompress files from the archive matching the mask(s) specified. Filenames or wildcard ( e.g. * or ? ) masks may be used, multiple entries may be specified by separating them with the | symbol (e.g. *.txt|*.bak)

Text, Optional default - (blank)
MARKUP: EXCLUDE="*.txt"

Only if newer than: Causes the action to decompress files from the archive only if the source is newer than the date/time specified. If parameter is left blank or not included, the date of the files will be ignored (excluding "Only if newer" [ISNEWER] parameter).

date, Optional default - (none)

MARKUP: ISNEWERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%"

Only if older than: Causes the action to decompress files from the archive if the source is older than the date/time specified. If parameter is left blank or not included, the date of the files will be ignored (excluding "Only if newer" [ISNEWER] parameter).

date, Optional default - (none)
MARKUP: ISOLDERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%"

See Also

Compress Action