Skip to main content
Version: Next

How to Convert Files

The Conversion feature allows you to transform images (.jpg, .png, .jpeg) directly to PDF format.

Conversion Direction Restriction

Currently, only Image ➔ PDF conversion is available. Word and Excel document conversion is temporarily unavailable. Reverse conversion is not supported.

Word and Excel document conversion​

Word and Excel document conversion to PDF is temporarily unavailable in this version. You do not need to configure or store an API Key to use FileUtils Pro.

1. First Use​

If the ticket does not have compatible attachments to convert or the staging area is empty, you will see a guidance screen to help you on your first use.

First use empty state - Convert

This screen includes:

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

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

2. Compatible Files List​

When selecting the Convert tab, the left column will show only the ticket attachments with formats compatible for conversion:

  • Images: .jpg, .png, .jpeg

Convert Tab Work Desk

3. Prepare the Conversion​

  1. Move to Staging: Drag or add the desired files to the preparation (Staging) column on the right.
  2. Multiple selection: It is possible to select and process up to a maximum of 3 files simultaneously.
Simultaneous Processing Limit

You can process up to 3 files at the same time in the conversion tab.

Files in staging - Convert

4. Configure the Result​

In the footer of the conversion modal, you can define the output parameters for the generated files:

  • Output file name: The behavior varies depending on the number of files selected:
    • Single file: The text field in the footer will auto-complete with a suggested name in the format CONVERTED_[ORIGINAL-NAME].pdf, allowing you to freely modify it. The system validates characters in real time (these are not allowed: / \ : * ? " < > |), shows a counter, and sets a maximum limit of 100 characters.
    • Multiple files: If processing more than one file at a time, individual name editing will be disabled and the explanatory message will be shown in the footer: * Original name will be used for multiple files. In this case, each resulting file will keep its original name with the respective .pdf extension.
  • Output format: Currently, only the PDF output option is available.
  • Destination options (Post-Action): Define the behavior of the resulting file:
    • Attach to ticket: The new PDF files will be saved directly to the work item.
    • Attach and delete originals: Saves the PDF files to the ticket and permanently deletes the source files (images).
    • Download only: Downloads the files directly to the user's browser without storing them in Jira.
Confirmation when deleting files

If you select the Attach and delete originals option and there are more than 5 files in the staging area, a confirmation dialog will be displayed with the complete list of files that will be deleted and a warning that this action cannot be undone. You will need to explicitly confirm to continue.

Configure conversion result

5. Execute the Conversion​

Once the options are configured, click the Convert button. During the process, the following indicators will appear:

  • Security lock: The conversion button will be disabled immediately to prevent double clicks and protect the processing state.
  • Individual progress bars: Each file in the queue will show its own real-time loading bar to indicate its individual conversion progress.

Conversion process in progress

6. 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 conversion completed correctly. This message closes automatically.
  • Download message: If you selected "Download only", you will see a success flag indicating that the download has started. This message also closes automatically.

Success message

Notification Behavior​

  • Flag types:
    • Success (green): Operation completed successfully, including download start.
    • Information (blue): Additional informational messages during the process.
    • 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.

7. Verify the Result​

Once all ongoing conversions have finished satisfactorily, the system will unlock the panel and display 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