add Element (under labels element)

The <add> element under the <labels> element defines a key-text pair for changing text strings that appear in the tasklet user interface. You can define the key-text pairs on a global basis for all instances of a tasklet in the application, or directly on the instance of a tasklet in an orchestration.

userRole Element

    orchestrations Element

        orchestration Element

            tasklets Element

                tasklet Element

                    configuration Element

                        labels Element

                            add Element (under labels element)

    tasklets Element

        tasklets Element

            configuration Element

                labels Element

                    add Element (under labels element)


<add key="key ID" value="value setting" />

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 usage or maximum number of characters. Useful for translation and localization.

key

Required attribute.

The key identifier of the configuration setting.

text

Required attribute.

Specifies the text used for the label associated with the key identifier.

Child Elements

None.

Parent Elements

Element Description

appSettings Element

Identifies key-value pairs to configure custom settings for tasklets. For details, see add Element (under appSettings element).

labels Element

Identifies key-value pairs to change text strings displayed in the tasklet user interface.

The following example uses <add> elements to configure a tasklet that displays information about the application. The <add> elements under the <labels> element define some of the UI text strings. The tasklet has an option that allows the user to send the application information as an e-mail to a designated recipient. The <add> element under the <appSettings> element defines the recipient's e-mail address.

<tasklet name="ShowAbout" text="About Sample Application"  type="Microsoft.Dynamics.Mobile.Components.Tasklets.AboutTasklet, Microsoft.Dynamics.Mobile.Framework.Runtime" >
  <configuration>
    <appSettings>
      <add key="DefaultEmailAddress" value="ms@microsoft.com" />
    </appSettings>
    <labels>
      <add key="ColumnCaption_Address" text="Address" context="" />
      <add key="ColumnCaption_AgentSet" text="Agentset" context="" />
      <add key="TabPage_Agents" text="Agents" context="" />
      <add key="ColumnCaption_Application" text="Application" context="" />
      <add key="ColumnCaption_Assembly" text="Assembly" context="" />
    </labels>
  </configuration>
</tasklet>

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: