Set Asynchronous Calculation Threshold for Header Type

available from version 17.0

You can define the async threshold per header type for CLIC documents instead of relying only on one global threshold per module. This lets you tune performance separately for different document types, such as high-volume autogenerated documents versus small manual documents.

Behavior

The feature adds a configurable async threshold to CLIC header types in these modules:

• Quoting – Quote Types.

• Agreements & Promotions – Agreement & Promotion Types.

• Rebates – Rebate Agreement Types.

• Sales Compensation – Compensation Types.

The resolved threshold is used for actions that already depend on async thresholds, including Submit, Recalculate, Mass Edit, and other long-running item operations.

Configuration

Open the relevant header type configuration in the corresponding module:

• Quoting > Quote Types

• Agreements & Promotions > Agreement & Promotion Types

• Rebates > Rebate Agreement Types

• Sales Compensation > Compensation Types

In the underlying header type configuration JSON, the threshold is stored under parameters.thresholds.calculate. It sets the number of line items from which a document is submitted, recalculated, etc., asynchronously.

{
  "parameters": {
    "thresholds": {
      "calculate": 50
    }
  }
}

How the Threshold is Resolved

When the system decides whether an action runs synchronously or asynchronously, it uses this order:

1. Header type threshold – if configured on the document’s header type.

2. Global module-level threshold – if no header type threshold is configured, the advanced configuration options quoteAsyncThreshold, contractAsyncThreshold, rebateAsyncThreshold, compensationAsyncThreshold are used.

3. Default value 100 – if neither the header type threshold nor the global property is set.

The backend implementation uses the header type value first, then falls back to advanced configuration options, and finally to the default value.