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.
<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 |
|---|---|
|
|
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. |
|
|
Required attribute. Unique reference name for the group. |
|
|
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. |
|
|
Optional attribute. Specifies the text label for the group in the menu. This is not used when the |
|
|
Optional attribute.
|
Child Elements
| Element | Description |
|---|---|
|
Closes an orchestration. | |
|
Closes a tasklet. | |
|
Groups actions in the soft key or context menus using dividing lines, or a submenu. | |
|
Opens the tasklet used in the next step of a wizard. | |
|
Opens a tasklet or an orchestration. | |
|
Opens the tasklet used in the previous step of a wizard. |
Parent Elements
| Element | Description |
|---|---|
|
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>
Tasks
How to: Group Actions in the Menu and SubmenusReference
tasklet Elementactions Element
open Element
Concepts
UserRole Schema Hierarchy StructureArranging Actions on Soft Keys and Menu Items
Defining Orchestrations in the UserRole
Defining Tasklets
Other Resources
Mobile OrchestrationWorking with Actions for Soft Keys and Menu Items