Name objects

Several objects that do exist in the integration engine can be used in expressions: variables, input documents, user-defined-functions, and tables.

Many of these objects are sources of data. The main purpose of the language is to generate data from other data, either to control the input or to make the output.

When using Axway Mapping Services, all the available objects are categorized in entities and folders and each has a name. If you want to refer to one of these objects in an expression, you use that triplet known as fully qualified name. Some characters are used to separate these three parts of a name:

myentity.myrootfolder\onesubfolder\anotherone.myobject

Names are composed of letters only (either capital or not), digits, and the underscore sign (_). But, if you’ve defined an object named 0695, you must surround its name by exclamation marks in expressions. In DML expressions, the object 0695 is referred to as !0695!. Those marks are required for every name that starts with a reserved keyword or includes a reserved character.

You can omit entities and folders; and you can name the same object:

  • myentity.myrootfolder\onesubfolder\anotherone.myobject
  • myrootfolder\onesubfolder\anotherone.myobject or even just:
  • myobject

When the integration engine server detects a shortened name, it completes the name to a full name using the current context. This means that the missing entity and folders are implicitly those of the object to which the expression is bound.

When dealing with a Validation Rule, implicit entity and folders are those of the Business Document to which the constraint is bound. When dealing with a Decision-Path or a Map, the bound DML Block is used.

Folders can group not only objects, but also other folders so you can create a complete hierarchy of folders to categorize your objects. When you specify the folders in a name, you must state all the folders and subfolders separated by a reverse slash. However, you can omit the very first folder in the folder hierarchy. In that case, you must just omit the root folder name as in the following example:

\onesubfolder\anotherone.myobject

In most cases, you use raw names to refer to objects in expressions. There are two exceptions to this situation: variable names and paths to input Business Document nodes.

For variable names, a percent symbol (%) is always used to introduce the name:

%myvariable

or, fully qualified:

%myentity.folder1\folder2.myvariable

All the aspects of paths to Business Document nodes are examined later in this document.

Related Links