Legacy Backups


One or more features described here is part of a retirement. Please see the official GRAX Feature Retirement page for more information on this and other feature retirements.

Historically, GRAX placed much of the responsibility for creating, managing, and monitoring a healthy backup schedule on the users. This meant configuring jobs manually with unique schedules, settings, and object selections while needing to avoid the pitfalls of the Salesforce API, Apex Jobs, Scheduling Constraints, etc. This complication created many shortcomings in real-world utilization of the backup features. GRAX has since moved to Auto Backup which simplifies the entire backup process into a single button click to protect your entire Salesforce dataset. For more information, see the documentation above or contact GRAX Support.

Creating Backup Jobs

Backup jobs can be created from the "Schedule" tab in the GRAX Managed Package. To create a job, select the dropdown in the top right and choose "Backup". This will open the configuration screen for a new job.

Managing Backup Jobs

Existing backup jobs can be managed/edited from the "Schedule" tab in the GRAX Managed Package. To view an existing job configuration, click on the name of the job. To edit an existing job configuration, click "edit" in the bottom right of a job configuration popup or "edit" on the actions dropdown in the backups table.

Backup Types

Currently, the two options are Standard Backup and Files (there will also be an option for Tags or History if your org has enabled these). The selection will determine which object list is displayed.

  • Standard Backup will show you all the objects you are used to seeing in SF, except "File" objects.
  • The Files option will show you only 3 specific objects. Given the special considerations around Files, you will need to back these up as part of a separate process going forward.
  • The History option will show you all activated and existing history tables.
  • The Tag option will show you all enabled tag objects.

Once you select one of the backup types, the object list will begin loading.

Filter Criteria

The filter options, as explained above, may vary depending on the toggle selections. The default filter criteria will allow you to filter based on a starting Audit Date Field. GRAX will pick up all records starting from this date field onwards.

GRAX will use one of the following Salesforce system fields (in order, given that some objects may not have all these fields) to filter the selected objects:


If you had selected the Single Object Backup toggle, you'll have more flexibility in selecting specific date fields on the object that you want to use for filtering.

Screen Shot 2020-07-27 at 10.08.15 AM.pngScreen Shot 2020-07-27 at 10.08.15 AM.png
Default option of selecting a single "Audit Date Field" to filter records starting from this entered date onwards.

Screen Shot 2020-07-27 at 10.10.31 AM.pngScreen Shot 2020-07-27 at 10.10.31 AM.png
More date fields will be available to filter on (along with a start date and end date) if you enable the "Single Object Backup" toggle.

View SOQL Query Filter

Oftentimes a more advanced Salesforce Admin may want to run a SOQL query in their own tool of choice against the filter criteria that they have selected, in order to get a better sense of how many records will be picked up, for example. You will see a "database" icon next to the date filter field. Click the icon to open a pop-up that will show the SOQL query format of the filters that you entered. This can be very beneficial to Salesforce users who are more familiar with SOQL and want to do a quick copy/paste.


Select your Schedule for how frequently you would like this process to run. For example, this process will run for the first time on 10/3/2018 at 12:00 AM and would continue to run daily at 12:00 AM.

Option Flags

Incremental Backups

When this feature is enabled the Scheduled Process will back up only records that have changed (based on SystemModstamp) since the last time this Scheduled Process ran successfully. We recommend all large backups use this incremental option, so that subsequent runs only grab changed records and save on API calls, increase performance etc.

Incremental Backup cannot be enabled if you are using Date Range Selection as it does not necessarily make sense to incrementally back up records when you set the criteria with Start and End Date.

Email Notifications

Enable this toggle to receive an email notification to the specified users upon successful completion. Note that you will always receive a notification if the process did not complete successfully.

Once you enable this toggle, you'll see a Notify Additional Users section below that will allow you to search for users to receive the email alert, as well as specify up to an additional 250 comma-separated email addresses.

Rolling Date

The benefit of the rolling date option (versus a more simple "Last N Days" filter), is that it allows customer to set a custom schedule and still only back up a rolling period of records. For example, let's say you wanted to schedule a back up on the 15th of each month, but only pick up records modified the previous month. Specifically:

  • Initial run of the process is scheduled for June 15th, for records with a modified date between May 1 and May 31
  • The next run of the process (on schedule) is kicked off on July 15th, and with the rolling date option, it will grab records with a modified date between June 1 and June 30.


Let's take a look at some of the statuses you'll see on the Schedule tab when looking at your backups.

Running - this status indicates that the process is currently running. You will see this status for the majority of the job's lifecycle.

Aborting - Status when a user manually aborts the process.

Aborted - Status once all abort activities have finished. This may take a few minutes.

Completed - All records have been successfully backed and sent to GRAX.

Completed - Errors Backing Up Data - This status indicates that there may be some issues with the backup. You can find out more information and see specific error messages by navigating to the related GDRs or error report link.

Error - Not all batches were process successfully. Use the error report link in the action dropdown to see more information.

Formula Fields

Backup of formula fields is disabled default, as you will see with the new toggle (once you enable the Use Bulk API toggle). GRAX recommends you do NOT enable the backup of formula fields for a couple reasons:

  • Formula fields can be problematic because they are immediately stale once you back them up. The record in Salesforce could easily have a new value in the formula field (and this is not possible to capture given Salesforce does not update modstamp or system field when formula field changes), or someone could easily change the logic of the formula within Salesforce rendering all the data you backed up stale.
  • Salesforce also has restrictions on querying formula fields, and the more formula fields you have on an object, the more Salesforce will require GRAX to “break up” (fragment) the queries, which leads to a much longer time to back up.

Taking these factors into account, GRAX does not recommend enabling the Formula Field Backup toggle. Please speak with your Support or Implementation rep to discuss further if you have questions on specific use cases.

Screen Shot 2020-11-20 at 9.51.12 AM.pngScreen Shot 2020-11-20 at 9.51.12 AM.png

GRAX recommends that you do NOT enable the Formula Field Backup toggle to optimize performance, API usage, and data lake integrity.

Backup Actions

You can create, edit, delete, and deactivate a Backup all from the Schedule tab's actions dropdown on each row.