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.
<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 | |
|---|---|---|
|
|
Required attribute. The property name of the target tasklet input parameter as defined in the source code of the tasklet. | |
|
|
Optional attribute.
The default is For more information, see Require and Validate User Input in the Microsoft Dynamics Mobile Orchestration Guide. | |
|
|
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 | |
|
|
Optional attribute. Specifies a text string to map to the input parameter of the target tasklet.
|
Child Elements
None.
Parent Elements
| Element | Description |
|---|---|
|
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>
Tasks
How to: Map a Tasklet Output ParameterHow to: Map a Tasklet Output to a Tasklet Input
How to: Map a Static Value to a Tasklet Input Parameter
Reference
actions ElementinputMappings Element
outputMapping Element
Concepts
UserRole Schema Hierarchy StructureDefining Orchestrations in the UserRole
Defining Tasklets
Displaying Data on Tasklets
Other Resources
Mobile OrchestrationTransferring Data Between Tasklets
Require and Validate User Input
Working with Actions for Soft Keys and Menu Items
Note