This document describes how to create an outbound interface in SAP PI/PO using Skyvva REST Adapter. When talking about the outbound interface in this document the direction Salesforce to SAP is meant e.g. Salesforce Interface will be called from SAP-PO. The development of an outbound interface involves steps to be done in Salesforce and in PO. This document does not describe the work at SAP-Backend e.g. developing business logic in SAP-Backend with ABAP.

• Skyvva software landscape and building blocks

Skyvva Integration Suite enables the integration between Salesforce and SAP-Backend over SAP-PO with less effort and without programming either in SAP or in Salesforce. It based on the generation and customized the approach to reduce effort and to accelerate the development of interfaces between those systems.
In order to be able to provide such a toolset and framework some component (green) has been developed by Skyvva and has to be deployed on Salesforce and SAP-PO of the customer. On the SAP-Backend e.g. SAP ECC 6.0 there is no software installation needed.

When talking about the direction we have to clearly define the perspective from which platform we are looking for. Since we are coupling two platforms Salesforce and SAP together we have to clearly define from which view we are referencing when talking about direction outbound or inbound.

• Outbound and Inbound Interface
  The term outbound is used when data is sent out from Salesforce to SAP. Therefore we call interfaces for sending data out of Salesforce to SAP “Outbound Interface”. For the other direction, we call interfaces as “Inbound Interface” when data is sent from SAP to Salesforce. So the reference point is set to Salesforce.

Prerequisite for creating an Outbound interface

• The Skyvva solution framework has to be installed into your Salesforce instance.
• An integration instance has been created
• SAP-PO has been installed and set up correctly
• Your workstation needs an internet browser IE or Firefox of the new release.

You start developing outbound interface when you want to send data from Salesforce over PO to SAP-Backend. Of course, you can send data from Salesforce to anywhere not just to SAP-PO. But the focus of this document is sending data from Salesforce over SAP-PO to SAP-Backend e.g. an SAP ECC 6.0.

• Creating outbound Interface

The figure below depicts which steps to be followed to create an outbound interface with SAP PI/PO.

• Creating an outbound adapter in Salesforce.

To Create an Adapter in Salesforce. Go to Adapter tab as shown below.

In the Adapter page. Click on New to create an adapter.

select the type as REST Adapter.

Here in the properties tab, we have to specify the Now specify the Name, description, and properties as shown in screenshots below.

Now click on save to create the adapter.

• Create Metadata Provider

Here we are creating metadata for the message type. Metadata providers are plugins that do the actual metadata extraction from files. Metadata Provider tells the data processing layer of lib md which metadata fields (types) they can extract.

In Skyvva, when we create metadata, the Name field is only the mandatory field. On MetaData the Name cannot be duplicated.

• Create IStructure repository

The term Repository is in fact to store data and structure of a message. The purpose of Istructure is an Interface for a structure that contains the metadata of a structure.

Create Message Type

Now Create Message Types for IStructure Repository. The free define message type is a type and structure definition which is stored in the Repository. The message type can be resided in a WSDL, in SAP IDoc, SAP Bapi, etc… It can be stored in a file in CSV, XML or other formats.

For the Message Type, you have to use our defined Structure. As we are sending the Account details from Salesforce to SAP. Here we use Account sObject.

{
“REST API H”: {
“Request”: {
“URL”: {
“PATH Parameter”: {
“UId”: “”,
“SobjCode”: “”
},
“QUERY Parameter”: {
“RecId”: “”,
“UName”: “”
}
},
“Header”: {
“AuthPermission”: “”,
“AuthId”: “”
},
“Body”: {
“MyAccount”: {
“Name”: “”,
“Description”: “”,
“MyContact”: {
“FirstName”: “”,
“LastName”: “”
}
}
}
},
“REST Response”: {
“REST Response Header”: {
“AuthId”: “”,
“SobjId”: “”
},
“REST Response Body”: {
“MyAccount”: {
“Name”: “”,
“Description”: “”,
“MyContact”: {
“FirstName”: “”,
“LastName”: “”
}
}
}
}
}
}

In Istructure repository click on “Open Editor” to create the message type as shown below.

Select file type as JSON and give input to open text box as below:

Click on the Save button and you can see the below message type.

• Creating an Outbound synchronous interface

Here we have to create two interfaces one for Request and other for Response as shown below.

Create Outbound interface as “Account_Out” and provide the necessary details as shown in detail below.

Do the mapping as shown below.

Create inbound interface as “Account_Response” and provide the necessary details as shown in detail below.

Do the mapping as shown in the screenshot below.

Download the WSDL’s and import it into SAP PO for mapping.

• Designing the objects in ESR

Import the Request WSDL as external definition into ESR and save activate it

Import the response interface WSDL as external definition, save and activate it

As we are using BAPI from SAP. So no need to create Data type, Message type and Service Interface.

Create an outbound service interface as shown below.

Create request and response message mapping as shown below

Create Operation mapping as shown below

Creation of Integrated Configuration Objects

After creating the objects in ESR. We have to configure these objects in the integration directory.

First, we have to create Configuration Scenario.

An Integration scenario has the following objects.

• Business System for Sender and Receiver
• Sender and Receiver Communication channel
• Integrated Configuration

These are the objects we should create.
We have to define our business system e.g. for the SAP-Backend. For Salesforce you can use our proposal “Salesforce” as the business system. We have to import these business systems from SLD.

Configuring the Sender REST communication channel

Create sender communication channel as shown below.

Since we are using Salesforce as a source. So, here we are using REST  in the sender channel.

Provide the necessary details as shown and then save and activate the channel.

• Configuring the SOAP receiver channel

Integrated Configuration

Create integrated configuration objects as shown below.

Enter the required data e.g. the Communication Component, Interface and Namespace and then click on create button to create an ICO.

Now go through the tabs from left to right to configure the relevant objects. In this first tab “Inbound Processing” here we have to specify the sender communication channel.

Here in the “Receiver” tab, we have to specify the receiver business system.

In Receiver interfaces tab specify the operation mapping.

In the “outbound processing” tab, we have to specify the receiver channel.

Test the Outbound Interface.

Triggering the data from the Source system using the following Apex Code.

skyvvasolutions.CallOutControl c = new skyvvasolutions.CallOutControl();
c.returnJSONComplete=true;
c.actionDoIntegrate=true;
c.isCreateMessage=true;
String[] ids=new String[]{‘0064E00000D0sCvQAJ’};
skyvvasolutions.CallOutResponse r=skyvvasolutions.Iservices.invokeCallout2(‘SAP_Skyvva_Salesforce’,’Account_Out’,ids,’SYNC’, c);

Check the message in the Skyvva message board. Message sent successfully to SAP PO.

Customer data has been sent to SAP Successfully.