====== Decompress Files ======
Query a record, and select a File Attachment field that contains an archived file. This action will then decompress the archive, and trigger a series of actions on each of the files it finds in the archive. If the archive fails to decompress, a separate set of actions will trigger. Supported archives types are: Zip, Tar, Tar.gz.

===== Settings =====

==== What file would you like to decompress? ====
Query a record, and select a File Attachment field that contains an archived file to decompress.
==== What type of archive is this? ====
Choose the type of compression used to archive this file. Select 'Auto' to use the file's extension to determine what kind of archive it is. With auto selected, for example, trigger this action on myarchive.zip will assume it is a zip file, whereas using it on myarchive.tar.gz would use the tar.gz decompression logic.
==== Describe this action ====
Useful as a comment, this description will overwrite the automatically generated description in the [[Action Manager|Action Manager]].
==== Queue this action and children	 ====
When an action is [[Action Queue|queued]], the subsequent actions continue to process without it. Meanwhile, the queued action and its children process separately. Queue actions that you don't want a user to wait for.

===== Action Data =====
Three pieces of data about the Decompress Files are available inside the [[Expression Builder|Expression Builder]] in any action that is added to the action tree.

The pieces of data that are available are:
  * Filename in Compressed File - This is the name of the current file in the loop.
  * Filepath in Compressed File - This is the path of the current file in the loop as found within the compressed archive.
  * Decompressed Filepath - This is the path/name of the decompressed file.  When the Decompress Files action has completed, this path will be deleted.

To store a decompressed file into a [[Field Type - File Attachment|File Attachment Field]], simply set that File Attachment Field to the value in the Decompressed File Path run-time variable during the looping actions.