This topic has not yet been rated - Rate this topic

Working in Orchestration Designer

After you have started a BizTalk project, you can create new orchestrations and add existing orchestrations to the project. See the following procedures to create and save an orchestration, to add an existing orchestration to a project or remove one from it, to change the name of an orchestration, and to set orchestration properties.

  1. In Solution Explorer, right-click the project name, select Add, and then click New Item.

  2. In the Add New Item dialog box, in the Categories pane, click BizTalk Project Items, and then in the Templates pane, click BizTalk Orchestration.

  3. In the Name box at the bottom of the dialog box, supply a name for the orchestration, and then click Add.

    The new orchestration is created and displayed in Orchestration Designer, and a corresponding .odx file is created and displayed in Solution Explorer.

  1. In Solution Explorer, right-click the project name, click Add, and then click Existing Item.

  2. In the Add Existing Item dialog box, navigate to the directory containing the orchestration, select the orchestration, and then click Add.

    The orchestration is added to the project.

    Aa547629.note(en-us,BTS.20).gifNote
    When you add an existing file, the file is copied to your project. (The file is not simply added by reference.) If you change the file in your project, the original file is left unchanged.

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

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

    Aa547629.note(en-us,BTS.20).gifNote
    When you change the name of an .odx file, you might also want to change the name of the orchestration type by clicking on the design surface to bring up the Properties window and changing the value of the Typename property of the orchestration.

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

    Aa547629.note(en-us,BTS.20).gifNote
    Orchestration files are saved as UTF-8. Schemas, maps, and pipelines are saved as UTF-16.

  • In Solution Explorer, right-click the file you want to remove, and then click Exclude From Project.

    Aa547629.note(en-us,BTS.20).gifNote
    To remove the orchestration from a project and permanently delete the file, click Delete instead.

  • In Solution Explorer, click the Show All toolbar button, right-click the .odx file you want, and select Include in Project.

  1. Open the orchestration by double-clicking on the .odx file in the project, or by selecting the tab containing the orchestration in the Process Area.

  2. In the Orchestration View window, select Orchestration Properties.

    —Or—

    Click the Process Area background of the Orchestration Design Surface.

  3. In the Properties window, specify the following properties. Note that some properties appear only under certain circumstances.

    Aa547629.note(en-us,BTS.20).gifNote
    The names of orchestrations, port types and multi-part message types must be unique within the scope of a module.

    Property Description

    Batch

    Determines whether an orchestration that is an atomic transaction can be batched with other instances.

    Compensation

    Specifies what type of compensation to perform on the orchestration.

    Isolation Level

    For transactional orchestrations, determines the degree to which data is accessible among concurrent transactions.

    Module Exportable

    Determines whether or not the module can be exported to BPEL4WS.

    Module XML Target Namespace

    The XML target namespace used when exporting types to BPEL4WS.

    Namespace

    Determines the name of the containing module that includes the orchestration and the orchestration types.

    Orchestration Exportable

    Indicates whether this orchestration is intended to be exportable to BPEL4WS.

    Orchestration XML Target Namespace

    The XML target namespace used when exporting this orchestration to BPEL4WS.

    Retry

    Specify whether to retry a transactional orchestration if it fails.

    Timeout

    The time in seconds until a transactional orchestration fails due to inactivity.

    Transaction Identifier

    Unique identifier for a transactional orchestration.

    Transaction Type

    Determines whether the orchestration is an atomic transaction, a long-running transaction, or is not transacted.

    Type Modifier

    Determines the scope of orchestration-level variables:

    Private—Access to this orchestration is limited to the containing module.

    Public—Access to this orchestration is not limited.

    Internal—Access to this orchestration is limited to modules within the same project.

    Typename

    Determines the name of this orchestration within the containing module.

    Aa547629.note(en-us,BTS.20).gifNote
    If you to use a Typename that is the same as a root-level namespace, you may receive an error from Orchestration Designer when you define messages and variables based on the Typename and attempt to perform assign operations on them. For example, if you specify a Typename of System, and then define messages and variables like System.String, you may receive an error.

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.