Optional: Configure IDocs to/from Workato in SAP

REQUIRED STEPS

If you plan to use RFCs with the SAP RFC connector, skip to Create a Workato integration user in SAP.

This section consists of the following steps:

1. Define a port for Workato
2. Create a logical system for Workato
3. Create partner profile for Workato
4. Create a distribution model for the partner

LOGICAL SYSTEM, RFC DESTINATION, AND PARTNER PROFILE

We recommend that you to create and maintain a logical system, partner profile, program ID, and RFC destination with the same name.

---

Define a port

Log in to the SAP system and go to the transaction code WE21 to define a port for sending and receiving IDocs with the Transactional RFC type.

1

Click Create and when prompted for your port, you can select to either create a new port or have one generated for you.

2

Save this port name as you must use it later in the ALE configuration process.

3

Enter your RFC Destination created in the preceding steps (refer to this section for more details). In this example, the RFC Destination is WORKATOTST.

---

Create a Logical System

Go to transaction code SALE and define a Logical System dedicated for Workato.

1

Create a new Logical System to interface IDocs. The name you select is also used for the Partner Profile created in the following steps.

---

Create a Partner profile

Go to transaction code WE20 to define a Partner profile to send and receive IDocs.

1

Create a Partner profile with the LS (Logical System) type. Use the same name as the Logical System in the preceding step.

2

Define the Message types that you plan to send and receive in Workato.

Outbound parameters

Outbound parameters correspond to IDocs sent from SAP to Workato.

Inbound parameters

Inbound parameters correspond to IDocs sent from Workato to SAP.

MESSAGE TYPES

The message types you define here are the only message types you can use in your Workato recipes.

3

While adding Outbound parameters, when prompted for the Basic Type of the IDoc message type, register all of the IDocs you plan to use individually. For example, if you plan to use both CREMAS01 and CREMAS02 in the SAP new Idoc trigger on Workato, you must register CREMAS twice in the outbound parameters. For IDocs with extensions, ensure that you enter the extension as well.

4

Provide the same port you defined in the preceding steps when prompted for your receiver port, and then toggle the Output Mode to Pass IDoc Immediately.

HANDLE BATCH TRIGGER

To configure batch trigger for sending IDocs from SAP to Workato, select Collect IDocs where ABAP program RSEOUT00 can be scheduled in the background to trigger IDocs at regular intervals and the field “Pack. Size” in the partner profile will be used to control how many IDocs are submitted for processing at a time. Additionally, please refer to the section New IDocs batch trigger of this guide for more information.

5

Add the Inbound parameters you plan to use when prompted for the process code, and choose the appropriate process code for the message type.

6

Toggle the Processing by Function Module to Trigger Immediately and select the Cancel Processing After Syntax Error check box.

---

Create a distribution model and add message types

Complete the following steps to create your distribution model and add message types:

1

Go to transaction code BD64 to create a Distribution Model for IDocs that interfaces with the Workato system. The direction of flow for the IDocs are configured in this transaction based on the attributes Sender, Receiver, and Message type.

Distribution Model

2

Click the Create Model View icon and provide a relevant Short text as the description and Technical Name for the model view. For example, Short text can be Model view for Workato and Technical Name can be WORKATOTST.

3

Click the model view you created in the previous step and Add Message Type across Sender and Receiver respectively to configure both inbound and outbound scenarios.

4

Distribute the model view under Edit > Model View > Distribute to validate the ALE configuration. The following image shows the expected output if the ALE configuration is intact:

Example

Sender:

T90CLNT090 (SAP system)

Receiver:

WORKATOTST (Logical system for Workato)

Message type:

DEBMAS, MATMAS, CREMAS

The following configuration in the distribution model enables SAP to send DEBMAS IDocs to Workato. A Workato recipe receives them using the New IDoc trigger.

Create separate entries for each inbound and outbound IDoc registered on your partner profile in WE20. In the preceding example, the image demonstrates under the model view, WORKATO Test System Model, that:

1. T90CLNT090 can send WORKATOTST 4 types of IDocs: CREMAS, DEBMAS, MATMAS, and INVOIC. These correlate to the OUTBOUND parameters set in your Partner profile.
2. WORKATOTST can send T90CLNT090 3 types of IDocs: CREMAS, DEBMAS, and MATMAS. These correlate to the INBOUND parameters set in your Partner profile.

---

FURTHER READING

To complete your connection to SAP RFC, read the following guides:

1. Create RFC destination for Workato in SAP
2. Create a Workato integration user in SAP
3. Configure the Workato OPA
4. Configure the Workato SAP connector