- Create a relationship name with one of
the following:
- Select New Relationship Definition from the
File menu.
- Use the keyboard shortcut 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 so, select the relationship definition name and perform one of the
following actions:
- Select Add Participant Definition from the
File menu.
- 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 with one of the following:
- Select Save Relationship Definition from the
File menu.
- Use the keyboard shortcut 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
ICS 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. For more information about starting and stopping a
relationship, see the User Guide for WebSphere Business Integration
Express for Item Synchronization.
- Compile and deploy the map that uses the relationship. If the map
is deployed and compiled successfully in ICS Express, ICS Express creates the
executable map code and activates the map. For more information, see "Compiling a map".