updateParticipantByInstance()

Updates a participant in a specific relationship instance.

Syntax

To update a participant in a specific relationship instance:

void updateParticipantByInstance(String relDefName,
        String partDefName, int instanceId [ , BusObj partData ] )
  
 void updateParticipantByInstance(Participant participant)
 

Parameters

relDefName
Name of the relationship definition.
partDefName
Name of the participant definition.
instanceId
The relationship instance ID that identifies the relationship to which the participant belongs.
partData
Data to associate with the participant. Can be one of the following data types: BusObj. This parameter is optional.
participant
Participant to update in the relationship.

Return values

None.

Exceptions

RelationshipRuntimeException 
 

Notes

The updateParticipantByInstance() method updates the non-key attributes of the business object associated with the specified participant. Only the attributes that are associated with the relationship definition are updated.

To modify a key attribute or a participant type that is not a business object (such as String, long, int, double, float, or boolean), you must first delete the participant using deleteParticipant() or deactivateParticipant() and then add a new participant using addMyChildren().

The updateParticipantByInstance() method is a class method declared as static. You can call this method from an existing relationship instance or by referencing the Relationship class.

See also

deleteParticipant(), deactivateParticipant(), addMyChildren()

Copyright IBM Corp. 2003