requiredRequest Element
Defines a set of tasklets that contribute content to a request document that is sent to the business solution for processing. A request document for an orchestration is defined by the <requestDocument> element. When a user navigates through an orchestration, tasklets gather data. A request document contains the data contributed by the individual tasklets defined in the <requiredRequest> element.
For more information about request documents, see Setting up Request Documents in Microsoft Dynamics Mobile Orchestration Guide online.
<requiredRequests> <request name="tasklet1 name" /> <request name="tasklet2 name" /> </requiredRequests>
Sending a request document requires that the orchestration includes an <exitOrchestration> element that has its submitRequestDocument attribute set to true. For more information, see exitOrchestration Element.
This example demonstrates how to define a request document for 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>