/
One-Time Download Processing Task in Navigo

One-Time Download Processing Task in Navigo

Overview
Voyager has added a new configurable feature to support one-time-only downloads of processing output files, such as result .zip archives generated by processing tasks in Navigo such as Export Result List. This feature ensures sensitive or temporary data is only accessible once after the completion of a given task’s job, improving security and managing storage automatically.

IMPORTANT: This one-time download feature will apply to all download tasks available in your Navigo instance.

 

Guide on Configuring the One-Time Download Restriction Feature

To enforce a one-time download policy, go through the following configuration steps:

  • Open the file explorer on your machine where your Voyager installation files are stored and navigate to voyager > server [X.X] > app > web > navigo.

 

  • Open up the config.js file where a configuration flag, allowOneDownload, can be changed from the default value of false to true. Save the file.

NOTE: The config.js file can be opened and edited in Notepad or Notepad++.

 

Conducting a One-Time Download Task in Navigo

Start or Restart Voyager Server as either an application or service to pick up this new configuration. Go to Navigo and select the desired indexed items in your instance that you wish to download and add them to your Cart.

Step 1 - Review cart: Open your Cart and click Select task >

 

Step 2 - Select task: Choose from the download options that are available for your instance. For example, select the Zip Files option under the Extracting Data category.

 

Step 3 - Configure task: Within the Zip Files task page, name the output file and then click Run Task.

 

Step 4 - Task status: A pop-up window to your file browser will appear where the ZIP file will be stored on your machine. Select Save and you will see in the Task status page that you won’t have the option to select the File Download button after the file has already been downloaded one time.

 

You can view the status of your download by clicking the drop down button next to your Cart and selecting Task history.

 

In the Task history page you can view the status of the task job, the date and time of the task as well as options to download and rerun the task. Notice that the task job is closed and the ZIP file is unavailable for download now that the one-time download feature has been enabled.

 

Notes

  1. Post-Download File and Task Job Management

Upon the first successful one-time download request, the system will:

  • Delete the output file from the job’s output folder (if file-level cleanup is enabled), or

  • Delete the job reference using:

DELETE /api/rest/process/job/{jobId}

This prevents subsequent downloads but retains the actual output data unless file deletion is separately triggered.

 

  1. Manage the One-Time Download Feature and Downloaded Files through Server-side (API)

The download endpoint can be enhanced to:

  • Check for the allowOneDownload flag.

  • Track if the file has already been accessed.

  • Perform post-download cleanup (delete file and/or job).