SAP S/4HANA

Provides integration with SAP S/4HANA OData APIs for working with business objects such as business partners, sales orders, and materials.

Revision History

1.0.0.4 - Initial release.
1.0.0.10 - Updated template key handling.

Connection

The Connection stores the SAP host, authentication settings, and request behavior used by the embedded service metadata.

Property Type Description
Host String The host name or IP address of the SAP S/4HANA instance.
Port String The HTTPS port exposed by the SAP Gateway.
Username String The SAP technical or dialog user used for basic authentication.
Password Masked The password associated with the SAP user.
Timeout (seconds) Integer The timeout applied to SAP calls.
Exclude Empty Query Parameters Boolean When true, query parameters with empty values are omitted from requests.

Setup Notes

  1. Confirm that the target OData services, e.g. API_BUSINESS_PARTNER or API_SALES_ORDER_SRV, are activated and reachable through the SAP Gateway.
  2. Coordinate with the SAP BASIS team to allow Flowgear outbound IP addresses and provision a user with the required permissions.
  3. Confirm HTTPS access to the Gateway host and port, and make sure CSRF token requests are permitted for create, update, and delete operations.

Methods

The SAP S/4HANA Node exposes separate methods for query, create, update, and delete operations.

Query

Executes a GET-based SAP S/4HANA operation.

Parameter Type Description
Connection Connection The SAP S/4HANA Connection.
Service String The target SAP service, e.g. API_SALES_ORDER_SRV.
OperationId String The operation identifier selected from the template.
Options Object Optional route and query values for the request.
Items Array Optional request body items. Query operations usually leave this empty.
Return Type Description
Response Array The streamed response items returned by the SAP operation.

Create

Executes a POST-based SAP S/4HANA operation.

Parameter Type Description
Connection Connection The SAP S/4HANA Connection.
Service String The target SAP service, e.g. API_SALES_ORDER_SRV.
OperationId String The operation identifier selected from the template.
Options Object Optional route and query values for the request.
Items Array The request body items to send to the SAP operation.
Return Type Description
Response Array The streamed response items returned by the SAP operation.

Update

Executes a PUT- or PATCH-based SAP S/4HANA operation.

Parameter Type Description
Connection Connection The SAP S/4HANA Connection.
Service String The target SAP service, e.g. API_SALES_ORDER_SRV.
OperationId String The operation identifier selected from the template.
Options Object Optional route and query values for the request.
Items Array The request body items to send to the SAP operation.
Return Type Description
Response Array The streamed response items returned by the SAP operation.

Delete

Executes a DELETE-based SAP S/4HANA operation.

Parameter Type Description
Connection Connection The SAP S/4HANA Connection.
Service String The target SAP service, e.g. API_SALES_ORDER_SRV.
OperationId String The operation identifier selected from the template.
Options Object Optional route and query values for the request.
Items Array Optional request body items. Delete operations usually leave this empty.
Return Type Description
Response Array The streamed response items returned by the SAP operation.

Usage Notes

  • Use the template picker to select the correct Service and OperationId combination.
  • CSRF tokens are requested automatically for create, update, and delete operations.
  • Set Exclude Empty Query Parameters to true when the target service rejects blank query values.

Known Issues

  • Only basic authentication is supported by this Node.