You are here:
Manage a Omnistudio Document Generation Batch Process
You can run, pause, queue, dequeue, and delete a document generation batch process.
| REQUIRED EDITIONS |
| Available in: Lightning Experience |
| Available in: Enterprise, Unlimited, Professional, and Developer Editions |
| USER PERMISSIONS NEEDED | |
| To run, pause, queue, dequeue, or delete a document generation batch process: | DocGen Designer OR DocGen User |
- From Omnistudio, in the Quick Find box, enter document batch process.
- From the Document Generation Batch Processes list, locate and open the document batch process that you want to manage.
-
Select Run, Pause, or Cancel.
Here's what each action does:
Action Description Result Status Run
Starts the document generation batch process.
You can run only one batch process at a time.
Only one batch process can be in progress at a time. To start another, the current batch must complete or be paused or canceled. You can queue additional batches by setting their status to Queued. When no batch is in progress, the system automatically picks up the next queued batch based on the last modified date.
The batch process begins, triggering the individual document generation processes associated with it.
Consider an hourly document generation throughput limit of 1000 per hour and a Batch Docgen Percent Limit Per Hour of 80% (0.8). If you have a batch request of 1300 documents, the system will process 800 (80% of 1000) in the first hour. The remaining 500 will be processed in the subsequent hour. This ensures efficient document generation without overloading the system.
When you click Run:
-
The status of the batch process changes to In Progress. The status of each individual document generation process linked to the batch process also changes to In Progress.
When the batch process is completed:
-
The status of the batch process changes to Completed.
-
The status of individual document generation processes that were successfully run within the batch changes to Success.
If the execution is unsuccessful:
-
If an individual document generation process within the batch fails, its status changes to Failed.
-
If the batch process fails, its status changes to Failed.
Pause
Pauses the currently running batch process.
Halts all associated individual document generation processes.
When you click Pause:
-
The status of the batch process changes to Paused.
-
The status of each individual document generation process linked to the batch process also changes to Paused.
-
If you resume the process, the statuses change to In Progress.
Cancel
Terminates the currently running batch process.
Stops all associated individual document generation processes.
When you click Cancel:
-
The status of the batch process changes to Canceled.
-
The status of each individual document generation process linked to the batch process also changes to Canceled.
Queue Marks a document generation batch as ready for processing by adding the batch request to a processing queue.
Use this action to move the batch to the Queued state so the cron job can process it when no other batch is in progress. The system automatically picks up the next queued batch based on the most last modified date.
The batch status changes from New to Queued.
When the cron job finds no batch in In Progress, it updates one Queued batch to In Progress and begins document generation.
When you click Queue:
-
The status of the batch process changes to Queued.
When the cron job picks up the batch:
-
The status of the batch process changes to In Progress.
When the batch is completed:
The status of the batch process changes to Completed.
Dequeue Removes a batch from a processing queue without canceling it.
This action allows you to temporarily remove a batch from the queue without permanently canceling it. Use this action if you need to make changes to a batch that’s already been queued.
The batch status changes from Queued back to New.
You can edit the batch and click Queue again when ready. This enables you to make necessary updates and then re-queue the same batch again without having to recreate it.
When you click Dequeue:
-
The status of the batch process changes from Queued back to New. No changes are made to cron job logic; this is a user-triggered action only.
When the cron job checks for batches:
-
The batch is no longer in the queue and will not be picked up for processing.
-

