Event.Ext.routeToExt()

Signature

SimpleEvent routeToExt(SimpleEvent event, String destinationPath, String properties, boolean forceImmediate) throws Exception

Domain

ACTION, BUI

Description

Sends a SimpleEvent to a Destination with custom destination properties. The Destination in turn specifies the Channel where the Event will be sent.

Parameters

NameTypeDescription
eventSimpleEventThe simpleEvent to be sent.
destinationPathStringdestination in it.
propertiesStringA list of property name-value pairs in the format [name1=value1;name2=value2;...;] When present in the name or value each character [ =, or \] should be escaped with two antislash [ \ ] characters. E.G. 2=1+1 should be written as 2\\=1+1 and 2\3\4 should be written as 2\\\\3\\\\4.
forceImmediatebooleanIf true, the event will be immediately passed off to the specified destination to be sent.

Returns

TypeDescription
SimpleEventThe same value as the argument evt, or null if the event was not sent.

Cautions

This method may throw an Exception. Custom channels may not support overriding of destination properties.