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.
<configuration>
<appSettings>...</appSettings>
<labels>...</labels>
</configuration>
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child Elements
| Element | Description |
|---|---|
|
Includes | |
|
Includes |
Parent Elements
| Element | Description |
|---|---|
|
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>
Tasks
How to: Configure a Tasklet Using appSettingsHow to: Change Text on the Tasklet
Reference
userRole Elementorchestration Element
tasklet Element
appSettings Element
labels Element
add Element (under labels element)
add Element (under appSettings element)
Concepts
UserRole Schema Hierarchy StructureConfiguring Tasklets
Defining Orchestrations in the UserRole
Defining Tasklets
Other Resources
Mobile OrchestrationCustomizing Tasklets
How to: Add appSettings Configurations
How to: Add Text Labels