Workflow Trigger Reference for SAP Business One Hana (Service Layer) Connector

Workflow Triggers initiate workflows and are used to define the data supplied to a workflow.

SAP Business One Hana (Service Layer) Connector provides several workflow triggers, as well as a generic trigger which may be used to more generally access Service Layer REST API routes.

Basic details are shown in the table below.

Trigger Source Description Version
B1Query DEPRECATED. Execute a B1 query for the provided Query Category name and Query name. Generates one or more messages from the query results. Use B1Query v2 for the latest config options. 1.0+
Get a B1 Object Generic Workflow Trigger that allows Service Layer routes to be used to get messages from any B1 Object. Use OData filters to refine trigger data. 1.0+
Get Bulk Data Populate local data files using the specified Service Layer route for B1 object data. Use OData filters to refine trigger data. 1.15+
Get Enqueued Workflow Messages v2 Fetch unprocessed B1Object, UDO and UDT records from B1, as supplied by the SALTBOX_MESSAGES UDT. Use OData filters to refine trigger data. 1.0+
Get Results from a B1 Query v2 Execute a B1 query for the provided Query Category name and Query name. Generates one or more messages from the query results. 1.0+
Get Transaction Records for Enqueued Workflow Messages Retrieve a list of transactions performed in SAP Business One, including data. Data is supplied by the SALTBOX_MESSAGES UDT. 1.7+
Service Layer Workflow Trigger DEPRECATED. Generic Workflow Trigger that allows Service Layer routes to be used to trigger workflow messages. 1.0+
WorkflowMessage DEPRECATED. Fetch unprocessed Saltbox messages from B1. 1.0+

Trigger Sources

B1Query

Trigger Source Description Version
B1Query DEPRECATED. Execute a B1 query for the provided Query Category name and Query name. Generates one or more messages from the query results. Use B1Query v2 for the latest config options. 1.0+

Get a B1 Object

Trigger Source Description Version
Get a B1 Object Generic Workflow Trigger that allows Service Layer routes to be used to get messages from any B1 Object. Use OData filters to refine trigger data. 1.0+

Get Bulk Data

Trigger Source Description Version
Get Bulk Data Populate local data files using the specified Service Layer route for B1 object data. Use OData filters to refine trigger data. 1.15+

Note that version 1.16 patched an issue when fetching empty bulk data. If using version 1.15, the trigger will fail with the error: Converted raw message is not valid XML. To resolve this error, upgrade the SAP Business One Hana (Service Layer) connector to version 1.16 or higher.

If encountering this error on another workflow trigger or connector, this may have a different cause. Refer to Trigger error: Converted raw message is not valid XML for troubleshooting details.

Get Enqueued Workflow Messages v2

Trigger Source Description Version
Get Enqueued Workflow Messages v2 Fetch unprocessed B1Object, UDO and UDT records from B1, as supplied by the SALTBOX_MESSAGES UDT. Use OData filters to refine trigger data. 1.0+

Get Results from a B1 Query v2

Trigger Source Description Version
Get Results from a B1 Query v2 Execute a B1 query for the provided Query Category name and Query name. Generates one or more messages from the query results. 1.0+

Get Transaction Records for Enqueued Workflow Messages

Trigger Source Description Version
Get Transaction Records for Enqueued Workflow Messages Retrieve a list of transactions performed in SAP Business One, including data. Data is supplied by the SALTBOX_MESSAGES UDT. 1.7+

Service Layer Workflow Trigger

Trigger Source Description Version
Service Layer Workflow Trigger DEPRECATED. Generic Workflow Trigger that allows Service Layer routes to be used to trigger workflow messages. 1.0+

WorkflowMessage

Trigger Source Description Version
WorkflowMessage DEPRECATED. Fetch unprocessed Saltbox messages from B1. 1.0+