userRole Element

This element is the root element of the UserRole.xml file.


<userRole minimize="true|false" xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Flow" />

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

Attributes

Attribute Description

minimize

Optional attribute.

Specifies whether the application stops running or closes but remains running in device's system memory when the user exits the application.

The application closes when the user exits the tasklet that opens when the application starts.
NoteNote

xmlns

Required attribute.

Declares the namespace for the XML file. The namespace is used to ensure that elements and attributes have a unique name. The value must be a URL reference. The URL is not read as a Web site. It is parsed as a text string. So it does not need to be a valid Web address.

minimize Attribute

Value Description

false

Stops the application when the user exits the application.

true

Minimizes the application when the user exits the application. The application runs in device's system memory until it is stopped manually. This is the default setting if the attribute is not specified.

Child Elements

Element Description

appSettings Element

Contains <add> elements for configuring the application.

menu Element

Specifies the label for the soft key on the right.

If there is only one action defined on the soft key on the right, then the soft key inherits the text defined in the <action> element.
NoteNote

orchestrations Element

Defines the orchestrations for the mobile application. An application can consist of one or more orchestrations.

tasklets Element

Defines the tasklets of the application.

Parent Elements

None.

The following example demonstrates how the application stops upon exiting.

<userRole minimize="false" xmlns="http://schemas.microsoft.com/MobileApplicationFramework/UserRole" >
</userRole>

Required

Yes

Max. occurrences

1

Namespace

schemas.microsoft.com/Dynamics/Mobile/2007/04/Flow

Schema Name

UserRole Schema

Validation File

Orchestration.xsd

Can be Empty

No

Community Additions

ADD
Show: