Specifying map property information

Use the Map Properties dialog (see Figure 26) to display and specify property information for a map. To display the Map Properties dialog, perform any of the following actions:

The Map Properties dialog provides the following tabs:

Figure 26 shows the General tab of the Map Properties dialog.

Figure 26. General tab of Map properties dialog

Defining General Property information

The General tab of the Map Properties dialog displays the general property information shown in Table 19.

Table 19. General Map Property Information
General Map Property Description For more information
Map name Identifies the map whose properties the dialog displays. This field is initialized when you create a new map and is not an editable field. N/A
Mapping role

Identifies the purpose of the map. Possible values of mapping roles are:

  • Application-specific to generic
  • Generic to application-specific
  • Other (for maps that do not have a specific mapping direction associated with them)

Note:
For previously defined maps that do not have this property information, the combo box will be empty. This is permissible as long as you do not use any Relationship transformation rules. When you first create a Relationship transformation rule and this value is empty, Map Designer Express will prompt you for this value.
Run-time properties Specifies the map properties (trace level, data validation level, implicit database transaction, and fail on invalid data) that apply to the map instance at run time. You can specify these properties here in the General tab of Map Designer Express's Map Properties dialog or from the Map Properties window that System Manager provides. The changes are made to the local file system. Deploying the map to the server will not update the run-time instance.
Note:
You can update these map properties dynamically from the server component management view by right-clicking on a map and selecting the properties from the Context menu. The changes will be automatically updated to the server.
Trace level Sets the trace level for the map. Adding trace messages
Data validation level Allows you to check each operation in a map and log an error when data in the incoming business object cannot be transformed. Creating custom data validation levels
Implicit Database transaction Determines whether InterChange Server Express uses implicit transaction bracketing for transactions over its connections.
Fail on invalid data Determines whether map execution fails if data is invalid. Creating custom data validation levels
Variable declarations You can declare your own Java variables to use in your transformation code. For more information, see Using variables.
Map file declaration block Allows you to import Java packages (such as MapUtils) into a map for use within transformation code. Importing Java packages and other custom code
Map local declaration block Allows you to import custom Java code developed outside of Map Designer Express into a map for use within transformation code. Importing Java packages and other custom code

Defining business objects

The Business Objects tab of the Map Properties dialog displays information about the map's business objects. It lists the source and destination business objects as well as any temporary business object that might be defined. For more information, see Steps for modifying business object variables.

Copyright IBM Corp. 2004, 2005