actions Element

The <actions> element specifies actions for orchestrations and tasklets. Actions define the flow between orchestrations and tasklets. In the user interface of the mobile device, by default, actions appear as soft keys and menu items that the user can tap to navigate through the application and its business activities. There are several types of actions, which you can use in different situations. For example, there is an action that opens a tasklet from another tasklet and another action that closes a tasklet.

userRole Element

    orchestrations Element

        orchestration Element

            actions Element

                tasklets Element

                    tasklet Element

                        actions Element

    tasklets Element

        tasklet Element

            actions Element


<actions>
  <exitOrchestration>…</exitOrchestration>
  <exitTasklet>…</exitTasklet>
  <group>…</group>
  <open>…</open>
</actions>

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

Attributes

None.

Child Elements

Element Description

exitOrchestration Element

Closes an orchestration. This is typically used in a wizard orchestration, and to send a request document.

exitTasklet Element

Closes a tasklet.

group Element

Groups one or more actions together either in the right-side soft key menu using dividing lines, or in a submenu.

next Element

Opens the tasklet used in the next step of a wizard.

open Element

Opens a tasklet or an orchestration.

previous Element

Opens the tasklet used in the previous step of a wizard.

Parent Elements

Element Description

orchestration Element

Controls the interaction among one or more tasklets.

tasklet Element

Defines a tasklet in the application.

The following example consists of an orchestration that displays a list of customers and gives access to details of a customer selected from the list. The orchestration defines actions for the left and right soft keys of the customer list tasklet. The left soft key, labeled Close, closes the customer list tasklet. The right soft key, labeled Details, opens a tasklet that displays details of a selected customer.

<orchestration>
  <tasklet name="CustomerListTasklet" type="CustomerListTasklet.CustomerListTasklet, CustomerListTasklet">
    <outputMappings>
      <outputMapping propertyName="SelectedCustomer" stateKey="CustomerID"/>
    </outputMappings>
    <actions>
      <exitTasklet text="Close" />
      <open text="Details" name="CustomerDetail" tasklet="CustomerDetailTasklet" />
    </actions>
  </tasklet>
  <tasklet name="CustomerDetails" text="Customer Details" type="CustomerDetailTasklet.CustomerDetailTasklet, CustomerDetailTasklet">
    <inputMappings>
      <inputMapping propertyName="CustomerId" required="true" stateKey="CustomerID"/>
    </inputMappings>
  </tasklet>
</orchestration>

Required

No

Max. occurrences

1 within the parent element

Namespace

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

Schema Name

UserRole Schema

Validation File

Orchestration.xsd

Can be Empty

No

Community Additions

ADD
Show: