Batch Processing

The Batch Processing feature, also known as Bulk Processing, flags an Agent to group and cache a set of source records into a batch before sending that data to the target Connector. When the target Connector receives the batch of records it uses the target Connector's API methods for bulk, batch, or asynchronous processing to complete the appropriate operation for that set of records. Not all Connector APIs support Batch Processing. See the diagram below for an overview of how the Agent executes a Map with Batch Processing enabled.

For Connectors that support Batch Processing, such as Salesforce, performance is improved significantly because their APIs accept batches of data and can process the data set much faster. However, if you use target Lookup functions or Lookup Blocks in your Maps, performance improvements derived from using Batch Processing are reduced due to the time it takes to look up data in the target for each record. See Lookups And Batch Processing, Lookup Block, and Lookup Functions.

If you configure a batch size limit to be larger than your target application permits, most Connectors correct the batch to the largest possible size accepted by the API during processing. For example: if you have 2,000 source records and the Upsert Block is set to a batch size of 2,000 for the Salesforce SOAP API, TIBCO Scribe® Online sends 10 batches of 200 records.

Benefits Of Batch Processing

Batch Processing Issues

Note: Error handling options configured on the Error Handling tab are disabled if Batch Processing is enabled on the Block Properties General tab. When Batch Processing is enabled, the following text is displayed on the Error Handling tab:

Batch processing is enabled, records with errors are processed by subsequent Blocks.

When Batch Processing is enabled for a target Block, that Block executes independently from the rest of the Map and does not prevent the rest of the Map from executing before the Batch is complete. Even though the Agent is caching records for the Batch enabled Block until the Batch is complete, those same records are being processed by the other Blocks in the Map. Depending on the design of your Map, Blocks with Batch Processing enabled may continue to execute after all records have been processed by the rest of the Map.


Assume you have a very simple Map with three Blocks that do the following:

In this example the records would be processed as follows:

  1. Block 1 returns 150 records.
  2. The first record goes to Block 2 and is cached.
  3. The first record goes to Block 3 and is written to HubSpot.
  4. The second record goes to Block 2 and is cached with record 1.
  5. The second record goes to Block 3 and is written to HubSpot.

    This sequence continues until Block 2 receives the 50th record. At that point the first 50 records are sent to Salesforce. Note that the first 50 records have already been processed by Block 3 by the time Block 2 sends the batch. Block 3 does not wait for the cached records to be sent.

  6. The 51st record goes to Block 2 and is cached. All subsequent records are cached until the 100th record is received. Then records 51-100 are sent to Salesforce.
  7. The 51st record goes to Block 3 and is written to HubSpot. Each subsequent record is written to HubSpot as it is received.

If Block 3 attempted to do an update to Salesforce instead of to HubSpot, the updates for records 1-50 done by Block 2 would not have been written to the target by the time Block 3 processed updates for records 1-50 to the same target. Depending on the fields being changed for each record, Block 3 could have many record errors because the Block 2 updates were not done yet.

Enabling Batch Processing

Batch processing can be enabled only if the target Connector supports Batch Processing. This option can be enabled on the General tab of the Properties dialog for following TIBCO Scribe® Online operation Blocks:

For Replication Solutions, if the target Connection configured in the Solution supports Bulk operations, then Batch Processing is used automatically.