Data deletion: Save files

Use this action to save individual files from deletion, whether from a scheduled data retention policy, or the Data Deletion: Delete run action.

screen readers look here

Use case

Use this action as part of a GDPR or privacy compliance process that removes old data. This action can preserve important files that are part of the process, and are not necessary or advisable to delete.

It’s recommended to add this action inside of the process you’re saving files in, so the files are saved each instance.

How to configure this action

This action must be inside the same process as the files to be saved. It is not possible to save files from past completed instances, or instances from other Workflows. You can reference the files using the field picker.

If required, you can retrieve the file ID manually. It is always recommended to reference a field with the file ID when possible.

How to find a file’s ID

First, find the file field within a process. It is easiest to find this field by checking the output fields for an entire process

From there, right-click on the file and select “Copy link address”. This may vary between browsers.

screen readers look here

The file’s URL is now copied, paste the copied text in any text box (like Microsoft Word or Notepad). The ID is available at the end of the URL. For https://example.pushbot.com/api/files/a526b85f-57a3-4a9a-ad14-8d0dfcedcca3/download, the file ID is a526b85f-57a3-4a9a-ad14-8d0dfcedcca3

Fields for this action

  • File IDs

    • Enter a list of file IDs to save from deletion, separated by commas. Because file IDs may change in each instance, you should always reference the field when possible.
    • To find a file ID manually, see How to find a file’s ID
  • Output field prefix

    • Enter a name for the field in which the result should be saved.
    • The step’s name is used as the output field name by default.

What will this output?

This action outputs a list of the saved files. The name of the field will be the Output field prefix defined during configuration.

For all other fields, the output field prefix above will be added to the beginning of each of the output field names, separated by two dashes. Each field will result as:{{output-field-name--output-field}}

Output fields for this action

  • Output field prefix

    • A comma separated list of all the saved file IDs.
  • Count

    • An integer count of the number of saved files.

Get help with a problem or question

If something’s not working as expected, or you’re looking for suggestions, check through the options below.

How do I access saved files after a run is deleted?

It is important to save or backup the IDs of any saved files or tables. Once an instance is deleted, saved objects may be hard to relocate.

You should automate backing up these saved object IDs using actions like Tables: Add a row. For example, immediately after using either Save files or Save tables, use the Tables: Add a row action to reference the output field and grab the saved object IDs.

To access a saved table or file ID, navigate to them directly using a URL.

  • For tables, add the table ID to the following URL: https://{{yourteam}}.pushbot.com/tables/{{your-table-id}}/
  • For files, add the file ID to the following URL: https://{{yourteam}}.pushbot.com/api/files/{{your-table-id}}/download
screen readers look here
Are my old files or tables being deleted automatically? Do I need to save every file or table?

By default, Catalytic saves all instance data and no files or tables are deleted automatically. In most cases, the Save files and Save tables actions are not necessary.

But if your team or company has an active data retention policy, or uses the Data retention: Delete run action to delete old data, these actions may be useful to you.

Troubleshoot fix tasks

If you encounter any fix tasks when using this action, check some of the resolutions to common fix tasks below.

Fix Task: “The files with IDs: [X,Y,Z] were not found in this run”

This means the file IDs were valid, but that the files were not in the run. This action cannot save files outside of its own run.

Sorry about that. What was the most unhelpful part?









Thanks for your feedback

We update the Help Center daily, so expect changes soon.

Link Copied

Paste this URL anywhere to link straight to the section.

Need more help?

If you're signed in to Catalytic Community, you can ask other users a question. You'll be redirected to Community where you can add more info.