hwsOperation Element

Microsoft Office InfoPath

previous page next page

hwsOperation Element

Defines the Microsoft BizTalk 2004 Human Workflow Services (HWS) operation type, such as adding an action to a new activity flow, adding an action to an existing activity flow, and responding to a task.

Type

xsd:complexType

Child Elements

Element	Description
input	Specifies the XML form file, which is encoded and submitted with the HWS operation.

Attributes

Attribute	Type	Required	Description	Possible Values
type	`xsd:string`	Yes	Specifies the HWS operation type.	addActionToNewActivityFlow addActionToActivityFlow sendTaskResponse
typeID	`xsd:string`	Yes	Contains the globally unique identifier (GUID) for the operation.	string
serviceUrl	`xsd:string`	Yes	Specifies the Uniform Resource Locator (URL) location of the HWS Web service.	string

Definition

    <xsd:element name="hwsOperation">
  <xsd:complexType>
    <xsd:choice>
      <xsd:element ref="xsf:input"/>
    </xsd:choice>
    <xsd:attribute name="type" type="xsd:string" use="required"></xsd:attribute>
    <xsd:attribute name="typeID" type="xsd:string" use="required"></xsd:attribute>
    <xsd:attribute name="serviceUrl" type="xsd:string" use="required"></xsd:attribute>
  </xsd:complexType>
</xsd:element>

Remarks

Upon submit, the hwsAdapter element automatically creates a globally unique identifier (GUID), as required by the HWS Web service; encodes the XML file; and updates the processing instructions of the XML instance file with the new GUID.

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 hwsOperation 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>

previous page start next page