Create a Pass-Through Bridge

  • Article

 

Important

Microsoft Azure BizTalk Services (MABS) is being retired, and replaced with Azure Logic Apps. If you currently use MABS, then Move from BizTalk Services to Logic Appsprovides some guidance on moving your integration solutions to Logic Apps.

If you're brand new to Logic Apps, then we suggest getting started here:

Create a Pass-Through Bridge as part of a BizTalk Service project.

A Pass-Through Bridge has only one stage, the Enrich stage. This section provides instruction on how to configure each of these stages. Typically, the steps to configure a Pass-Through Bridge are:

  • Add a Pass-Through Bridge to the BizTalk Service project.

  • Configure the Enrich stage of the Pass-Through Bridge.

To add a Pass-Through Bridge to the BizTalk Service project

  1. Create a BizTalk Service project, as described in Get started with a Visual Studio project.

  2. Right-click anywhere on the BizTalk Service project design area, select Properties. For the BizTalk Service URL property, enter your BizTalk Services URL.

  3. From the Toolbox, drag and drop the Pass-Through Bridge component to the BizTalk Service project design area. This adds a .BridgeConfig file to the solution.

  4. Right-click the Pass-Through Bridge component, select Properties, and then enter the following properties:

    Property Name

    Description

    Associated Project Item

    The name of the associated .BridgeConfig file. This is a read-only field, which means that you cannot edit this property to change the name of the .BridgeConfig file. To change the name of the file, you must change the entity name, as defined for the next property, Entity Name.

    Entity Name

    The name of the Pass-Through Bridge component on the BizTalk Service project design area. This name should be unique for a BizTalk Service project. The name of the .BridgeConfig file is the same as the entity name you enter here.

    Relative Address

    The relative address where the Pass-Through Bridge is hosted on Microsoft Azure. This address along with the BizTalk Services URL you entered in Step 2 is used to create the complete URL for the bridge.

    For example, if the BizTalk Services URL is MyBizTalkService and the relative address of the bridge is PassThruBridge, the URL for the endpoint on the Service Bus is https://MyBizTalkService.biztalk.windows.net/default/PassThruBridge.

    Route Ordering Table

    Specifies the routing order of the message from the Pass-Through Bridge to other components of the message flow. For more information, see The Routing Order.

    Runtime Address

    The public runtime endpoint URL where the bridge is deployed.

    Track Properties

    You can set this property to define which properties on the message are tracked by the bridge. For instructions on how to set this property, see Tracking Messages Processed by the Bridge.

  5. Click Save.

Configure the Enrich Stage

The Enrich stage enables message enrichment by defining properties, the values for which can be derived from the message header (standard or custom), from system-promoted properties (default properties promoted by the bridge), or from an external data source (only Microsoft Azure SQL Database tables supported in this release). These properties can then be used to either route the message to a destination endpoint or for further processing by the message receiving entity. In this section, we go through the procedures for performing each of these actions, namely:

  • Assigning message header values to properties

  • Using system-promoted properties

  • Looking up an external data source

To configure the Enrich stage

  1. Double-click the Pass-Through Bridge component to open the itinerary designer.

  2. Select the Enrich stage, and from the Properties pane, set the IsEnabled property to True or False.

  3. If you want to include any custom code that must be executed before the message enters the Enrich stage, set the On Enter Inspector property. Similarly, if you want to include any custom code that must be executed after the message exits the Enrich stage, set the On Exit Inspector property. For more information, on how to set these properties, see How to Include Custom Code in Bridges.

  4. Within the Enrich stage, select the Enrich activity, and then from the Properties pane click the ellipsis button (…) next to the Property Definition property to open the Property Definitions window.

See Also

Create and Configure a Bridge