To enable communication between SAP Integration Framework 2.0 and SAP S/4 HANA, do the following in SAP Integration Framework 2.0:

1. Create a system landscape entry for SAP S/4 HANA with RFCA parameters in the System Landscape Directory
   
2. Maintain connectivity parameters for the RFCA connection
   

Defining a System Landscape Entry with RFCA Connection Parameters for SAP S/4 HANA

A system entry using RFCA parameters must be available in the System Landscape Directory of SAP Integration Framework 2.0 for the SAP S/4 HANA client to which you want to connect. SAP Business One framework is the active component that calls SAP S/4 HANA. SAP Integration Framework 2.0 is the sender, SAP S/4 HANA the receiver of messages. Contact your SAP S/4 HANA administrator to receive the RFCA connection parameters.

Prerequisites

If SAP GUI is not installed on the SAP Integration Framework 2.0 server, check on operating system level, if an entry for SAP Gateway is available in the services file. If it is not available, add the entry.

1. In a Microsoft Windows operation system, open the C:\Windows\System32\drivers\etc\services file.
   

In a SUSE Linux operating system, open the /etc/services file.

2. Add the following line to the file:
   

sapgw<number> 33<number>/tcp #SAP system Gateway Port

The sapgw<number> entry must be identical with the one you enter in the gatewayServiceNumber field.

If the gateway service number is, for example, 12, enter:

sapgw12 3312/tcp # SAP System Gateway Port

NOTE

If you work in a Microsoft Windows operating system and you add the entry as the last entry in the services file, additionally add a blank line after the entry to the file. The system always ignores the last entry in the file. By adding a blank line as the last entry you ensure that the sapgw entry is considered.

Procedure

1. To start SAP Integration Framework 2.0, choose Start → All Programs → Integration Framework for SAP Business One integration → Integration Framework.
   
2. To log on, in the Administrative User interface, enter the user name and password.
   
3. Choose SLD → Create System.
   
4. In the General Information user window, do the following:
   

1. In the System Type field, select the system type of your SAP S/4 HANA system.
   

You must use one of the following system types:

1. S/4 HANA
   
2. ECC6.0.
   
3. R3.46C
   
4. R3.47.100
   
5. R3.47.200
   

2. In the System Name field, enter a description for your SAP S/4 HANA system.
   

We recommend using the same name you used for the Logical System entry of your SAP S/4 HANA client, for example, EH3CLNT100.

3. Choose Create.
   

5. In the RFCA section, do the following:
   

Field Name	Description
applicationServer	Enter the host name or IP address of the SAP S/4 HANA application server, for example iwdf9349.wdf.sap.corp. To receive this information, contact your SAP S/4 HANA administrator.
Client	Enter the three-digit numerical key to uniquely identify the client in your SAP S/4 HANA to which you want to connect.
User	Enter the name of the user that connects to SAP S/4 HANA at runtime to post the interface objects, such as IDocs.
Password	Enter the password for the runtime user. NOTE As of release ECC, the password strategy for connecting to the system has changed; the password is case sensitive. You can use special characters. Before connecting to an SAP S/4 HANA system prior to ECC.
Language	Enter the two-digit language key in ISO code format. Enter, for example, EN for English or DE for German. Refer to your SAP S/4 HANA system for the language key table.
SystemNumber	Enter the two-digit number that identifies the SAP S/4 HANA system. This is the instance number you find in the login properties of your SAP S/4 HANA system.
maxConnection	Define the maximum allowed number of connections from SAP Business One integration framework to SAP S/4 HANA.
gatewayHost	Enter the hostname or IP address of the SAP S/4 HANA gateway host, for example, iwdf9349.wdf.sap.corp. To check the gateway host in SAP S/4 HANA, call the smgw transaction and choose Goto → Parameters → Display.
gatewayServiceNumber	Enter the gateway service number of your SAP S/4 HANA system. By default, the gateway service number is sapgw<system number>. If you cannot connect to SAP S/4 HANA using the Test Connection function, enter the service number instead. To check the gateway host in SAP S/4 HANA, call the smgw transaction and choose Goto → Parameters → Display.
senderPartner	Enter the logical system that you have created for SAP Integration Framework 2.0 in your SAP S/4 HANA system, for example, B1I176550A. You have created this entry in following the section 6.3.1.3 Defining a Logical System for SAP Integration Framework 2.0. For RFCA communication the SAP Integration Framework 2.0 server is the sender partner.
senderPort	Enter the port for the RFC destination, for example, B1I176550A. Apart from using the port key, which is for example A000000009, you can access the port using the name of the RFC destination that you have created for the SAP Integration Framework 2.0 server in SAP S/4 HANA. To check the port key for the RFC destination, use the WE21 transaction in SAP S/4 HANA. In the Ports section, expand Transactional RFC and identify the port by the description for the logical system.
receiverPartner	Enter the logical system of the SAP S/4 HANA client. You have identified this entry in section 6.3.1.1 Checking the Logical System for the SAP S/4 HANA Client. For RFCA communication the SAP S/4 HANA client is the receiver partner.
receiverPort	Enter the port number of the RFC destination for your SAP S/4 HANA. Enter, for example. EH3CLNT100.  Apart from using the port key, which is for example A000000009, you can access the port using the name of the RFC destination for your SAP S/4 HANA client in the SAP S/4 HANA system. To check the port key for the RFC destination, use the WE21 transaction in SAP S/4 HANA. In the Ports section, expand Transactional RFC and identify the port by the description for the logical system.

6. Choose Save and in the RFCA section choose Test connection.
   

Adding RFCP Connection Parameters for SAP S/4 HANA

Add RFCP parameters to the system entry for the SAP S/4 HANA client in the System Landscape Directory. The parameters are necessary so that the SAP S/4 HANA client can call SAP Integration Framework 2.0. Contact the SAP S/4 HANA system administrator for connection details.

Procedure

1. To start SAP Integration Framework 2.0, choose Start → All Programs → Integration Framework for SAP Business One integration → Integration Framework.
   
2. To log on, in the Administrative User interface, enter the user name and password.
   
3. Choose SLD, select the system entry for the SAP S/4 HANA client and choose Edit.
   
4. In the RFCP section, do the following:
   

Field Name	Description
ApplicationServer	Enter the host name or IP address of the SAP S/4 HANA application server, for example iwdf9349.wdf.sap.corp. To receive this information, contact your SAP S/4 HANA administrator.
Client	Enter the three-digit numerical key to uniquely identify the client in your SAP S/4 HANA to which you want to connect. This can be, for example, 100.
User	Enter the name of the user that connects to SAP S/4 HANA at runtime to post the interface objects, such as IDocs.
Password	Enter the password for the runtime user. NOTE As of release ECC, the password strategy for connecting to the system has changed; the password is case sensitive. You can use special characters. Before connecting to an SAP S/4 HANA system prior to ECC.
Language	Enter the two-digit language key in ISO code format. Enter, for example, EN for English or DE for German. Refer to your SAP S/4 HANA system for the language key table.
systemNumber	Enter the two-digit number that identifies the SAP S/4 HANA system. This is the instance number you find in the login properties of your SAP S/4 HANA system.
maxConnection	Define the maximum allowed number of connections from SAP Integration Framework 2.0 to SAP S/4 HANA.
gatewayHost	Enter the hostname or IP address of the SAP S/4 HANA gateway host, for example, iwdf9349.wdf.sap.corp. To check the gateway host in SAP S/4 HANA, call the smgw transaction and choose Goto → Parameters → Display.
gatewayServiceNumber	Enter the gateway service number of your SAP S/4 HANA system. By default, the gateway service number is sapgw<system number>. To check the gateway host in SAP S/4 HANA, call the smgw transaction and choose Goto → Parameters → Display.
programID	Enter the program ID for the SAP Integration Framework 2.0 RFC destination in SAP S/4 HANA. To check the program ID in SAP S/4 HANA, call the sm59 transaction, expand the TCP/IP connections section, double-click the RFC destination for the SAP Integration Framework 2.0 server and choose the Technical Settings tab.  It is mandatory that the value of the program ID in the RFC destination and this value are the same. SAP S/4 HANA connects to the SAP Integration Framework 2.0 server using a program, which it identifies by the ID.
Unicode	If the SAP S/4 HANA system is a Unicode system, select true. Otherwise select false. To check the Unicode-related setup of your SAP S/4 HANA system, select System → Status… in the SAP System Data section in the Unicode System field.

5. To save your entries, choose Save.
   

The Test connectivity function is not available for the RFCP section, because SAP S/4 HANA initiates the RFC call to SAP Integration Framework 2.0.

You can test the connection in SAP S/4 HANA. It is a prerequisite for a successful connection test that you have assigned the system in SAP Integration Framework 2.0 to an active scenario.

To test the connection, do the following:

1. In SAP S/4 HANA, select the sm59 transaction.
   
2. In the TCP/IP connections section, select the RFC destination for SAP Integration Framework 2.0.
   
3. Choose Display and then Connection Test.
   

Next Step: Enabling Secure Network Communication for SAP S/4 HANA Integration