MSDN Library

Working in Itinerary Designer

After you create a Microsoft Visual C# project, you can create new itinerary models and add existing itineraries to the project. The following steps describe how to create a new itinerary, add an existing itinerary model, or change the name of an itinerary.

noteNote
Before working with the Itinerary Designer, you must install the Microsoft.Practices.ESB.CORE Windows Installer (.msi file) from the ​Microsoft BizTalk ESB Toolkit install folder. This step installs the required run-time assemblies to the global assembly cache.

 Basic Operations

To create an itinerary

  1. In Solution Explorer, right-click the C# project name, point to Add, and then click New Itinerary.

  2. In the Name box at the bottom of the dialog box, type the name for the itinerary, and then click Add.

    noteNote
    The new itinerary is created and displayed in Itinerary Designer, and a corresponding .itinerary file is created and displayed in Solution Explorer.

To add an existing itinerary to the project

  1. In Solution explorer, right click the C# project name, point to Add, and then click Existing Item.

  2. In the Add Existing Item dialog box, navigate to the directory that contains the itinerary, click the itinerary, and then click Add.

    noteNote
    The itinerary is added to the project.

To change the name of an itinerary

  1. In Solution Explorer, right-click the .itinerary file you want to rename, and then click Rename.

  2. Type the new file name, and then press ENTER.

To save an itinerary

  • On the File menu, click Save <itinerary name>.

    noteNote
    Itinerary files are saved as DSL models in corresponding XML format.

To set itinerary export properties

  1. In the Properties window, type a Name property.

  2. In the Properties window, type a Version property.

  3. In the Properties window, specify the Is Request Response property using the drop-down list. Set this property to true if the ​Microsoft BizTalk ESB Toolkit client application communicates with an on-ramp using request-response message exchange pattern.

  4. In the Properties window, set the Export Mode property to Default or Strict.

    noteNote
    When creating ​Microsoft BizTalk ESB Toolkit itineraries using the Itinerary Designer, the Export Mode property can be used to define where the service will execute. Setting the Export Mode property to Strict ensures that the itinerary service executes in its prescribed container; in this case, each itinerary service in the XML itinerary has a stage property that specifies the pipeline in which the service executes. If this property is set to Default, an itinerary compatible with Microsoft ESB is created, with no stage specified, and the itinerary service executes in the order prescribed, but not necessarily in the pipeline stage desired.

To export an itinerary to a file

  1. In the Properties window, click XML Itinerary Exporter in the Model Exporter drop-down list.

  2. In the Properties window, set the Itinerary XML file property to a new value.

To export an itinerary to a database

  1. In the Properties window, click Database Itinerary Exporter in the Model Exporter drop-down list.

  2. In the Properties window, set the Itinerary Database property connection string to point to the itinerary database.

  3. In the Properties window, set the Itinerary Status property to Published or Deployed.

    noteNote
    When an itinerary is exported to a database with Itinerary Status set to Published, the itinerary will not become effective for the ​Microsoft BizTalk ESB Toolkit run time until after the property is set to Deployed.

Security Operations

By using the Itinerary Designer, you can protect sensitive information, such as passwords and other credentials stored in a ​Microsoft BizTalk ESB Toolkit itinerary, by encrypting this information using X.509 certificates.

To select the X.509 certificate for an itinerary

  1. In the Itinerary Designer Properties window, expand the Encryption Certificate property, and then click the Store Location drop-down list, and select the CurrentUser or LocalMachine. This associates the X.509 certificate store with the current user or the local computer.

  2. In the Properties window, click the Store Name drop-down list and select the value which corresponds to your certificate store.

  3. In the Properties window, click the ellipsis button (...) next to the Encryption Certificate property, and then select the X.509 certificate in the Select Certificate dialog box.

To remove the X.509 certificate from an itinerary

  • In the Itinerary Designer Properties window, expand the Encryption Certificate property, and then set the Store Location property to a different value. This disassociates the old certificate with the ​Microsoft BizTalk ESB Toolkit itinerary model.

To disable the X.509 certificate validation

  • In the Registry Editor, navigate to the subkey HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\BizTalk ESB Toolkit\2.0\Designer, and then set the RequireX509Certificate property value to false.

    noteNote
    If you installed the ​Microsoft BizTalk ESB Toolkit on an operating system that has 64-bit support, the subkey is HKEY_LOCAL_MACHINE\SOFTWARE\SysWOW64\Microsoft\BizTalk ESB Toolkit\2.0\Designer.

© 2014 Microsoft Corporation. All rights reserved.
Show:
© 2016 Microsoft