tasklet Element

Defines a tasklet for use in an orchestration. When a tasklet is called, the tasklet definition is used to create and configure an instance of the tasklet assembly.

For more information, see Defining Tasklets in Microsoft Dynamics Mobile Orchestration Guide online.

userRole Element

    orchestrations Element

        orchestration Element

            tasklets Element

                tasklet Element

    tasklets Element

        tasklet Element


<tasklet context="text description" name="reference name" icon="icon file name" text="title text" type="namespace.class, assemblyname" />

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

Attributes

Attribute Description

context

Optional attribute.

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

name

Required attribute.

Specifies a name for the tasklet. Referencing the name, the tasklet can be called from other parts of the UserRole.xml file, including orchestrations and tasklets. If the tasklet element is defined in an <orchestration> element, then the name must be unique for the orchestration.

If the tasklet is defined under an <orchestration> element, then it can only be called from within the orchestration. To call the tasklet from any orchestration in the application, define it globally in the <tasklets> element directly under the <userRole> element.
NoteNote

icon

Configures the icon that displays in the header section. The icon file must be placed in the application root folder. You can include the icon file in a subfolder of the root folder. If so, include the folder path in the value, for example, Graphics\myicon.png.

Note   If nothing is specified, a system icon displays.

text

Optional attribute.

A text string that is displayed in the title bar of the tasklet page.

type

Optional attribute.

Specifies the fully qualified type name of the tasklet. The type includes the namespace, class, and assembly name, and has the following format:

type="namespace.class, assembly"

This attribute is not required if the tasklet definition is defined globally in the <tasklets> element directly under the <userRole> element.
NoteNote

Child Elements

Element Description

actions Element

Contains one or more actions that can be initiated from a tasklet.

configuration Element

Contains elements for customizing tasklets, including application settings and text labels.

constraints Element

Specifies a tasklet output that must be set before an action is enabled in the tasklet user interface.

inputMappings Element

Maps output parameter values from other tasklets to the input parameters of the tasklet.

outputMappings Element

Maps output parameters of the tasklet to a memory state from which they can be mapped as input to other tasklets.

Parent Elements

Element Description

tasklets Element

Contains one or more tasklet declarations.

This example demonstrates how to use the <userRole> element in a three-tasklet orchestration for showing customer details:

  • CustomerDetailTasklet displays information about a customer.

  • CustomerContactDetailTasklet displays information about the customer's contact person.

  • CustomerCreditLimitDetailTasklet displays the customer's credit limit.

<orchestration text="Customer detail" name="CustomerDetailEdit">
  <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>
        <open text="CreditLimit" priority="40" tasklet="CustomerCreditLimitDetailTasklet">
          <inputMappings>
            <inputMapping propertyName="CustomerId" stateKey="CustomerID"/>
          </inputMappings>
        </open>
      </actions>
    </tasklet>
    <tasklet name="CustomerContactDetailTasklet" text="Contact Details" type="CustomerContactDetailTasklet.CustomerContactDetailTasklet, CustomerContactDetailTasklet">
    </tasklet>
    <tasklet name="CustomerCreditLimitDetailTasklet" text="Credit Limit" type="CustomerCreditLimitDetailTasklet.CustomerCreditLimitDetailTasklet, CustomerCreditLimitDetailTasklet">
    </tasklet>
  </tasklets>
</orchestration>

Required

Yes

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: