Transform an object of one type into an object of another type.
The <transform> element is the outermost element for a DTL document. All the other DTL elements are contained within a <transform> element. Within the <transform>, the two objects have the names source and target, respectively. For example:
<trace value='"Convert from lowercase to uppercase"'/>
Source and Target Objects
The sourceClass and targetClass may identify standard production message classes, each of which contains a set of properties. If so, the sourceDocType and targetDocType attributes are not needed.
Alternatively, the sourceClass and targetClass may identify virtual documents. In this case the sourceDocType and targetDocType attributes are needed to tell InterSystems IRIS which message structure to expect in the virtual document.
Values for the create Option
The create option for the target object may have one of the following values:
new — Create a new object of the target type, before executing the elements within the data transformation. This is the default.
copy — Create a copy of the source object to use as the target object, before executing the elements within the transform.
existing — Use an existing object, provided by the caller of the data transformation, as the target object.