Export (0) Print
Expand All

Connecting to the SAP System in Visual Studio

To use the Consume Adapter Service BizTalk Project Add-in or the Add Adapter Service Reference Visual Studio Plug-in, you must first connect to the SAP system. Both the Consume Adapter Service Add-in and the Add Adapter Service Reference Plug-in present a dialog box through which you configure a connection by setting the following:

  • Connection parameters. These are the parameters that are used to build the connection URI such as application server host or message server host, and client ID.

  • User name password credentials for the SAP system. These are used to authenticate you on the SAP system when the connection is established. You must specify a user name and password.

  • Binding properties. Binding properties are optional and whether you specify them depends primarily on whether you target operations that require specific binding properties to be set. For example, for a ReceiveIdoc operation you must set the ReceiveIdocFormat binding property to String. For more information about binding properties, see Working with BizTalk Adapter 3.0 for mySAP Business Suite Binding Properties.

At a minimum, when you configure the connection to the SAP system, you only have to specify binding properties and connection parameters that are needed to establish the connection and that affect the metadata returned by the SAP adapter for the operations you want to target. However, you might also want to specify values for any additional binding properties and connection parameters that will be used at run time. This is because:

  • The Consume Adapter Service Add-in creates a BizTalk port binding file from the binding properties and connection parameters that you specify when you configure the connection and adds this file to your project.

  • The Add Adapter Service Reference Plug-in creates an app.config file from the binding properties and connection properties that you specify when you configure the connection and adds this file in your project directory.

Perform the following steps to connect to an SAP system using the Add Adapter Service Reference Plug-in or Consume Adapter Service Add-in.

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

    1. Right-click the project in the Solution Explorer, point to Add, and then click Add Generated Items.

    2. 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.

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

    To connect using the Add Adapter Service Reference Plug-in in a programming solution:

    • Right-click the project in the Solution Explorer, and then click Add Adapter Service Reference. The Add Adapter Service Reference Plug-in opens.

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

  3. 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.

    Cc185149.Important(en-US,BTS.10).gifImportant
    If you are using the SAP Secure Network Connections (SNC) library to connect to an SAP system, do not specify a user name and password.

  4. 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.

    Cc185149.Important(en-US,BTS.10).gifImportant
    If you are using the SAP SNC library to connect to an SAP system, set the UseSnc connection property to True.

    Cc185149.note(en-US,BTS.10).gifNote
    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.

  5. 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 3.0 for mySAP Business Suite Binding Properties.

    Cc185149.Important(en-US,BTS.10).gifImportant
    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 file name 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.

  6. Click OK.

  7. 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 graphical user interface is same for the Add Adapter Service Reference Plug-in.



    Consume Adapter Service dialog box connected
    Cc185149.note(en-US,BTS.10).gifNote
    This figure displays the BAPI node in the graphical user interface. This is because the connection was established with the EnableBusinessObjects binding property set to True. The value of this property governs whether the BAPI node is visible. By default, the binding property is set to False.

Show:
© 2014 Microsoft