Step 8 (On Premises): Configure the BizTalk Server Application

 

Updated: December 8, 2015

In the previous step you created a BizTalk Server orchestration. In this step, you’ll build, deploy, and configure the application.

To build and deploy the application

  1. In Visual Studio, right-click the solution name in the Solution Explorer, and click Build.

  2. The deployment process requires that assembly is strongly signed. You must sign your assemblies by associating the project with a strong name assembly key file.

    1. In Solution Explorer, right-click the OrderProcessingDemo project, and then click Properties.

    2. Click the Signing tab, and select the Sign the assembly checkbox.

    3. From the drop-down list in the Choose a strong name key file box, select <New…>.

    4. In the Create Strong Name Key dialog box, enter a name for the key file, for example OrderProcessingDemo.snk. Clear the checkbox for protecting the key file with a password, and then click OK.

  3. Click the Deployment tab, in the box to the right of Application Name, type OrderProcessingDemo.

  4. From the drop-down list in the box to the right of Redeploy, select True.

  5. In Solution Explorer, right-click OrderProcessingDemo, and then click Deploy. The Output window should display:

    ========== Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ==========  
    ========== Deploy: 1 succeeded, 0 failed, 0 skipped ==========  
    
    
    

To configure the application

  1. Click Start, point to All Programs, point to BizTalk Server, and then click BizTalk Server Administration.

  2. In the console tree on the left pane, expand BizTalk Server Administration, right-click BizTalk Group, and then click Refresh.

  3. Expand BizTalk Group, expand Applications, expand OrderProcessingDemo, and then click Orchestrations. You will see that the OrderProcessingDemo.OrderProcessing orchestration is deployed.

  4. In the orchestration, you created a logical port (ReceiveSO) to receive messages from the Service Bus Queue. In this step, you create a physical receive port to map to the logical port.

    1. From the BizTalk Server Administration Console, under the OrderProcessingDemo node, right-click Receive Ports, point to New, and then click One-way Receive Port.

    2. On the General tab, do the following:

      Use thisTo do this
      NameType ReceiveSO.
      Enable routing for failed messages(clear)
    3. Click Receive Locations, and then click New.

    4. From Receive Location1 – Receive Location Properties dialog box, do the following:

      Use thisTo do this
      NameType ReceiveOrders_SO.
      TypeSelect SB-Messaging.
      Receive handlerSelect BizTalkServerApplication.
      Receive pipelineSelect XMLReceive.
    5. Click Configure.

    6. From SB-Messaging Transport Properties dialog box, on the General tab, for Queue or Subscription URL, enter sb://mynamespace.servicebus.appfabriclabs.com/queueordersedi. Here, mynamespace is the Service Bus namespace and queueordersedi is the Service Bus Queue that you created in Step 3 (For Azure): Create a Service Bus Queue.

    7. From SB-Messaging Transport Properties dialog box, on the Authentication tab, specify the following values:

      Use thisTo do this
      Access Control Service STS UriType https://mynamespace-sb.accesscontrol.appfabriclabs.com/
      Issuer nameSpecify the issuer name. Typically this is set to owner.
      Issuer keySpecify the issuer key.
      System_CAPS_ICON_note.jpg Note

      You can get the values for the Queue URL, ACS URL, issuer name and key from the Windows Azure CTP Management Portal.

    8. Click OK until you exit all the dialog boxes.

  5. In the orchestration, you created a logical port (SendToSQL) to send messages to the SalesOrder database table. In this step, you create a physical send port to map to the logical port.

    1. From the BizTalk Server Administration Console, under the OrderProcessingDemo node, right-click Send Ports, point to New, and then click Static One-way Send Port.

    2. On the General tab, do the following:

      Use thisTo do this
      NameType SendToSQL.
      TypeSelect WCF-SQL.
      Send handlerSelect BizTAlkServerApplication.
      Send pipelineSelect PassThruTransmit.
    3. Click Configure.

    4. From WCF-SQL Transport Properties, on the General tab, do the following:

      Use thisTo do this
      Address (URI)Type mssql://computername/database_instance_name/databasename. For example, to connect to a DemoDB database on the local computer running under the default database instance, enter mssql://.//DemoDB

      For more information, see SQL Server Connection URI
      ActionType TableOp/Insert/dbo/SalesOrder.
    5. From WCF-SQL Transport Properties, on the Credentials tab, select Do not use Single Sign-On, and specify credentials (case-sensitive) to connect to the SQL Server database you specified in the connection string. If you want to connect using Windows Authentication, leave the credentials blank.

    6. Click OK until you exit all the dialog boxes.

  6. In the orchestration, you created a logical port (SendToFile) to send messages to a shared file location. In this step, you create a physical send port to map to the logical port.

    1. From the BizTalk Server Administration Console, under the OrderProcessingDemo node, right-click Send Ports, point to New, and then click Static One-way Send Port.

    2. On the General tab, do the following:

      Use thisTo do this
      NameType SendToFile.
      TypeSelect File.
      Send handlerSelect BizTAlkServerApplication.
      Send pipelineSelect XML Transmit.
    3. Click Configure.

    4. From File Transport Properties, do the following:

      Use thisTo do this
      Receive folderSpecify the location where you want to send the message.
      File nameRetain %MessageID%.xml.
    5. Click OK until you exit all the dialog boxes.

  7. You must now bind the physical and logical ports together to configure the application.

    1. From the BizTalk Server Administration Console, right-click OrderProcessingDemo, and then click Configure.

    2. From Configure Application, in the left pane, click OrderProcessing.

    3. Use the values in the following table to configure the application.

      Use thisTo do this
      For HostSelect BizTalkServerApplication
      For logical port ReceiveSOSelect physical port ReceiveSO
      For logical port SendToSQLSelect physical port SendToSQL
      For logical port SendToFileSelect physical port SendToFile
    4. Click OK to save the configuration.

To start the application

  1. From the BizTalk Server Administration Console, right-click OrderProcessingDemo, and then click Start.

  2. From the dialog, click Start.

Tutorial 4: Creating a Hybrid Application Using BizTalk Server 2013

Community Additions

ADD
Show: