previous Element

Opens the tasklet of the previous designated step in a wizard as defined by the <wizardSteps> element.

For information about wizards, see Defining a Wizard in Microsoft Dynamics Mobile Orchestration Guide online.

userRole Element

    orchestrations Element

         orchestration Element

             tasklets Element

                 tasklet Element

                     actions Element

                         previous Element


<previous context="describe text" icon="image file" name="reference name" priority="priority number" text="menu label" validate="true|false" />

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.

icon

Optional attribute.

The full path and file name of a bitmap file that is associated with the action. You can develop tasklets to use this attribute as needed.

name

Optional attribute.

A unique reference name for the action.

priority

Optional attribute.

A whole number to determine the location of the action on the soft keys and menu by comparing it with the priorities of other actions on the tasklet:

  • The action with the highest priority number is located on the left soft key.

  • The action with the second highest priority number is located at the top of the right soft key menu.

  • Subsequent actions are located in descending order of priority in the right soft key menu.

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

text

Required attribute.

Specifies the label of the action on the soft key or menu of the tasklet user interface.

validate

Optional attribute.

true calls the tasklet validation method Validate for the open tasklet when the <previous> element action is initiated; otherwise, false.

true is default.

For more information, see How to: Validate User Input to a Tasklet in Microsoft Dynamics Mobile Orchestration Guide online.

Child Elements

Element Description

constraints Element

Specifies state keys for tasklet output parameters that must have values before the action is enabled in the tasklet user interface.

inputMappings Element

Maps tasklet output parameter values to the input parameters of the tasklet in the previous wizard step.

Parent Elements

Element Description

actions Element

Specifies the actions available from a tasklet or orchestration. Actions appear as menu items or soft keys.

This example shows how to use the <previous> element in a wizard that creates a new customer.

<orchestration name="NewCustomerWizard" text="New Customer">
  <wizardSteps>
    <wizardStep tasklet="CustomerDetails" />
    <wizardStep tasklet="CreditLimit" />
    <wizardStep tasklet="ContactDetails" />
  </wizardSteps>
  <actions>
    <exitOrchestration priority="-1" text="Cancel" submitRequestDocument="false"  result="Cancel"/>
  </actions>
  <tasklets>
    <tasklet name="CustomerDetails" text="Customer Details" type="CustomerDetailTasklet. CustomerDetailTasklet, CustomerDetailTasklet ">
      <outputMappings>
        <outputMapping propertyName="CustomerType" stateKey="CustomerType"/>
        <outputMapping propertyName="CustomerName" stateKey="CustomerName"/>
      </outputMappings>
      <actions>
        <next priority="2" text="Next" validate="true"/>
      </actions>
    </tasklet>
    <tasklet name="CreditLimit" text="Credit Limit" type="CustomerCreditLimitDetailTasklet. CustomerCreditLimitDetailTasklet, CustomerCreditLimitDetailTasklet ">
      <outputMappings>
        <outputMapping propertyName="CreditLimit" stateKey="CreditLimit"/>
      </outputMappings>
      <inputMappings>
        <inputMapping propertyName="CustomerType" stateKey="CustomerType"/>
         <inputMapping propertyName="CustomerName" stateKey="CustomerName"/>
      </inputMappings>
      <actions>
        <previous priority="1" text="Previous" />
        <next priority="2" text="Next">
          <constraints>
            <required stateKey="CreditLimit"/>
          </constraints>
        </next>
      </actions>
    </tasklet>
    <tasklet name="ContactDetails" text="Contact Details" type="CustomerContactDetailTasklet.CustomerContactDetailTasklet, CustomerContactDetailTasklet">
      <inputMappings>
        <inputMapping propertyName="CustomerName" stateKey="CustomerName"/>
      </inputMappings>
      <actions>
        <previous priority="1" text="Previous"/>
        <exitOrchestration priority="2" text="Finish" submitRequestDocument="true"  result="OK"/>
      </actions>
    </tasklet>
  </tasklets>
</orchestration>

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: