Business Process and Data Transformation Language Reference
DTL <code>
[Back] [Next]
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Execute lines of custom code.
Synopsis
<code>
  <![CDATA[ target.Name = source.FirstName & " " & source.LastName]]>
</code>
Elements
Element Purpose
<annotation> Optional. A text string that describes the <code> element.
Description
The DTL <code> element executes one or more lines of user-written code within a DTL data transformation. You can use the <code> element to perform special tasks that are difficult to express using the DTL elements. Any properties referenced by the <code> element must be properties within the source or target object for the data transformation.
The scripting language for a DTL <code> element is specified by the language attribute of the containing <transform> element. The values basic or objectscript indicate Caché Basic or ObjectScript. If not specified, the default is ObjectScript. MVBasic is not supported. Any expressions found in the data transformation, as well as lines of code within <code> elements, must use the specified language.
For further information about these Caché programming languages, see the following books:
Typically a developer wraps the contents of a <code> element within a CDATA block to avoid having to worry about escaping special XML characters such as the apostrophe (') or the ampersand (&) . For example:
<code>
  <![CDATA[ target.Name = source.FirstName & " " & source.LastName]]>
</code>
In order to ensure that execution of a data transformation can be suspended and restored, you should follow these guidelines when using the <code> element: