Skip to main content
Version: 3.2.0

How to Compress Files

The Compression functionality allows you to group multiple ticket attachments into a single .zip file quickly and easily, facilitating document sending and storage.

1. First Use​

If the ticket has no attachments or the staging area is empty, you will see a guidance screen to help you on your first use.

Work desk empty state - Compress

This screen includes:

  • Contextual message: Informs you that there are no files available to compress in this tab yet.
  • Attach file button: Opens Jira's native dialog to add files directly to the ticket without leaving the work desk.
  • Compress button disabled: The action button remains disabled while there are no files in the staging area.
tip

To enable the Compress button, you need to move at least 1 file to the staging area.

2. Prepare the Compression​

  1. Select Files: Drag files from the left column to the Staging column.
  2. Multiple selection: You can select all the files you need to compress. There is no file limit for compression.
File Validation

If a file in the preparation area exceeds the configured maximum size or has an unsupported format, FileUtils Pro shows visual warnings before processing:

  • Badge: Visible indicator on the invalid file.
  • Tooltip: Explains the specific reason (size or format).
  • Visual highlight: Emphasizes the problematic file in the staging list.

While invalid files remain, the Compress button stays disabled. Fix or remove those files from the preparation area to continue.

Prepare compression

3. Configure the Result​

In the footer of the compression modal, you can define the output parameters for the generated file:

  • ZIP file name: The text field will auto-complete with a suggested name (for example, compressed_YYYY-MM-DD_HHmm.zip). You can edit it freely.
  • Destination options (Post-Action): Define the behavior of the resulting file:
    • Attach to ticket: The .zip file will be saved directly in the work item.
    • Attach and delete originals: Saves the .zip file and deletes the files you used for compression (ideal for keeping the work item clean).
    • Download only: Downloads the .zip file directly to the user's browser without storing it in Jira.

Configure compression result

4. Execute the Compression​

Once the options are configured, click the Compress button. During the process, the following indicators will be presented:

  • Security lock: The compression button will be immediately disabled to prevent double clicks and protect the processing state.
  • Progress bar: A progress bar will be displayed in real time to indicate the progress of the compression.

Compression process in progress

5. System Notifications​

After the process finishes, the system will show flag notifications to inform you of the result:

  • Success message: You will see a success flag confirming that the compression completed correctly. This message closes automatically.
  • Information message: If you selected "Download only", you will see an information flag indicating that the download has started. This message also closes automatically.
  • Error message: If a failure occurs during processing, you will see an error flag with an actionable message. These messages require manual closure.
Recovery from unexpected errors

If the work desk stops responding due to an unhandled error, FileUtils Pro shows a recovery screen (Error Boundary) with options to retry or reload. On network failures, the system also applies automatic retries with exponential backoff. 4xx/5xx errors from Jira or CloudConvert are presented with actionable messages.

Compression success message

Notification Behavior​

  • Flag types:
    • Success (green): Operation completed successfully.
    • Information (blue): Informational messages such as download start.
    • Error (red): Processing failures. Require manual closure.
  • Auto-close: Success and information flags close automatically after a few seconds.
  • Manual close: Error flags must be closed manually by the user.
  • Notification queue: The system can display up to 3 simultaneous notifications. If the limit is reached, new notifications will wait their turn.

6. Verify the Result​

Once the compression has finished successfully, the system will unlock the panel and show a success message indicating that the process has concluded correctly.

  • File details: The message will include the final name of the generated file and its size (indicated in KB, MB, etc.), confirming that the process was completed correctly.
Last updated on