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.
<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 |
|---|---|
|
Closes an orchestration. This is typically used in a wizard orchestration, and to send a request document. | |
|
Closes a tasklet. | |
|
Groups one or more actions together either in the right-side soft key menu using dividing lines, or in a submenu. | |
|
Opens the tasklet used in the next step of a wizard. | |
|
Opens a tasklet or an orchestration. | |
|
Opens the tasklet used in the previous step of a wizard. |
Parent Elements
| Element | Description |
|---|---|
|
Controls the interaction among one or more tasklets. | |
|
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>
Reference
orchestration Elementtasklet Element
exitOrchestration Element
exitTasklet Element
group Element
open Element
inputMapping Element
outputMapping Element
Concepts
UserRole Schema Hierarchy StructureOther Resources
Mobile UserRole Schema ReferenceMobile Orchestration
Working with Actions for Soft Keys and Menu Items