pp108 : setReceiver()

setReceiver()


It sets the receiver property of the instance object.

Setting a receiver ensures that the SOAP message reaches a specific service. Generally, the receiver of the message is determined by the Gateway . When the Gateway receives a message, it looks for a SOAP node that implements the namespace specified in the message and sends the message to that service. There can be more than one SOAP node implementing the namespace. If the message must be sent to a specific service, instead of the service determined by Gateway, this method can be used.

Syntax

Script

instanceID.setReceiver(sReceiver


Parameters

Parameter

Description

sReceiver

This parameter is required. String that denotes the receiver to which request is sent. It can be the distinguished name (DN) of a SOAP Processor or a SOAP Node or a Connection Point or can be the URL of a Web service.


Return Value


No value is returned.

Sample Code


This sample code demonstrates how the method can be used.

var newInstance = WebForm.getInstance("", "http://schemas.cordys.com/Employees", "Employees", application);
//Set receiver property to a SOAP Processor in System organization
newInstance.setReceiver("cn=SQL Processor,cn=SQL Service,cn=soap nodes,o=System,cn=cordys,o=vanenburg.com");

Applies to


Instance

Related reference

Receiver
Instance