orchestrations Element
Contains all the orchestrations for a Microsoft Dynamics Mobile application. An orchestration controls the flow and data transfer among groups of one or more tasklets. An application must have at least one orchestration, which is the orchestration that opens when the application starts up. Typically, a mobile application consists of multiple orchestration elements, where each orchestration represents a business activity or transaction, such as viewing customer details or sending a sales order. The first orchestration element in the UserRole.xml file opens when the application starts.
<orchestrations>
<orchestration>…</orchestration>
<orchestration>…</orchestration>
</orchestrations>
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child Elements
| Element | Description |
|---|---|
|
Contains the orchestration definitions for the application. For more information, see orchestration Element. |
Parent Elements
| Element | Description |
|---|---|
|
Root element of the schema. For more information, see userRole Element. |
The following example demonstrates an application that includes three orchestration elements:
-
Reference Implementationopens when the application starts. -
CustomerDetailReadOnlydisplays details of a selected customer. -
CustomerDetailEditis used to change the details of a selected customer.
<userRole minimize="true" xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Flow">
<orchestrations>
<orchestration text="RolePad" name="Reference Implementation">
<tasklets>
<tasklet name="CustomerListTasklet" text="Customer List" type="CustomerListTasklet.CustomerListTasklet, CustomerListTasklet">
<outputMappings>
<outputMapping propertyName="SelectedCustomer" stateKey="CustomerID"/>
</outputMappings>
<actions>
<open text="Details" orchestration="CustomerDetailReadOnly" priority="40">
<inputMappings>
<inputMapping propertyName="CustomerId" required="true" stateKey="CustomerID"/>
</inputMappings>
</open>
<open text="Edit" orchestration="CustomerDetailEdit" priority="30">
<inputMappings>
<inputMapping propertyName="CustomerId" required="true" stateKey="CustomerID"/>
</inputMappings>
</open>
<exitOrchestration text="Close" />
</actions>
</tasklet>
</tasklets>
</orchestration>
<orchestration text="Customer detail" name="CustomerDetailReadOnly">
<appSettings>
<add key = "TaskletMode" value = "View"/>
</appSettings>
<tasklets>
<tasklet name="CustomerDetailTasklet" text="Customer Details" type="CustomerDetailTasklet.CustomerDetailTasklet, CustomerDetailTasklet">
<actions>
<open text="Contact" priority="40" tasklet="CustomerContactDetailTasklet">
<inputMappings>
<inputMapping propertyName="CustomerId" stateKey="CustomerID"/>
</inputMappings>
</open>
</actions>
</tasklet>
<tasklet name="CustomerContactDetailTasklet" text="Contact Details" type="CustomerContactDetailTasklet.CustomerContactDetailTasklet, CustomerContactDetailTasklet">
</tasklet>
</tasklets>
</orchestration>
<orchestration text="Customer detail" name="CustomerDetailEdit">
<appSettings>
<add key="TaskletMode" value="Edit"/>
</appSettings>
<tasklets>
<tasklet name="CustomerDetailTasklet" text="Customer Details" type="CustomerDetailTasklet.CustomerDetailTasklet, CustomerDetailTasklet">
<actions>
<open text="Contact" priority="40" tasklet="CustomerContactDetailTasklet">
<inputMappings>
<inputMapping propertyName="CustomerId" stateKey="CustomerID"/>
</inputMappings>
</open>
<exitTasklet text="Save" priority="10" result="OK"/>
</actions>
</tasklet>
<tasklet name="CustomerContactDetailTasklet" text="Contact Details" type="CustomerContactDetailTasklet.CustomerContactDetailTasklet, CustomerContactDetailTasklet">
<actions>
<exitTasklet text="Save" result="OK"/>
</actions>
</tasklet>
</tasklets>
</orchestration>
</orchestrations>
</userRole>
Reference
orchestration Elementtasklet Element
Concepts
UserRole Schema Hierarchy StructureDefining Orchestrations in the UserRole
Defining Tasklets
Other Resources
Mobile UserRole Schema ReferenceMobile Orchestration
How to: Build a Mobile Application Using Orchestration
Working with Actions for Soft Keys and Menu Items