Share via


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:

\ / " [ ] : < > + = ; , ? * @

  xsf:xdHWSname
actionTypeID
  xsd:string
Yes The unique ID for the action. string
  xsd:string
canInitiateWorkflow
  xsf:xdYesNo
Yes Indicates whether the action can be used to start an activity flow.
  • yes
  • no
  xsf:xdYesNo
caption Attribute
  xsf:xdHWSCaption
No The label for the corresponding button in the Workflow task pane to start the action.

minLength = 1

maxLength = 255

  xsf:xdHWSCaption

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   If this element or attribute is in the form definition file (.xsf), InfoPath Forms Services will prevent the form template from being deployed to the server as a browser-compatible form.

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>