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.
-
In Solution Explorer, right-click the project name, select Add, and then click New Item.
-
In the Add New Item dialog box, in the Categories pane, click BizTalk Project Items, and then in the Templates pane, click BizTalk Orchestration.
-
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.
-
In Solution Explorer, right-click the project name, click Add, and then click Existing Item.
-
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.
Note 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.
-
In Solution Explorer, right-click the .odx file you want to change, and then click Rename.
-
Type the new file name you want, and then press ENTER.
Note 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.
-
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.
-
In the Orchestration View window, select Orchestration Properties.
—Or—
Click the Process Area background of the Orchestration Design Surface.
-
In the Properties window, specify the following properties. Note that some properties appear only under certain circumstances.
Note 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.
Note 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.
