External Clients

You can call the Process Orchestration Web Service from an external client using the standard request-response methodology. However, to avoid circumstances where the client may timeout before the Process Orchestation Web Service returns the response, you need to include:

Note that this is a synchronous operation, so the client also needs to supply an endpoint to receive the response.

If there are other SOAP headers the client would want Process Orchestration Web Services to return with the response, these can be included as child elements of the wsa:ReferencesProperties element (a child of the ReplyTo element).

Calls to the Process Orchestration Web Service require a WS-Security header if the receive operation has the Authentication flag enabled (defaults to disabled). See Creating the WS-Security Header for more information.

The schema for ReplyHeader is as follows:

<xsd:schema elementFormDefault="qualified" targetNamespace="http://www.filenet.com/process/p8-3x/2004/XMLSchema"
    xmlns:tns="http://www.filenet.com/process/p8-3x/2004/XMLSchema"
    xmlns:wsa="http://schemas.xmlsoap.org/ws/2003/03/addressing"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	<xsd:import namespace="http://schemas.xmlsoap.org/ws/2003/03/addressing"
	    schemaLocation="http://schemas.xmlsoap.org/ws/2003/03/addressing"/>
    <xsd:element name="ReplyHeader">
        <xsd:annotation>            
            <xsd:documentation>Defines the header info for reply</xsd:documentation>           
        </xsd:annotation>
        <xsd:complexType>
            <xsd:sequence>
                <xsd:element maxOccurs="1" minOccurs="0" ref="wsa:MessageID"/>
                <xsd:element maxOccurs="1" minOccurs="1" ref="wsa:ReplyTo"/>
            </xsd:sequence>
        </xsd:complexType>
    </xsd:element>
</xsd:schema>

The following is an example of a client request (another Process Orchestration workflow with the Invoke instruction) with a ReplyHeader and endpoint specified:

<ReplyHeader xmlns="http://www.filenet.com/process/p8-3x/2004/XMLSchema">
    <MessageId xmlns="http://schemas.xmlsoap.org/ws/2003/03/addressing">
        17738CED230FC7468AEC998398C2016F
    </MessageId>
    <ReplyTo xmlns="http://schemas.xmlsoap.org/ws/2003/03/addressing">
        <Address>http://hqamber:8080/Workplace/P8BPMWSBroker/ASyncReply</Address>
        <ReferenceProperties>
            <ReplySOAPAction xmlns="http://www.filenet.com/process/p8-3x/2004/XMLSchema">
                http://www.filenet.com/process/p8-3x/2004/%7E%7E1%09VWService0%3Ahqruby%3AFileNet%091%09279%098%091081529316!
                ReceiveLaunchAccountManagerAtt!accountManager!newCustomer!-2!4!6!Test!%7B5E2D2882-6C7D-4142-BE64-7777562733C0%7D!
                reply!17738CED230FC7468AEC998398C2016F
            </ReplySOAPAction>
        </ReferenceProperties>
    </ReplyTo>
</ReplyHeader>