persistent class EnsLib.PubSub.Target
extends %Persistent, %XML.Adaptor
Represents a target for a publish/subscribe message routing request.
parameter XMLIGNORENULL = 1;
XMLIGNORENULL allows the programmer to override the default XML handling
of empty strings for properties of type %String. By default (XMLIGNORENULL = 0),
empty strings in the XML input are stored as $c(0) and $c(0) is written to XML
as an empty tag. A missing tag in the XML input is always stored as "" and
"" is always output to XML as no tag.
parameter XMLSUMMARY = "Name";
If XMLIGNORENULL is set = 1, then both missing tags in the XML and empty
strings are input as "", and both "" and $c(0) are output as empty tags
If XMLIGNORENULL is set = "inputonly", then both missing tags in the XML and empty
strings are input as "". Output of "" and $c(0) are for XMLIGNORENULL = 0:
$c(0) is output as an empty tag (i.e. <tag></tag>) and "" is output as no tag.
If XMLIGNORENULL = "runtime" (runtime is not case sensitive), then the behavior
of XMLIGNORENULL is determined by the format parameter of XMLExport, XMLImport
and %XML.Reader.OpenFile. The default behavior for XMLIGNORENULL="runtime is
the same as XMLIGNORENULL=0. Adding "ignorenull" to the format argument changes
the behavior to that of XMLIGNORENULL=1. "ignorenull" shoud be separated by a comma
from literal/encoded part of the format. Example values for format are "", ",ignorenull",
"literal,ignorenull" and "encoded,ignorenull".
Note that "inputonly" is equivalent to using ,ignorenull for XMLExport and not for %XML.Reader.
The summary fields to be used when an object is referenced are specified
by the object's XMLSUMMARY class parameter. XMLSUMMARY is a comma separated,
unordered list of properties to include in the object summary. Properties
are mapped to the XML in the order that the properties appear in the class
not in the list order. If XMLSUMMARY is not specified then all properties
are included in the summary.
(internal) This is set for target objects that are to be
deleted when their corresponding response object is deleted.
(optional) External address used to send the message. (For example, an e-mail address).
(Optional) Name of this target
Target to which message should be sent. This is the name of
a configured Business Process or Operation within the current production.