Edit

Configure a port using the WCF-custom adapter and SQL adapter

  • Article

Steps to configure WCF-Custom send and receive ports to perform outbound and inbound operations on SQL Server using the SQL adapter.

Prerequisites

Sign in with an account that is a member of the BizTalk Server Administrators or BizTalk Operators group. For more detailed information about permissions, see Permissions Required for Deploying and Managing a BizTalk Application, and Minimum Security Rights.

Deploy adapters to send messages to SQL Server

Perform the following steps to configure a WCF-Custom send port for sending messages to SQL Server using the BizTalk Server Administration console.

  1. Start the BizTalk Server Administration console.

  2. In the console tree, expand BizTalk Group, and then expand Applications.

  3. Expand the application under which you want to deploy the SQL adapter.

  4. Right-click Send Ports, point to New, and then point to the type of port you want to configure depending on the mode of communication between BizTalk Server and SQL Server.

  5. In the Send Port Properties dialog box, on the General tab, type a name for the send port.

  6. From the Type drop-down list, select WCF-Custom, and then click Configure.

  7. In the WCF-Custom Transport Properties dialog box, do the following:

    1. Click the General tab, and in the Address (URI) field, specify the connection URI for SQL Server. For more information about the connection URI, see Create the SQL Server connection URI.

    2. On the General tab, in the Action text box, type the action for the operation. See Messages and message schemas for a list of actions for each operation. For example, the action to invoke the Insert operation on a table in a SQL Server database is:

      TableOp/Insert/dbo/Employee

      Note

      Employee is the name of a table in SQL Server database.

    3. Click the Binding tab, and from the Binding Type list, select sqlBinding. You can specify the different binding properties exposed by the SQL adapter. For more information about binding properties, see Read about the BizTalk Adapter for SQL Server adapter binding properties.

    4. Click the Credentials tab, and then do one of the following:

      • Select the Do not use Single Sign-On option, and the specify the user name and password to connect to SQL Server. Note that the user name and password are case-sensitive.

        Note

        If you want to connect to SQL Server using Windows authentication, specify a blank user name and password. Before you do this, the Windows user with which you are logged in must be added to SQL Server as described in Connect to SQL Server using Windows Authentication with the SQL adapter.

      • Select the Use Single Sign-On option, and then specify an affiliate Enterprise Single Sign-on (SSO) application.

        For more information about security with respect to BizTalk Server, see Security with the SQL adapter and BizTalk Server.

    5. To return to the Send Port Properties dialog box, click OK.

  8. From the Send handler list, select BizTalkServerApplication.

  9. If you chose Static One-Way Send Port in step 4, specify a send pipeline. From the Send pipeline list, select the pipeline that corresponds to XMLTransmit.

  10. If you chose Static Solicit-Response Port in step 4, specify send and receive pipelines.

    1. From the Send pipeline drop-down list, select the pipeline that corresponds to XMLTransmit.

    2. From the Receive pipeline drop-down list, select the pipeline that corresponds to XMLReceive.

  11. Click OK.

Deploy adapters to receive messages from SQL Server

Perform the following steps to configure a WCF-Custom receive port for receiving messages from SQL Server using the BizTalk Server Administration console.

  1. Start the BizTalk Server Administration console.

  2. In the console tree, expand BizTalk Group, and then expand Applications.

  3. Expand the application under which you want to deploy the SQL adapter.

  4. Right-click Receive Ports, point to New, and click One-way Receive Port or Request Response Receive Port, depending on the mode of communication between BizTalk Server and SQL Server.

  5. In the Receive Port Properties dialog box, on the General tab, type a name for the receive port.

  6. On the Receive Locations tab, click New. The Receive Location Properties dialog box appears.

  7. In the Receive Location Properties dialog box, do the following:

    1. Specify a name for the receive location.

    2. From the Type drop-down list, select WCF-Custom, and then click Configure.

  8. In the WCF-Custom Transport Properties dialog box, do the following:

    1. Click the General tab, and in the Address (URI) field, specify the connection URI for SQL Server. For more information about the connection URI, see Create the SQL Server connection URI.

    2. Click the Binding tab, and from the Binding Type drop-down list, select sqlBinding. You can specify the different binding properties exposed by the SQL adapter. For more information about binding properties, see Read about the BizTalk Adapter for SQL Server adapter binding properties.

    3. Click the Behavior tab to set the transaction isolation level. For more information about setting transaction isolation level, see Configure Transaction Isolation Level and Transaction Timeout with SQL.

    4. Click the Other tab, and do one of the following:

      • Select User account, and specify the user name and password to connect to SQL Server. Note that the user name and password are case-sensitive.

        Note

        If you want to connect to SQL Server using Windows authentication, specify a blank user name and password. Before you do this, the Windows user with which you are logged in must be added to SQL Server as described in Connect to SQL Server using Windows Authentication with the SQL adapter.

      • Select Get credentials from affiliate application option, and specify an affiliate SSO application.

        For more information about security with respect to BizTalk Server, see Security with the SQL adapter and BizTalk Server.

    5. To return to the Receive Location Properties dialog box, click OK.

  9. From the Receive handler drop-down list, select BizTalkServerApplication.

  10. If you chose One-way Receive Port in step 4, specify a receive pipeline. From the Receive pipeline list, select the pipeline corresponding to XMLReceive.

  11. If you chose Request Response Receive Port in step 4, specify send and receive pipelines.

    1. From the Receive pipeline drop-down list, select the pipeline that corresponds to XMLReceive.

    2. From the Send pipeline drop-down list, select the pipeline that corresponds to XMLTransmit.

  12. In the Receive Location Properties dialog box, click OK.

  13. In the Receive Port Properties dialog box, click OK.

See Also

Manually configure a physical port binding to the SQL adapter