group Element

Groups one or more actions together in the right-side soft key menu. Actions are grouped using dividing lines, or in a submenu.

For more information on grouping, see How to: Group Actions in the Menu and Submenus in Microsoft Dynamics Mobile Orchestration Guide online.

userRole Element

    orchestrations Element

        orchestration Element

            actions Element

                group Element

            tasklets Element

                tasklet Element

                    actions Element

                        group Element

    tasklets Element

        tasklet Element

            actions Element

                group Element


<group context="describe text" name="group name" priority="priority number" text="menu label" type"Flat|Node">
    <open>…</open>
</group>

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

Attributes

Attribute Description

context

Optional attribute.

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

name

Required attribute.

Unique reference name for the group.

priority

Optional attribute.

A whole number used to determine the location of the group in the menu by comparing the value with the priority of the other actions in the menu. The group is placed above actions that have a lower priority and below actions that have a higher priority.

For more information, see Arranging Actions on Soft Keys and Menu Items in Microsoft Dynamics Mobile Orchestration Guide online.

text

Optional attribute.

Specifies the text label for the group in the menu. This is not used when the type is set to flat.

type

Optional attribute.

flat groups the actions inline with the other actions of the menu. The group is separated above and below by a horizontal line.

node groups of actions in a submenu that is accessed from a menu item with the label specified by the text attribute.

Child Elements

Element Description

exitOrchestration Element

Closes an orchestration.

exitTasklet Element

Closes a tasklet.

group Element

Groups actions in the soft key or context menus using dividing lines, or a submenu.

next Element

Opens the tasklet used in the next step of a wizard.

open Element

Opens a tasklet or an orchestration.

previous Element

Opens the tasklet used in the previous step of a wizard.

Parent Elements

Element Description

actions Element

Defines actions that navigate to other tasklets and orchestrations.

The following example groups actions on a tasklet in a flat and submenu structure. The action with the text About is grouped alone in a flat structure, separated by horizontal lines. The three actions Synchronize, Credentials, and Document Status are grouped in a submenu to a menu item called Tools.

<tasklet name="CustomerListTasklet" text="Customer List" type="CustomerListTasklet.CustomerListTasklet, CustomerListTasklet">
  <actions>
    <open text="Details" orchestration="CustomerDetailReadOnly" priority="40" />
    <open text="New" orchestration="NewCustomerWizard" priority="31" />
    <open text="Edit" orchestration="CustomerDetailEdit" priority="30" />
    <group name="MenuGroup" text="MenuGroup" type="Flat" priority="10">
      <open text="About" tasklet="ShowAbout" priority="20" />
    </group>
    <group name="Tools" text="Tools" type="Node" priority="11">
      <open text="Synchronize" tasklet="Synchronization" />
      <open text="Credentials" tasklet="Credentials" />
      <open text="Document Status" tasklet="History" />
    </group>
    <exitOrchestration text="Close" />
  </actions>
</tasklet>

Required

No

Unlimited

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: