Understanding Background Processing for Native Reports
Background Processing Overview
Background Processing is a setting for native reports in Apricot. You will see it in Report Properties, and it is turned off by default. An administrator decides which reports use it, one report at a time.
Long reports can be frustrating. If a report takes too long, the browser may time out and you have to start again. Background Processing fixes this. When it is turned on, the report keeps running on Apricot's side, even if you leave the page or close the tab.
This means less waiting and fewer interruptions. You can start a large report, continue your other work, and come back when it is done. Apricot tells you in the app when the report is ready, and you can also get an email if notifications are turned on for you.
In day-to-day work, administrators choose which reports need this setting (usually the slow ones), and staff simply run those reports as they always have. The only difference is that they no longer need to keep the report page open.
The articles below walk you through turning the setting on, running a report, and handling the few situations where Background Processing works differently.
What This Feature Helps You Do
-
Run long reports without browser timeouts
-
Keep working while a report finishes in the background
-
Get a secure download when the report is ready
-
Spend less time re-running reports that failed
How This Feature Supports Your Work
| What the Feature Does | Why It Helps You | Real-World Use Case |
|---|---|---|
| Keeps a report running after you leave the page | You do not have to sit and wait for a slow report | A program coordinator starts a year-end services report, then goes to a meeting and downloads it afterward |
| Tells you when the report is ready | You know exactly when to come back | A case manager gets an email that the monthly caseload report has finished |
| Lets the administrator choose which reports use it | Short reports keep working the way they do today | An admin turns it on only for the three reports that always time out |
| Keeps the finished file available for 48 hours | You can download it when it suits you | A data manager runs a report on Friday and downloads it Monday morning |
Is This Feature Right for Me?
-
You run reports that take a long time or sometimes time out
-
You want to keep working while a report finishes
-
You are an administrator who manages native reports for your team
Feature Availability
-
Available for native reports in Apricot.
-
Turned off by default. An administrator must turn it on for each report in Report Properties.
-
Completed reports are available to download for 48 hours.
-
Only the user who ran the report can open the completed file.
-
Reports with Background Processing turned on cannot be used in Bulletins.
-
Print Mode only works after the report has been run at least once.
-
After changing global filters or switching programs, you may need to refresh and run the report again.
Not quite what you were searching for?
Navigate back to Background Processing of Native Reports
Navigate back to the Apricot Native Reporting Resource Index
What is background processing for native reports in Apricot? | Why does my Apricot report keep timing out? | Can I leave the page while an Apricot report is running? | How long are completed Apricot reports available to download? | Does background processing work with Bulletins in Apricot? | Who can turn on background processing for a report? | Do I get an email when my Apricot report is ready?