exitTasklet Element

Closes a tasklet and returns the application to the previously opened tasklet. If the tasklet that closes is the only open tasklet, then the application closes.

userRole Element

    orchestrations Element

        orchestration Element

            actions Element

                exitTasklet Element

                   group Element

                        exitTasklet Element

            tasklets Element

                tasklet Element

                    actions Element

                         exitTasklet Element

                         group Element

                             exitTasklet Element

    tasklets Element

        tasklet Element

            actions Element

                exitTasklet Element

                group Element

                    exitTasklet Element


<tasklet>
  <action>
    <exitTasklet context="describe text" icon="image file" name="reference name" priority="priority number" result="OK|Cancel|Abort|None" submitRequestDocument="true|false" text="menu label" validate="true|false" />
  </actions>
</tasklet>

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

Attributes

Attribute Description

context

Optional attribute.

Provides information about the text attribute value, such as a description, usage, or maximum number of characters. Useful for translation. This attribute has no effect on the application.

icon

Optional attribute.

The full path and file name of a bitmap file to associate with the action. You can develop tasklets to use this attribute.

name

Optional attribute.

A unique reference name for the action.

priority

Optional attribute.

A whole number to determine the location of the action in the menu by comparing it with the priorities of other actions on the tasklet as follows:

  • The action with the highest priority number is located on the left soft key.

  • The action with the second highest priority number is located at the top of the right soft key menu.

  • Subsequent actions are located in the right soft key menu, in descending order of priority from top to bottom.

  • For more information, see Arranging Actions on Soft Keys and Menu Items in Microsoft Dynamics Mobile Orchestration Guide online.

result

Optional attribute.

Passes the value to the tasklet when it closes. There are four values: OK, Cancel, Abort, and None. The value returns to the tasklet when the exitTasklet action is initiated. You can develop tasklets to act on these values. For example, a tasklet can save data on exit when the result is set to OK.

The result attribute works together with the <confirmClose> element to display a confirmation message to the user when exiting the tasklet. For the confirmation message to work, set the result value to Cancel or None. For more information, see confirmClose Element.
NoteNote

submitRequestDocument

Optional attribute.

true submits a request document for the orchestration; otherwise, false.

false is default.

For more information, see Setting up Request Documents in Microsoft Dynamics Mobile Orchestration Guide online.

text

Required attribute.

Specifies the label of the action on the soft key or menu.

validate

Optional attribute.

true calls the tasklet validation method Validate when closing the tasklet; otherwise, false.

true is default.

For more information, see How to: Validate User Input to a Tasklet in Microsoft Dynamics Mobile Orchestration Guide online.

Child Elements

Element Description

constraints Element

The state keys that must have correct values set, before the action is enabled.

inputMappings Element

Maps tasklet output parameters that are identified by the state keys, to the input parameters of the tasklet that opens as a result of the action.

Parent Elements

Element Description

actions Element

Defines actions that control the flow between the application's tasklets and orchestrations.

group Element

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

The following example uses the <exitTasklet> element in a simple orchestration for editing customer details. <exitTasklet> element creates a soft key called Save that, when tapped, saves the information entered in the tasklet and closes the tasklet.

<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>
        <exitTasklet text="Save" priority="10" result="OK" />
      </actions>
    </tasklet>
  </tasklets>
</orchestration>

Required

No

Max. occurrences

Unlimited

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: