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.

userRole Element

    orchestrations Element


<orchestrations>
    <orchestration>…</orchestration>
    <orchestration>…</orchestration>
</orchestrations>

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element Description

orchestration Element

Contains the orchestration definitions for the application. For more information, see orchestration Element.

Parent Elements

Element Description

userRole Element

Root element of the schema. For more information, see userRole Element.

Only one orchestrations element is allowed.

The following example demonstrates an application that includes three orchestration elements:

  • Reference Implementation opens when the application starts.

  • CustomerDetailReadOnly displays details of a selected customer.

  • CustomerDetailEdit is 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>

Required

Yes

Max. occurrences

1

Namespace

schemas.microsoft.com/Dynamics/Mobile/2007/04/Flow

Schema Name

UserRole Schema

Validation File

Orchestration.xsd

Can be Empty

Yes

Community Additions

ADD
Show: