Integrate Transactions
This page shows how to use the Transaction integration type.
The Transaction integration type can be used to access, configure and parameterize SAP transactions for automation.
About Transaction Codes
Transaction codes represent functions in the SAP system. They can be used in the SAP command field to quickly go to an SAP task and start a function. A transaction code consists of letters and/or numbers, e.g., VA01 to create sales orders, ME21N to create purchase orders, etc. For information on how to use and find transaction codes, see SAP Help: Using Transaction Codes
Prerequisites
- A connection to an SAP system is available, see SAP Connection.
- The SAP connection assigned to a transaction service must use an SAP dialog user.
- Transaction communicates with SAP via port 32XX, where XX is the SAP instance number (Property SystemNumber). Make sure that the port is not blocked.
Tip
The transaction feature offers the same functionality as the SAP GUI. Therefore knowing how to navigate the SAP GUI makes it easier to use the transaction feature.
Record Transactions
- Create a new service of integration type Transaction.
- Enter a transaction code .
- Click [Start] to run the transaction. Content from the SAP GUI is displayed.
- Fill out the input fields as you would in the SAP GUI. Input fields can be parameterized once the transaction is recorded, see Parameterize Transactions.
- Click [Submit] to enter your input . All executed actions are logged in the section GUI Steps .
- Click [Save] once you finished recording.
Alternatively, click [Stop] to start parameterizing, see Parameterize Transactions.
Parameterize Transactions
Note
All fields that need to be parameterized must be available in the transaction service as GUI Steps. To parameterize a field in a specific tap or menu, the tab or menu must be accessed when recording the transaction.
Follow the steps below to assign input and output parameters to a transaction service.
- Open the transaction service.
- In the GUI Steps section click the action you want to parameterize. The corresponding input screen opens.
- Click on the fields you want to parameterize. The window "Parameterize Element" opens. All fields that can be parameterized are highlighted in green when hovering over them.
- Select Input to override the value when running the service. Fields that are set to Input become available as input parameters in the request body of the service.
- Select Output to return the value of this field when running the service. Fields that are set to Output become available in the response body of the service.
- Optional: Under Parameter name you can edit the name of the parameter.
- Click [OK] to confirm your input.
- Click [Save] to save your changes.
Input parameters are now accessible in the request body of the service .
Ouput parameters are now accessible in the response body of the service .
Skip Popups
When recording a transaction workflow, SAP can display dynamic popup screens. The popup screens can vary depending on input values.
The input parameter skipPopups
in the request body of the service defines how to handle unexpected popup messages that show up at runtime.
When skipPopups
is set to true, the following actions apply:
Popup during recording | Popup during a service run | Action |
---|---|---|
x | x | The popup is handled like a regular screen. |
x | The service ignores the recorded screen and continues to the next screen. | |
x | The popup is confirmed (Return/Enter key). |
Samples
The knowledge base contains articles on how to create services for the following SAP transactions: