action.skip

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
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.

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
Email BatchDunningEmailQueue 100
BatchInvoiceEmailQueue 100
Export BatchExportInvoices 50
Finalize BatchDatevExporter 50
BatchExternalTaxRetriever 10
BatchTransferToPaymill 20
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.

  1. 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.

  2. Click Manage in the row of Batch Settings.

  3. Click New.
  4. Specify the details as necessary.

    • Name: The name of the batch class whose scope is to be modified
    • Scope: The batch process execution size
  5. Click Save.