Batch Settings
You can use batch settings to overwrite the scope for the batch processes that are shipped with JustOn. The scope specifies the execution size, that is, the number of records to be processed by the batch class in one go.
The standard execution size for a JustOn batch process is 1
. Depending on your business requirements and your system performance, you can use batch settings to set higher values.
Each batch setting specifies the following mandatory information:
Field | Possible Values | Description |
---|---|---|
Name | <batch class name> |
Specifies the name of the batch class whose scope is to be modified. Use one batch setting record for each batch process. |
Scope | <positive integer> |
Specifies the scope, that is, the batch process execution size. Must be a positive integer value. |
Automatic Scope Scaling
For a number of important batch processes, JustOn is designed to scale down the scope automatically to a well-functioning value and to restart the process.
In case a batch process execution has failed because a defined scope value is too large, the system will immediately restart the batch execution with a smaller number of records. If the repetition fails, too, it still further reduces the number of processed records and reruns the batch process again – redoing this until the execution size 1
.
The following batch processes are implemented to benefit from this safe batch mechanism:
BatchBalanceExport
BatchBuildTransactionTables
BatchAssignBalances
BatchCreateEInvoice
BatchCreateInstallments
BatchDeleteAttachments
BatchExternalTaxRetriever
BatchFinalizeDunning
BatchFinalizeInvoice
BatchFinalizeTransactionTables
BatchGenericInvoiceRun
BatchInvoiceRun
BatchIvaRun
BatchMarkAsBilled
BatchMasterSubscriptionBuilder
BatchOpportunityToInvoiceRun
BatchPaymentEntriesMatcher
BatchPaymentRun
BatchPdfGenerate
BatchSettleEntries
BatchSettleInvoices
BatchSubscriptionBooking
BatchSubscriptionMetricBuilder
BatchTransactionalInvoiceRun
BatchTransactionBuilder
BatchVATValidation
Info
Check your log files to find out which execution size is successful. Adjust the scope value accordingly.
Recommended Scopes
The following table lists the recommended scopes for the batch classes, grouped by business processes, that are shipped with JustOn.
Info
JustOn is designed to scale the scope automatically to a well-functioning value if the defined scope value is too large.
Business Process | Batch Class | Recommended Scope |
---|---|---|
Account Statement | BatchAccountStatementRun | 100 |
Account Statistics | BatchAccountStatisticsUpdater | 200 |
CSV Invoice Run |
BatchTransactionCsvFinalize | 500 |
BatchTransactionCsvGenerate | 500 | |
Dunning Run | BatchDunningRun | 100 |
BatchFinalizeDunning | 100 | |
BatchDunningEmailQueue | 100 | |
BatchInvoiceEmailQueue | 100 | |
Export | BatchExportInvoices | 50 |
Finalize | BatchDatevExporter | 50 |
BatchExternalTaxRetriever | 10 | |
BatchTransferToPaymill | 20 | |
BatchCreateEInvoice | 100 | |
BatchPdfGenerate | 20 | |
BatchSettleEntries | 10 | |
BatchSettleInvoices | 100 | |
BatchFinalizeInvoice | 25/50 | |
Fixup | BatchCreateCredit | 50 |
BatchCreatePaymentsForPaidInvoices | 50 | |
BatchDeleteDraftDunnings | 50 | |
BatchDeleteDraftInvoices | 50 | |
BatchDeletePaymentEntries | 500 | |
BatchFixInvoices | 50 | |
Invoice Run | BatchGenericInvoiceRun | 50 |
BatchGenericInvoiceRunRecurring | 50 | |
BatchInvoiceRun | 50 | |
BatchMarkAsBilled | 200 | |
BatchOpportunityToInvoiceRun | 50 | |
BatchTransactionalInvoiceRun | 200 - 500 | |
BatchTransactionBuilder | 200 - 500 | |
Invoice Run Finalize |
BatchCreateInstallments | 50 |
Payment | BatchPaymentEntriesMatcher | 50 |
Payment Invoice Run Finalize |
BatchAssignBalances | 50 |
Subscription Build | BatchMasterSubscriptionBuilder | 100 |
BatchSubscriptionPriceIncrease | 100 | |
Subscription Management | BatchSubscriptionRenewal | 100 |
Subscription Metrics | BatchSubscriptionMetricBuilder | 50 - 100 |
Transaction Tables Invoice Run |
BatchBuildTransactionTables | 500 |
BatchDeleteAttachments | 500 | |
BatchFinalizeTransactionTables | 500 |
The following batch classes do not consider batch settings because of defined limits:
- BatchDunningEmail (
Limits.getLimitEmailInvocations()
) - BatchInvoiceEmail (
Limits.getLimitEmailInvocations()
) - BatchAmazonS3Upload (
10
) - BatchGoogleDriveUpload (
8
)
Configuring Batch Class Scope
Create an individual batch setting record for each batch process scope to be configured.
-
Click to enter Setup, then open Custom Settings.
In Salesforce Lightning, navigate to Custom Code > Custom Settings.
In Salesforce Classic, navigate to Develop > Custom Settings.
-
Click Manage in the row of Batch Settings.
- Click New.
-
Specify the details as necessary.
- Name: The name of the batch class whose scope is to be modified
- Scope: The batch process execution size
-
Click Save.