inputMapping Element

Transfers a tasklet output parameter from state memory to a tasklet input parameter using an assigned state key. You set up the <inputMapping> element under an action of a tasklet or orchestration. The output parameter value maps to the input parameter of the tasklet that opens as a result of the action.

For more information on tasklet output and input mapping, see Transferring Data Between Tasklets in Microsoft Dynamics Mobile Orchestration Guide online.

userRole Element

    orchestrations Element

         orchestration Element

             actions Element

                 exitOrchestration Element

                     inputMappings Element

                         inputMapping Element

                 exitTasklet Element

                     inputMappings Element

                         inputMapping Element

                 open Element

                     inputMappings Element

                         inputMapping Element

             tasklets Element

                 tasklet Element

                     inputMappings Element

                         inputMapping Element

                     actions Element

                         exitOrchestration Element

                             inputMappings Element

                                 inputMapping Element

                         exitTasklet Element

                             inputMappings Element

                                 inputMapping Element

                         next Element

                             inputMappings Element

                                 inputMapping Element

                         open Element

                             inputMappings Element

                                 inputMapping Element

                         previous Element

                             inputMappings Element

                                 inputMapping Element

    tasklets Element

         tasklet Element

             inputMappings Element

                 inputMapping Element


<inputMapping propertyName="input parameter property name" required="true|false" stateKey="stateKey name" value="text string" />

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

Attributes

Attribute Description

propertyName

Required attribute.

The property name of the target tasklet input parameter as defined in the source code of the tasklet.

required

Optional attribute.

true makes it mandatory that an input parameter value is set for the target tasklet to open; otherwise, false.

The default is true.

For more information, see Require and Validate User Input in the Microsoft Dynamics Mobile Orchestration Guide.

stateKey

Optional attribute.

The state key identifier assigned to the tasklet output parameter value to map to the input parameter of the target tasklet. The state key identifier is defined by an <outputMapping> element.

value

Optional attribute.

Specifies a text string to map to the input parameter of the target tasklet.

The text string must be compatible with the tasklet input parameter type. For example, if the input parameter is a Boolean type, then true and false are acceptable values. For more information, see How to: Map a Static Value to a Tasklet Input Parameter in Microsoft Dynamics Mobile Orchestration Guide .
NoteNote

Child Elements

None.

Parent Elements

Element Description

inputMappings Element

Defines the input mappings that transfer tasklet output parameter values to the input parameters of other tasklets.

Tasklet output parameters are mapped to state using the <outputMapping> element. State is a memory representation of a tasklet output parameter that allows it to be mapped as an input parameter to one or more tasklets. The <outputMapping> element assigns a state key identifier to the tasklet output parameter. The inputMapping Element uses this state key to identify the state and make the transfer to the tasklet input parameter.

This example shows how to use the <inputMapping> element to transfer data to tasklets in a wizard that creates a new customer.

<orchestration name="NewCustomerWizard" text="New Customer">
  <confirmClose text="The customer data will be lost. Are you sure you want to close?" />
  <requestDocument name="CreateCustomer" stamps="1" text="Create a customer">
    <requiredRequests>
      <request name="CustomerDetails"/>
      <request name="CreditLimit"/>
      <request name="ContactDetails"/>
    </requiredRequests>
  </requestDocument>
  <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

Not applicable.

Community Additions

ADD
Show: