Data Transformation Engine Services Guide

Chapter 3 – CORBA Interface Definition Language (IDL)
19
Chapter 3 – CORBA Interface
Definition Language (IDL)
The Interface Definition for the CORBA Transformation Server is as follows:
The CORBA interface consists of a user-defined exception and a method, described below:
DteServException
This is a user-defined exception.
- nError
This is the error code for the exception.
- sError
This should contain the error message for the exception.
transform()
This is the method that the CORBA client invokes. The method takes in three arguments and returns
output data in a string. It will raise an exception if the transformation fails.
- mapName
The first argument mapName specifies the name of the compiled map file that needs to be
executed.
- data
The second argument
data specifies the input data from the client. If there is no input data, this
argument should be specified as empty string (“”). Otherwise, this data will override input card
number 1. This argument cannot be NULL because CORBA does not allow NULL arguments.
- outputCardNumber
The third argument
outputCardNumber is an output card number or 0. A map may have many
output cards. Only one output card can be overridden. If this number is a valid output card number,
the specified output card is overridden and the transformed data sent back to the client. If 0, no
output card is overridden and the map output is written out as specified by the map settings.
- string returned
interface DTEORBServ
{
exception DteServException{ short nError; string sError; };
string transform( in string mapName,
in string data,
in short outputCardNumber )
raises(DteServException);
};