IBM FileNet P8, Version 5.2.1            

External Clients

You can call the Process Orchestration Web Service from an external client by using the standard request-response methodology.

However, to avoid circumstances where the client might timeout before the Process Orchestration Web Service returns the response, you need to include the following elements:

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

There might be other SOAP headers the client will request the Process Orchestration Web Service to return with the response. If so, these headers 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). For more information, see Creating the WS-Security Header.

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 example shows 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>


Last updated: October 2015
ws_pows_external_clients.htm

© Copyright IBM Corporation 2015.