configuration Element

Contains elements that configure the instance of a tasklet. You can develop a tasklet to include key-value pairs that you can set in the UserRole.xml file to change its configuration and behavior. The key-value pairs are set in child elements to the <configuration> element. By default, there are two standard child elements: <labels> element and <appSettings> element. The <labels> element specifies a tasklet's UI text strings. The <appSettings> element specifies a tasklet's operational settings. You can also develop a tasklet to use custom child elements.

For more information, see Configuring Tasklets in Microsoft Dynamics Mobile Orchestration Guide online and Customizing Tasklets in Microsoft Dynamics Mobile Snap-In Consoles online.

The following shows the hierarchy of the <configuration> element followed by its syntax.

userRole Element

    orchestrations Element

        orchestration Element

            tasklets Element

                tasklet Element

                    configuration Element

    tasklets Element

        tasklet Element

            configuration Element


<configuration>
    <appSettings>...</appSettings>
  <labels>...</labels>
</configuration>

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

Attributes

None.

Child Elements

Element Description

appSettings Element

Includes <add> elements that specify key-value pairs for configuring a tasklet. For more information, see How to: Configure a Tasklet Using appSettings in Microsoft Dynamics Mobile Orchestration Guide online.

labels Element

Includes <add> elements that specify key-value pairs for changing text strings in the tasklet user interface, such as messages or headings. For more information, see How to: Change Text on the Tasklet in Microsoft Dynamics Mobile Orchestration Guide online.

Parent Elements

Element Description

tasklet Element

Declares a tasklet for use in an application or orchestration. For more information, see Defining Tasklets in Microsoft Dynamics Mobile Orchestration Guide online.

The <appSettings> element and <labels> element must come before any custom elements in the <configuration> element.

The <appSettings> element is also available under the <userRole> element and the <orchestration> element. Under the <userRole> element, the settings pertain to all instances of the tasklet in the application. Under the <orchestration> element, the settings pertain only to instances of the tasklet in that particular orchestration. For more information, see How to: Configure a Tasklet Using appSettings in Microsoft Dynamics Mobile Orchestration Guide online

This example uses the <configuration> element to configure a tasklet that shows information about the application.

<tasklet name="ShowAbout" text="About Sample Application" type="Microsoft.Dynamics.Mobile.Components.Tasklets.AboutTasklet, Microsoft.Dynamics.Mobile.Framework.Runtime" >
  <configuration>
    <appSettings>
      <add key="ApplicationName" value="Microsoft Dynamics Mobile RolePad" />
      <add key="ApplicationVersion" value="1.0.17" />
      <add key="Copyright" value="Microsoft" />
      <add key="DefaultEmailAddress" value="ms@microsoft.com" />
    </appSettings>
    <labels>
      <add key="ColumnCaption_Address" text="Address" context="Label for the address; 30 characters" />
      <add key="ColumnCaption_Application" text="Application" context=" Label for the application columns; 20 characters" />
      <add key="Label_Copyright" text="Copyright" context="Label for the copyright statement; 20 characters" />
      <add key="MenuItem_Email" text="Send As Email" context="Label for checkbox to send as e-mail; 15 characters" />
    </labels>
  </configuration>
</tasklet>

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

Yes

Community Additions

ADD
Show: