Connecting to SAP System in Visual Studio Using Consume Adapter Service Add-in

To connect using the Consume Adapter Service Add-in in a BizTalk solution:

1. Create a BizTalk project using Visual Studio.
   
   
2. Right-click the project name in Solution Explorer, point to Add, and then click Add Generated Items.
   
   
3. In the Add Generated Items dialog box, do the following:
   
   

   Use this	To do this
   Categories	Click Consume Adapter Service.
   Templates	Click Consume Adapter Service.

4. Click Add. The Consume Adapter Service Add-in opens.
   
   

From the Select a binding drop-down list, select sapBinding and click Configure.

In the Configure Adapter dialog box, click the Security tab, and from the Client credential type drop-down list box, select Username and specify the user name and password to connect to the SAP system.

Important
If you are using the SAP Secure Network Connection (SNC) library to connect to an SAP system, do not specify a username and password.

Click the URI Properties tab and specify values for the connection parameters. For more information about the connection URI for the SAP adapter, see The SAP System Connection URI.

Important
If you are using the SAP SNC library to connect to an SAP system, set the UseSnc connection property to True.

Note
If the connection parameters contain any reserved characters, you must specify them as-is in the URI Properties tab, that is, without using any escape characters. However, if you specify the URI directly in the Configure a URI field and the connection parameters contain reserved characters, you must specify the connection parameters using proper escape characters.

Click the Binding Properties tab, and then specify values for the binding properties, if any, required by the operations you want to target. For example, if you want to target a ReceiveIdoc operation you must set the ReceiveIdocFormat binding property to String. For more information about binding properties, see Working with BizTalk Adapter for mySAP Business Suite Binding Properties.

Important

If you are using the SAP SNC library to connect to an SAP system, set the SncLibrary and SncPartnerName to appropriate values. The SncLibrary binding property takes the path and the filename of the DLLs required for using SNC to connect to an SAP system. These DLLs must be present on the computer with the SAP client and SAP adapter installed. For more information see the BizTalk Adapter Pack installation guide available at <installation guide>:\Program Files\Microsoft BizTalk Adapter Pack\Documents. The SncPartnerName binding property takes the SNC name of the communication partner.

Click OK.

Click Connect. After the connection is established, the connection status is shown as Connected.

The following figure shows the Consume Adapter Service Add-in immediately after the connection is established.

The Consume Adapter Service Add-in displays different nodes containing various artifacts that can be invoked in an SAP system. For example, the RFC node contains all the RFCs available in the SAP system you connected to. For more information about these nodes, see Metadata Node IDs.