action Element
Contains the Microsoft Biztalk Server 2004 Human Workflow Services (HWS) action information that has been 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 action as specified by the HWS workflow designer, and used for the onClick event of the button in the Workflow task pane. | Cannot contain the following characters: \ / " [ ] : < > + = ; , ? * @ |
| actionTypeID | xsd:string |
Yes | The unique ID for the action. | string |
| canInitiateWorkflow | xsf:xdYesNo |
Yes | Indicates whether the action can be used to start an activity flow. |
|
| caption | xsf:xdHWSCaption |
No | The label for the corresponding button in the Workflow task pane to start the action. | minLength = 1 maxLength = 255 |
Definition
<xsd:element name="action" >
<xsd:complexType>
<xsd:attribute name="name" type="xsf:xdHWSname" use="required"></xsd:attribute>
<xsd:attribute name="actionTypeID" type="xsd:string" use="required"></xsd:attribute>
<xsd:attribute name="canInitiateWorkflow" type="xsf:xdYesNo" use="required"></xsd:attribute>
<xsd:attribute name="caption" type="xsf:xdHWSCaption" use="optional"></xsd:attribute>
</xsd:complexType>
</xsd:element>
Remarks
The action element is an optional element of the allowedActions element.
Each action enabled for the form must have a corresponding action element in the allowedActions 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 action 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>