Show All

# task Element

Contains the Microsoft BizTalk Server 2004 Human Workflow Services (HWS) task information enabled for the form.

## Type

`xsd:complexType`

## Child Elements

None.

## Attributes

Attribute | Type | Required | Description | Possible Values
--- | --- | --- | --- | ---
name | `xsf:xdHWSname` | Yes | The unique name of the task, as specified in the HWS Workflow designer; used for the onClick event of the button in the HWS Workflow task pane. | Cannot contain the following characters: \ / " [ ] : < > + = ; , ? * @
taskTypeID | `xsd:string` | Yes | The unique ID for the task. | string
caption | `xsf:xdHWSCaption` | No | The label for the corresponding button in the HWS Workflow task pane to start or respond to a task. | minLength = 1 maxLength = 255

## Definition

    	<xsd:element name="task">
    		<xsd:complexType>
    			 <xsd:attribute name="name" type="xsf:xdHWSname" use="required"/>
    			 <xsd:attribute name="taskTypeID" type="xsd:string" use="required"/>
    			 <xsd:attribute name="caption" type="xsf:xdHWSCaption" use="optional"/>
    		</xsd:complexType>
    	</xsd:element>

## Remarks

The task element is an optional element of the allowedTasks element.

Each task enabled for the form must have a corresponding task element in the allowedTasks section of the form definition file (.xsf).

Note This item is not supported when the Disable Service Pack features option on the Advanced tab of the Options dialog box in InfoPath is selected or when Microsoft Office 2003 Editions Service Pack 1 or later is not installed. Any form defined by a form definition file (.xsf) that includes this item cannot be opened in InfoPath when service pack features are disabled or unavailable.

## Example

The following is an example of the task element:

    <xsf:hwsWorkflow taskpaneVisible="yes">
       <xsf:location url="http://www.contoso.com/hwsservice/hwsservice.asmx"/>
       <xsf:allowedActions>
          <xsf:action  name="approval" actionTypeID="123"
             canInitiateWorkflow="yes" caption="Get Approval"/>
          <xsf:action  name="delegate" actionTypeID="234"
             canInitiateWorkflow="no" caption="Delegate"/>
       </xsf:allowedActions>
       <xsf:allowedTasks>
          <xsf:task name="getManagerApproval" taskTypeID="435"
             caption="Send Response"/>
          <xsf:task name="getVPApproval" taskTypeID="436"
             caption ="Send Response"/>
          <xsf:task name="delegateToManager" taskTypeID="420"
             caption="Respond"/>
       </xsf:allowedTasks>
    </xsf:hwsWorkflow>

    <xsf:hwsAdapter name="Start Approval"
       wsdlUrl="http://www.contoso.com/hwsservice/hwsservice.asmx?WSDL"
       submitAllowed="yes">
       <xsf:hwsOperation type="addActionToNewActivityFlow" typeID="{guid}"
          serviceUrl="http://www.contoso.com/hwsservice/hwsservice.asmx">
          <xsf:input source="HWSMessage1.xml">
             <xsf:partFragment match="/ns1:HWSMessage/ActionSection/param1"
                replaceWith="/my:myFields/my:param1"/>
             <xsf:partFragment match="/ns1:HWSMessage/ActionSection/param2"
                replaceWith="/a:some/b:thing" dataObject="Aux1"/>
          </xsf:input>
       </xsf:hwsOperation>
    </xsf:hwsAdapter>

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp