docs.intersystems.com
Home  /  Application Development: Creating Productions  /  Developing DTL Transformations  /  Introduction to DTL Tools


Developing DTL Transformations
Introduction to DTL Tools
[Back]  [Next] 
InterSystems: The power behind what matters   
Search:  


This chapter introduces the tools that InterSystems IRIS™ provides to enable you to develop and test DTL transformations. It contains the following topics:
Background
A data transformation creates a new message that is a transformation of another message. It is common for a production to use data transformations, to adjust outgoing messages to the requirements of the target systems.
A DTL transformation is a transformation that you create and edit the transformation visually in the DTL editor, available in either the Management Portal or Studio. The DTL editor is meant for use by nontechnical users. The term DTL represents Data Transformation Language, which is the XML-based language that InterSystems IRIS uses internally to represent the definition of a transformation that you create in this editor.
You can invoke a data transformation from a business process, another data transformation, or a business rule. Note that there is overlap among the options available in business processes, data transformations, and business rules. For a comparison, see Comparison of Business Logic Tools in Developing Productions.
Introduction to the Data Transformation Builder Page
The Data Transformation Builder page enables you to create, edit, and compile DTL transformations.
To access this page in the Management Portal, select Interoperability > Build > Data Transformations.
When you display this page, it shows the last transformation you opened in this namespace, if any. This page has the following areas:
Tip:
If you open a DTL transformation class in Studio, Studio displays a similar version of this page. You can view and edit the XML definition of the Data Transformation by selecting View other code from the Studio Data Transformation Builder page.
Introduction to the DTL Diagram
The following shows the DTL diagram a DTL class:
Note the following points:
The following shows another example:
In this case, the source and target classes are more complex. Note the following additional points:
Controlling the Display
You can control the display of the Data Transformation Builder page in multiple ways:
Introduction to the Data Transformation List Page
The Interoperability > List > Data Transformations page lists the data transformation classes defined in the current namespace.
This page lists two kinds of transformations:
To use this page, select a transformation class and then click one of the following commands in the ribbon bar:
You can also export and import these classes as you do any other class in InterSystems IRIS. You can use the System Explorer > Globals page of the Management Portal or use the Export and Import commands on the Tools menu in Studio.
Other Tools
You can also invoke a data transformation programmatically, which can be useful for testing purposes. For details, see the chapter Testing Data Transformations.”
Also, because data transformations are classes, you can edit them and work with them in the same way that you do any other class.
Using Data Transformations
You can invoke a data transformation from the following parts of a production:
Note:
This section applies to both DTL transformations and custom transformations.