-
Create a relationship name
by doing one of the following:
- From the File menu, select New
Relationship Definition
- Use the keyboard shortcut of Ctrl+N.
- In the Standard
toolbar, click the New Relation button.
- Name the icon for the relationship definition.
Rule: Relationship
definition names can be up to 8 characters long, can contain only
letters and numbers, and must begin with a letter.
- Create a participant
definition for each business object to be related.
To do this, select the relationship definition name and perform
one of the following actions:
- From the File menu, select Add
Participant Definition.
- In the Standard
toolbar, click the New Participant button.
-
For each participant definition,
name the icon for the participant definition.
Rule: Participant
definition names can be up to 8 characters long, can contain only
letters and numbers, and must begin with a letter.
-
Associate a data type with
each participant by
dragging the type from the Participant
Types window onto the participant definition.
Tip: To display the Participant Types window,
select Participant Types from the View
menu.
- To associate a business object data type, drag the business
object definition from the Participant Types window.
The participants in an identity relationship use business object
definitions as their participant
type. For more information, see Defining identity relationships.
- To associate a Java data type, drag the Data participant type
from the Participant Types window.
In the relationship definition, the Data participant type represents all data types
other than business object types. The participants in a lookup relationship
use Data as their participant type. For more information, see Defining lookup relationships.
- For participant types that are business object definitions,
add or change the attributes to associate with the participant.
The attributes you select become the basis on which the business
objects are related.
-
Save the relationship
definition by doing one of the following:
- From the File menu, select Save
Relationship Definition.
- Use the keyboard shortcut of Ctrl+S.
- In the Standard
toolbar, click the Save Relation button.
-
Before executing a map that
uses the relationship definition, perform the following steps:
- Activate the relationship. After the relationship is deployed
to InterChange Server Express,
this new relationship is not activated.
However, for the Mapping API methods to be able to access the relationship
tables, a relationship table must be active. To activate the relationship,
click the relationship name in System Manager and select the Start
option from the Component menu.
- Compile and deploy the map that uses the relationship.
Result: If the map is deployed and compiled
successfully in InterChange Server Express, InterChange Server Express creates
the executable map code and activates the map. For more information,
see Compiling a map.