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.

userRole Element

    orchestrations Element

        orchestration Element

            requestDocument Element

                requiredRequest Element


<requiredRequests>
  <request name="tasklet1 name" />
  <request name="tasklet2 name" />
</requiredRequests>

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

Attributes

None.

Child Elements

Element Description

request Element

Specifies a tasklet that contributes to the request document.

Parent Elements

Element Description

requestDocument Element

Defines a request document for an orchestration.

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>

Required

No

Max. occurrences

1 within the parent element

Namespace

schemas.microsoft.com/Dynamics/Mobile/2007/04/Flow

Schema Name

UserRole Schema

Validation File

Orchestration.vsd

Can be Empty

No

Community Additions

ADD
Show: