com.ibm.wbiserver.rel

Interface RelationshipService


  1. public interface RelationshipService
The RelationshipService interface represents the client programming model for the Relationship Service. The RelationshipService provides operations for Relationship and Role management.


Field Summary

Modifier and Type Field and Description
  1. static
  2. java.lang.String
COPYRIGHT

Method Summary

Modifier and Type Method and Description
  1. int
addParticipant(java.lang.String relationshipName,java.lang.String roleName,commonj.sdo.DataObject bo)
Adds a participant to a new relationship instance.
  1. int
addParticipantBoolean(java.lang.String relationshipName,java.lang.String roleName,boolean dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
addParticipantBooleanWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,boolean dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
addParticipantDouble(java.lang.String relationshipName,java.lang.String roleName,double dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
addParticipantDoubleWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,double dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
addParticipantFloat(java.lang.String relationshipName,java.lang.String roleName,float dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
addParticipantFloatWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,float dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
addParticipantInt(java.lang.String relationshipName,java.lang.String roleName,int dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
addParticipantIntWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,int dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
addParticipantLong(java.lang.String relationshipName,java.lang.String roleName,long dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
addParticipantLongWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,long dataSimpleType)
Adds a participant for an existing relationship instance.
  1. void
addParticipants(java.lang.String relationshipName,java.util.HashMap iid_subMap)
Adds mulitple participants to multiple relationship instances for multiple roles.
  1. void
addParticipants(java.lang.String relationshipName,java.lang.String roleName,java.util.HashMap iid_value)
Adds multiple participants to multiple relationship instances for a role.
  1. int
addParticipantString(java.lang.String relationshipName,java.lang.String roleName,java.lang.String dataString)
Adds a participant to a new relationship instance.
  1. int
addParticipantStringWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,java.lang.String dataString)
Adds a participant for an existing relationship instance.
  1. void
addParticipantsWithID(java.lang.String relationshipName,int instanceid,java.util.HashMap roleName_value)
Adds multiple participants to a relationship instance for multiple roles.
  1. int
addParticipantsWithoutID(java.lang.String relationshipName,java.util.HashMap roleName_value)
Adds multiple participants to a new relationship instance for multiple roles.
  1. int
addParticipantWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceId,commonj.sdo.DataObject bo)
Adds a participant for an existing relationship instance that match this relationship, ASBO role and instance id.
  1. void
correlate(java.lang.String relationshipName,java.lang.String inputRoleName,java.lang.String outputRoleName,commonj.sdo.DataObject inputBO,commonj.sdo.DataObject outputBO,commonj.sdo.DataObject originalInputBO,commonj.sdo.DataObject originalOutputBO,java.lang.String callingContext)
Correlates an inputBO of the given inputRoleName with the outputBO of the given outputRoleName and maintains the relationship between them according to the meta data contained in the inputBO (currently either verb or change summary information or both).
  1. void
correlateFromList(java.lang.String relationshipName,java.lang.String inputRoleName,java.lang.String outputRoleName,java.util.List inputBOs,commonj.sdo.DataObject outputBO,commonj.sdo.DataObject originalInputBO,java.util.List originalOutputBOs,java.lang.String callingContext)
Used to correlate a list of business objects of a simple input role with the children of parent/child output role.
  1. void
correlateToList(java.lang.String relationshipName,java.lang.String inputRoleName,java.lang.String outputRoleName,commonj.sdo.DataObject inputBO,java.util.List outputBOs,java.util.List originalInputBOs,commonj.sdo.DataObject originalOutputBO,java.lang.String callingContext)
Used to correlate the children of a parent/child input role with a list of business objects of a simple output role.
  1. int
createParticipant(java.lang.String relationshipName,java.lang.String roleName,commonj.sdo.DataObject bo)
Adds a participant to a new relationship instance.
  1. int
createParticipantBoolean(java.lang.String relationshipName,java.lang.String roleName,boolean dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
createParticipantBooleanWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,boolean dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
createParticipantDouble(java.lang.String relationshipName,java.lang.String roleName,double dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
createParticipantDoubleWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,double dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
createParticipantFloat(java.lang.String relationshipName,java.lang.String roleName,float dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
createParticipantFloatWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,float dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
createParticipantInt(java.lang.String relationshipName,java.lang.String roleName,int dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
createParticipantIntWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,int dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
createParticipantLong(java.lang.String relationshipName,java.lang.String roleName,long dataSimpleType)
Adds a participant to a new relationship instance.
  1. int
createParticipantLongWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,long dataSimpleType)
Adds a participant for an existing relationship instance.
  1. int
createParticipantString(java.lang.String relationshipName,java.lang.String roleName,java.lang.String dataString)
Adds a participant to a new relationship instance.
  1. int
createParticipantStringWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,java.lang.String dataString)
Adds a participant for an existing relationship instance.
  1. int
createParticipantWithID(java.lang.String relationshipName,java.lang.String roleName,int instanceId,commonj.sdo.DataObject bo)
Adds a participant for an existing relationship instance that has this instanceId.
  1. void
deactivateParticipant(java.lang.String relationshipName,java.lang.String roleName,commonj.sdo.DataObject bo)
Deactivates all the participants of this relationship that match the specified BO.
  1. void
deactivateParticipantBoolean(java.lang.String relationshipName,java.lang.String roleName,boolean dataSimpleType)
Deactivates all the participants of this relationship that match this data for the participant.
  1. void
deactivateParticipantBooleanByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,boolean dataSimpleType)
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID.
  1. void
deactivateParticipantByID(java.lang.String relationshipName,java.lang.String roleName,int instanceId)
Deactivates all the participants of this relationship that matche the specified relationship instanceID.
  1. void
deactivateParticipantByIDAndDO(java.lang.String relationshipName,java.lang.String roleName,int instanceId,commonj.sdo.DataObject bo)
Deactivates all the partcipants that match this relationship, role, BO and instanceId.
  1. void
deactivateParticipantDouble(java.lang.String relationshipName,java.lang.String roleName,double dataSimpleType)
Deactivates all the participants of this relationship that match this data for the participant.
  1. void
deactivateParticipantDoubleByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,double dataSimpleType)
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID.
  1. void
deactivateParticipantFloat(java.lang.String relationshipName,java.lang.String roleName,float dataSimpleType)
Deactivates all the participants of this relationship that match this data for the participant.
  1. void
deactivateParticipantFloatByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,float dataSimpleType)
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID.
  1. void
deactivateParticipantInt(java.lang.String relationshipName,java.lang.String roleName,int dataSimpleType)
Deactivates all the participants of this relationship that match this data for the participant.
  1. void
deactivateParticipantIntByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,int dataSimpleType)
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID.
  1. void
deactivateParticipantLong(java.lang.String relationshipName,java.lang.String roleName,long dataSimpleType)
Deactivates all the participants of this relationship that match this data for the participant.
  1. void
deactivateParticipantLongByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,long dataSimpleType)
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID.
  1. void
deactivateParticipantString(java.lang.String relationshipName,java.lang.String roleName,java.lang.String dataString)
Deactivates all the participants of this relationship that match this data for the participant.
  1. void
deactivateParticipantStringByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,java.lang.String dataString)
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID.
  1. void
deleteAllParticipants(java.lang.String relationshipName,java.lang.String roleName)
Deletes all the participants for this relationship and the ASBO role.
  1. void
deleteParticipant(java.lang.String relationshipName,java.lang.String roleName,commonj.sdo.DataObject bo)
Deletes all the participants of this relationship that match the specified BO.
  1. void
deleteParticipantBoolean(java.lang.String relationshipName,java.lang.String roleName,boolean dataSimpleType)
Deletes all the participants of this relationship that match this role and the specified data.
  1. void
deleteParticipantBooleanByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,boolean dataSimpleType)
Deletes all the participants that match this relationship name, role name, relationship instanceID and the data.
  1. void
deleteParticipantByID(java.lang.String relationshipName,java.lang.String roleName,int instanceId)
Deletes all the participants of this relationship that matche the specified relationship instanceID.
  1. void
deleteParticipantByIDAndDO(java.lang.String relationshipName,java.lang.String roleName,int instanceId,commonj.sdo.DataObject bo)
Deletes all the partcipants that match this relationship, role, BO and instanceId.
  1. void
deleteParticipantDouble(java.lang.String relationshipName,java.lang.String roleName,double dataSimpleType)
Deletes all the participants of this relationship that match this role and the specified data.
  1. void
deleteParticipantDoubleByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,double dataSimpleType)
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data.
  1. void
deleteParticipantFloat(java.lang.String relationshipName,java.lang.String roleName,float dataSimpleType)
Deletes all the participants of this relationship that match this role and the specified data.
  1. void
deleteParticipantFloatByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,float dataSimpleType)
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data.
  1. void
deleteParticipantInt(java.lang.String relationshipName,java.lang.String roleName,int dataSimpleType)
Deletes all the participants of this relationship that match this role and the specified data.
  1. void
deleteParticipantIntByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,int dataSimpleType)
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data.
  1. void
deleteParticipantLong(java.lang.String relationshipName,java.lang.String roleName,long dataSimpleType)
Deletes all the participants of this relationship that match this role and the specified data.
  1. void
deleteParticipantLongByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,long dataSimpleType)
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data.
  1. void
deleteParticipants(java.lang.String relationshipName,java.util.List roleNames)
Deletes all the participants for the sepecified roles of a relationship.
  1. void
deleteParticipantString(java.lang.String relationshipName,java.lang.String roleName,java.lang.String dataString)
Deletes all the participants of this relationship that match this role and the specified data.
  1. void
deleteParticipantStringByID(java.lang.String relationshipName,java.lang.String roleName,int instanceID,java.lang.String dataString)
Deletes all the participants that match this relationship name, role name, relationship instanceID and the data.
  1. boolean
existsParticipant(java.lang.String relationshipName,java.lang.String roleName,commonj.sdo.DataObject bo)
Determines the existence of a participant that matches this relationship, ASBO role and BO.
  1. boolean
existsParticipantByID(java.lang.String relationshipName,java.lang.String roleName,int instanceId)
Determines the existence of a participant that matches this relationship, ASBO role and owns the given relationship instanceID.
  1. void
foreignKeyLookup(java.lang.String foreignRelationshipName,java.lang.String foreignInputRoleName,commonj.sdo.DataObject inputBO,java.util.List inputBOForeignKeys,java.lang.String foreignOutputRoleName,commonj.sdo.DataObject outputBO,java.util.List outputBOForeignKeys,commonj.sdo.DataObject originalInputBO,commonj.sdo.DataObject originalOutputBO,java.lang.String callingContext)
Performs a lookup in the foreign relationship table based on the foreign key of the source business object in normal calling contexts (SERVICE_CALL_REQUEST, EVENT_DELIVERY and SERVICE_CALL_RESPONSE).
  1. void
foreignKeyXref(java.lang.String foreignRelationshipName,java.lang.String foreignInputRoleName,commonj.sdo.DataObject inputBO,java.util.List inputBOForeignKeys,java.lang.String foreignOutputRoleName,commonj.sdo.DataObject outputBO,java.util.List outputBOForeignKeys,commonj.sdo.DataObject originalInputBO,commonj.sdo.DataObject originalOutputBO,java.lang.String callingContext)
Performs a lookup in this foreign relationship table based on the foreign key of this input business object in the calling context SERVICE_CALL_REQUEST, EVENT_DELIVERY and SERVICE_CALL_RESPONSE.
  1. java.util.List
getListOfChildren(commonj.sdo.DataObject parent,java.lang.String pathToChildren)
  1. int
getNewInstanceId(java.lang.String relationshipName)
Gets a new instance id for a new relationship instance RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int instanceId = relService.getNewInstanceId("http://www.ibm.com/CustomerRel");
  1. java.util.List
getRelationshipProperties(java.lang.String relationshipName,java.lang.String propertyName)
Gets the values of a user defined relationship property for all instances of a relationship.
  1. java.lang.Object
getRelationshipProperty(java.lang.String relationshipName,java.lang.String propertyName,int instanceid)
Gets the value of the user defined property in this relationship instance.
  1. java.util.List
getRoleProperties(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName)
Gets the values of a user defined role property for all instances of the specified relatinoship, role.
  1. java.util.List
getRoleProperties(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,int instanceid)
Gets the values of a user defined role property for a instance based on the given relationship name, role name, property name and instance id.
  1. java.lang.Object
getRoleProperty(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,int instanceid,java.lang.Object dataobject)
Gets the value of this user defined property for the given role instance.
  1. boolean
isSetRelationshipProperty(java.lang.String relationshipName,java.lang.String propertyName,int instanceid)
Determines if the user defined property for the given relationship instance is set.
  1. boolean
isSetRoleProperty(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,int instanceid,java.lang.Object dataobject)
Determines if this user defined property for the given role instance is set.
  1. void
maintainIdentityRelationship(java.lang.String relationshipName,java.lang.String appRoleName,commonj.sdo.DataObject inputBO,commonj.sdo.DataObject outputBO,commonj.sdo.DataObject originalInputBO,commonj.sdo.DataObject originalOutputBO,java.lang.String callingContext)
Deprecated. since WPS6.1 use correlate to maintain relationships and correlateToList and correlateFromList to maintain containment relatoinships
  1. int[]
retrieveInstanceIDs(java.lang.String relationshipName,java.lang.String roleName,commonj.sdo.DataObject bo)
Retrieves instance ids of relationship instances that match this relationship name, role name and BO.
  1. int[]
retrieveInstanceIDsByBoolean(java.lang.String relationshipName,java.lang.String roleName,boolean dataSimpleType)
Retrieves ids of all the participants that match this relationship, role and data.
  1. int[]
retrieveInstanceIDsByDouble(java.lang.String relationshipName,java.lang.String roleName,double dataSimpleType)
Retrieves ids of all the participants that match this relationship, role and data.
  1. int[]
retrieveInstanceIDsByFloat(java.lang.String relationshipName,java.lang.String roleName,float dataSimpleType)
Retrieves ids of all the participants that match this relationship, role and data.
  1. int[]
retrieveInstanceIDsByInt(java.lang.String relationshipName,java.lang.String roleName,int dataSimpleType)
Retrieves ids of all the participants that match this relationship, role and data.
  1. int[]
retrieveInstanceIDsByLong(java.lang.String relationshipName,java.lang.String roleName,long dataSimpleType)
Retrieves ids of all the participants that match this relationship, role and data.
  1. int[]
retrieveInstanceIDsByRelNameBoolean(java.lang.String relationshipName,boolean dataSimpleType)
Retrieves ids of the participants that match this relationship name and data.
  1. int[]
retrieveInstanceIDsByRelNameDouble(java.lang.String relationshipName,double dataSimpleType)
Retrieves ids of the participants that match this relationship name and data.
  1. int[]
retrieveInstanceIDsByRelNameFloat(java.lang.String relationshipName,float dataSimpleType)
Retrieves ids of the participants that match this relationship name and data.
  1. int[]
retrieveInstanceIDsByRelNameInt(java.lang.String relationshipName,int dataSimpleType)
Retrieves ids of the participants that match this relationship name and data.
  1. int[]
retrieveInstanceIDsByRelNameLong(java.lang.String relationshipName,long dataSimpleType)
Retrieves ids of the participants that match this relationship name and data.
  1. int[]
retrieveInstanceIDsByRelNameString(java.lang.String relationshipName,java.lang.String dataString)
Retrieves ids of the participants that match this relationship name and data.
  1. int[]
retrieveInstanceIDsByRoleNameBoolean(java.lang.String relationshipName,java.lang.String[] roleName,boolean dataSimpleType)
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data.
  1. int[]
retrieveInstanceIDsByRoleNameDouble(java.lang.String relationshipName,java.lang.String[] roleName,double dataSimpleType)
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data.
  1. int[]
retrieveInstanceIDsByRoleNameFloat(java.lang.String relationshipName,java.lang.String[] roleName,float dataSimpleType)
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data.
  1. int[]
retrieveInstanceIDsByRoleNameInt(java.lang.String relationshipName,java.lang.String[] roleName,int dataSimpleType)
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data.
  1. int[]
retrieveInstanceIDsByRoleNameLong(java.lang.String relationshipName,java.lang.String[] roleName,long dataSimpleType)
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data.
  1. int[]
retrieveInstanceIDsByRoleNameString(java.lang.String relationshipName,java.lang.String[] roleName,java.lang.String dataString)
Retrieves ids of the participants that match this relationship name, the list of role names and the specified data.
  1. int[]
retrieveInstanceIDsByString(java.lang.String relationshipName,java.lang.String roleName,java.lang.String dataString)
Retrieves ids of all the participants that match this relationship, role and data.
  1. int[]
retrieveInstanceIDsForParentObject(java.lang.String relationshipName,java.lang.String roleName,commonj.sdo.DataObject parent)
Retrieves InstanceIDs of the partcipants whose parent data match this parent ASBO.
  1. int[]
retrieveInstanceIDsUseDeactivate(java.lang.String relationshipName,java.lang.String roleName,java.lang.String dataString)
Retrieves ids of relationship instances that match this relationship name, role name and data.
  1. java.util.List
retrieveParticipants(java.lang.String relationshipName)
Retrieves all the participants of this relationship.
  1. java.util.List
retrieveParticipants(java.lang.String relationshipName,java.lang.String roleName)
Retrieves all the participants of this relationship that match this ASBO roleName.
  1. java.util.List
retrieveParticipants(java.lang.String relationshipName,java.lang.String[] roleNames)
Retrieves all the participants from this relationship and the list of ASBO roles.
  1. java.util.List
retrieveParticipants(java.lang.String relationshipName,java.lang.String roleName,int instanceId)
Retrieves all the participants of this relationship that match this ASBO roleName and have this instance id.
  1. java.util.List
retrieveParticipantsByRelationshipName(java.lang.String relationshipName,int instanceID)
Retrieves all the matched participants from all the ASBO roles of this relationship.
  1. java.util.List
retrieveParticipantsByRoleName(java.lang.String relationshipName,java.lang.String[] roleNames,int instanceID)
Retrieves all the participants from this relationship and the list of ASBO roles.
  1. void
setRelationshipProperties(java.lang.String relationshipName,java.lang.String propertyName,java.lang.Object propertyValue)
Sets a relationship property to a specified value for all the instances of a relationship.
  1. void
setRelationshipProperty(java.lang.String relationshipName,java.lang.String propertyName,java.lang.Object value,int instanceid)
Sets value for the user defined property into this relationship instance.
  1. void
setRoleProperties(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,java.lang.Object propertyValue)
Sets a role property to a specified value for all instances.
  1. void
setRoleProperties(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,java.lang.Object propertyValue,int instanceid)
Sets a role property to a specified value for a relationship instance.
  1. void
setRoleProperty(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,java.lang.Object propertyValue,int instanceid,java.lang.Object object)
Sets the specified property with the specifed value for the given role instance.
  1. void
setRolePropertyWithOldValue(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,java.lang.Object propertyValue,java.lang.Object oldPropertyValue,int instanceid)
Sets this propertyValue to the given role property in the role instance.
  1. void
staticLookup(java.lang.String relName,java.lang.String inputRoleName,commonj.sdo.DataObject inputBO,java.lang.String[] inputAttrNames,java.lang.String outputRoleName,commonj.sdo.DataObject outputBO,java.lang.String[] outputAttrNames)
Performs a static relationship lookup using input Business Object and its property name.
  1. java.lang.Object
staticLookup(java.lang.String relName,java.lang.String inputRoleName,java.lang.Object inputAttrValue,java.lang.String outputRoleName)
Performs a static lookup by taking relationship name, input and output role names and input key attribute value.
  1. void
unsetRelationshipProperties(java.lang.String relationshipName,java.lang.String propertyName)
Unsets a relationship property for all instances of a relationship.
  1. void
unsetRelationshipProperty(java.lang.String relationshipName,java.lang.String propertyName,int instanceid)
Unsets this property for the given relationship instance.
  1. void
unsetRoleProperties(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName)
Unsets a role property for all relationship instances.
  1. void
unsetRoleProperties(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,int instanceid)
Unsets a role property for a relationship instance.
  1. void
unsetRoleProperty(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,int instanceid,java.lang.Object dataobject)
Removes property value for this this role instance.It can be used for static as well as dynamic relationship.
  1. void
unsetRolePropertyWithOldValue(java.lang.String relationshipName,java.lang.String roleName,java.lang.String propertyName,java.lang.Object oldPropertyValue,int instanceid)
Unsets value of this role property in the give role instance.

Field Detail

  1. static final java.lang.String COPYRIGHT
See Also:

Method Detail

foreignKeyXref

  1. void foreignKeyXref(java.lang.String foreignRelationshipName,
  2. java.lang.String foreignInputRoleName,
  3. commonj.sdo.DataObject inputBO,
  4. java.util.List inputBOForeignKeys,
  5. java.lang.String foreignOutputRoleName,
  6. commonj.sdo.DataObject outputBO,
  7. java.util.List outputBOForeignKeys,
  8. commonj.sdo.DataObject originalInputBO,
  9. commonj.sdo.DataObject originalOutputBO,
  10. java.lang.String callingContext)
  11. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  12. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
  13. com.ibm.wbiserver.relationshipservice.exceptions.MissingIdException
Performs a lookup in this foreign relationship table based on the foreign key of this input business object in the calling context SERVICE_CALL_REQUEST, EVENT_DELIVERY and SERVICE_CALL_RESPONSE.

Currently it supports single foreign key attribute only.

  • In the calling context SERVICE_CALL_REQUEST, the foreign input role is an ASBO role and the foreign output role is a GBO role. In this case, this inputBOForeignKeys refers to the key attribute in the foreign ASBO; the outputBOForeignKeys refers to the key attriubte in the foreign GBO.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table
    Create Gets the value of the instance Id corresponding to the row with inputForeignAttr value and inserts this value in the outputBO for outputForeignAttr. Generates a new instance Id in the foreign table.
    This instance id should be put in the outputBO in the outputForeignAttr. Do not create a row in the foreign table. This will be created only on the response path.
    Update Gets the value of the instance Id corresponding to the row with inputForeignAttr value and inserts this value in the outputBO for outputForeignAttr. Throws MissingIdException
    Delete,
    All other verbs
    Gets the value of the instance Id corresponding to the row with inputForeignAttr value and inserts this value in the outputBO for outputForeignAttr. Throws MissingIdException
    UpdateWithDelete This means that the object could be in the deleted list in the change summary. Hence first gets the verb, ensures whether it is an update, create or delete and then applies the appropriate behavior as defined above. Processes differently according to different verb/ChangeSummary

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relService.foreignKeyXref("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", inputBG, foreignSAPBOAttrList, "http://www.ibm.com/CustomGenRole", genBG, foreignGenBOAttrList, null, null, SERVICE_CALL_REQUEST);

  • In the calling context EVENT_DELIVERY, the foreign input role is an ASBO role and the foreing output role is a GBO role. Here this inputBOForeignKeys refers to the key attribute in the foreign ASBO; this outputBOForeignKeys refers to the key attriubte in the foreign GBO.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table
    Create Gets the value of the instance Id corresponding to the row with inputForeignAttr value and inserts this value in the outputBO for outputForeignAttr. Creates a new row in the foreign table with the given inputForeignAttr as the role key and gets the generated instance id and inserts it in the outputForeignAttr of the outputBO.
    Update Gets the value of the instance Id corresponding to the row with inputForeignAttr value and inserts this value in the outputBO for outputForeignAttr. Creates a new row in the foreign table with the given inputForeignAttr as the role key and gets the generated instance id and inserts it in the outputForeignAttr of the outputBO.
    Delete Gets the value of the instance Id corresponding to the row with inputForeignAttr value and inserts this value in the outputBO for outputForeignAttr. Throws MissingIdException
    UpdateWithDelete This means that the object could be in the deleted list in the change summary. Hence first gets the verb, ensures whether it is an update, create or delete and then applies the appropriate behavior as defined above. Processes differently according to different verb/ChangeSummary
    All other verbs Gets the value of the instance Id corresponding to the row with inputForeignAttr value and inserts this value in the outputBO for outputForeignAttr Creates a new row in the foreign table with the given inputForeignAttr as the role key and gets the generated instance id and inserts it in the outputForeignAttr of the outputBO.

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relService.foreignKeyXref("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", inputBG, foreignSAPBOAttrList, "http://www.ibm.com/CustomGenRole", genBG, foreignGenBOAttrList, null, null, EVENT_DELIVERY);

  • In the calling context SERVICE_CALL_REQUEST/EVENT_DELIVERY, the foreign input role is a GBO role and the foreing output role is an ASBO role. In this case, this inputBOForeignKeys refers to the key attribute in the foreign GBO; the outputBOForeignKeys refers to the key attriubte in the foreign ASBO.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table
    Create,
    Update,
    UpdateWithDelete,
    Delete,
    All other verbs
    Gets the value of the outputForeignAttr corresponding to the row with inputForeignAttr (InstanceId) value and inserts this value in the outputBO in outputForeignAttr. Throws MissingIdException

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relService.foreignKeyXref("http://www.ibm.com/CustomerRel", "http://www.ibm.com/CustomGenRole", genBG, foreignGenBOAttrList, "http://www.clarify.com/ClarifyRole", inputBG, foreignClarifyBOAttrList, null, null, EVENT_DELIVERY);

  • In the calling context SERVICE_CALL_RESPONSE, the foreign input role is an ASBO role and the foreing output role is a GBO role. Here this inputBOForeignKeys refers to the key attribute in the foreign ASBO, and the outputBOForeignKeys refers to the key attriubte in the foreign GBO.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table
    Create,
    Update
    Gets the value of the outputForeignAttr given the inputForeignAttr value which is now the instanceId and inserts this value in the outputBO for outputForeignAttr. Creates a new row in the foreign table with the given inputForeignAttr as the instance Id and gets the foreign key value from the origOutputBO that is sent in. The foreign key value from the origOutputBO should be put in the outputBO in the outputForeignAttr.
    Delete,
    All other verbs
    Gets the value of the outputForeignAttr given the inputForeignAttr value which is now the instanceId and inserts this value in the outputBO for outputForeignAttr. In the case of Delete, since there are no objects in the graph, we will use the origOutputBO which is the ASBO. Throws MissingIdException

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relService.foreignKeyXref("http://www.ibm.com/CustomerRel", "http://www.clarify.com/ClarifyRole", inputBG, foreignClarifyBOAttrList, "http://www.ibm.com/CustomGenRole", genBG, foreignGenBOAttrList, origInputBG, null, SERVICE_CALL_RESPONSE);

  • In the calling context SERVICE_CALL_RESPONSE, foreign input role is a GBO role and foreing output role is an ASBO role. In this case, this inputBOForeignKeys refers to the key attribute in the foreign GBO; the outputBOForeignKeys refers to the key attriubte in the foreign ASBO.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table
    Create,
    Update
    Gets the value of the outputForeignAttr given the inputForeignAttr value which is the instanceId and inserts this value in the outputBO for outputForeignAttr. Create a new row in the foreign table with the given inputForeignAttr as the instance Id and gets the foreign key value from the origInputBO that is sent in. The foreign key value from the origInputBO should be put in the outputBO in the outputForeignAttr.
    Delete,
    All other verbs
    Gets the value of the outputForeignAttr given the inputForeignAttr value which is the instanceId and inserts this value in the outputBO for outputForeignAttr Throws MissingIdException
    UpdateWithDelete This means that the object could be in the deleted list in the change summary. Hence first get the verb, ensure whether it is an update, create or delete and then apply the appropriate behavior as defined above. Processes differently according to different verb/ChangeSummary.

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relService.foreignKeyXref("http://www.ibm.com/CustomerRel", "http://www.ibm.com/CustomGenRole", genBG, foreignGenBOAttrList, "http://www.sap.com/SAPRole", inputBG, foreignSAPBOAttrList, origInputBG, null, SERVICE_CALL_RESPONSE);

  • In the calling context SERVICE_CALL_FAILURE, it simply returns the inputBOForeignKey of this originalInputBO.
Parameters:
foreignRelationshipName - name of the foreign identity relationship that manages the foreign business object
foreignInputRoleName - role name of the foreign relationship for the foreign incoming object
inputBO - input business object that contains the foreign attributes for this foreign input role. It could also be a BusinessGraph.
inputBOForeignKeys - names of the attributes defined in this foreign input role
foreignOutputRoleName - role name of the foreign relationship for the foregin outgoing object
outputBO - output business object that contains the foreign attributes for this foreign output role. It could also be a BusinessGraph.
outputBOForeignKeys - names of the attributes defined in this foregin output role
originalInputBO - original input business object that contains the foreign key attributes. It could also be a BusinessGraph.
originalOutputBO - original output business object that contains the foreign key attributes. It could also be a BusinessGraph.
callingContext - calling context. It could be SERVICE_CALL_REQUEST, EVENT_DELIVERY, SERVICE_CALL_RESPONSE and SERVICE_CALL_FAILURE.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
com.ibm.wbiserver.relationshipservice.exceptions.MissingIdException

foreignKeyLookup

  1. void foreignKeyLookup(java.lang.String foreignRelationshipName,
  2. java.lang.String foreignInputRoleName,
  3. commonj.sdo.DataObject inputBO,
  4. java.util.List inputBOForeignKeys,
  5. java.lang.String foreignOutputRoleName,
  6. commonj.sdo.DataObject outputBO,
  7. java.util.List outputBOForeignKeys,
  8. commonj.sdo.DataObject originalInputBO,
  9. commonj.sdo.DataObject originalOutputBO,
  10. java.lang.String callingContext)
  11. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  12. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
  13. com.ibm.wbiserver.relationshipservice.exceptions.MissingIdException
Performs a lookup in the foreign relationship table based on the foreign key of the source business object in normal calling contexts (SERVICE_CALL_REQUEST, EVENT_DELIVERY and SERVICE_CALL_RESPONSE). If the instance is not found, a MissingIdException is thrown . If the verb or change of inputBO is not set, a RelationshipServiceException is thrown. If the calling context is SERVICE_CALL_FAILURE, it simply returns outputBOForeignKeys of originalInputBO.

Currently it supports single foreign key attribute only.

  • The foreign input role is an ASBO role and the foreign output role is a GBO role:
    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relService.foreignKeyLookup("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", srcBG, srcBOForeAttrList, "http://www.ibm.com/CustomGenRole", genBG, genBOForeAttrList, null, null, SERVICE_CALL_REQUEST);

  • The foreign input role is a GBO role and the foreign output role is an ASBO role:
    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relService.foreignKeyLookup("http://www.ibm.com/CustomerRel", "http://www.ibm.com/CustomGenRole", genBG, genBOForeAttrList, "http://www.clarify.com/ClarifyRole", destBG, destBOForeAttrList, null, null, SERVICE_CALL_REQUEST);

Parameters:
foreignRelationshipName - name of the foreign identity relationship that manages the foreign business object
foreignInputRoleName - role name of the foreign relationship for the foreign incoming object
inputBO - input business object that contains the foreign attributes for this foreign input role. It could also be a BusinessGraph.
inputBOForeignKeys - names of the attributes defined in this foreign input role
foreignOutputRoleName - role name of the foreign relationship for the foregin outgoing object
outputBO - output business object that contains the foreign attributes for this foreign output role. It could also be a BusinessGraph.
outputBOForeignKeys - names of the attributes defined in this foregin output role
originalInputBO - original input business object that contains the foreign key attributes. It could also be a BusinessGraph.
originalOutputBO - original output business object that contains the foreign key attributes. It could also be a BusinessGraph.
callingContext - calling context. It could be SERVICE_CALL_REQUEST, EVENT_DELIVERY, SERVICE_CALL_RESPONSE and SERVICE_CALL_FAILURE.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
com.ibm.wbiserver.relationshipservice.exceptions.MissingIdException

addParticipant

  1. int addParticipant(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. commonj.sdo.DataObject bo)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This BO contains value for the target participant that match the given relationship and ASBO role. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipant("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", sapCustomer);

Parameters:
relationshipName - name of the relationship to add the participant to. If no Relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown.
bo - ASBO that contains value for the participant. It could also be a BusinessGraph. If there is a matched existing participant, the instance id of the existing one is returned.
Returns:
relationship instance ID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantWithID

  1. int addParticipantWithID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId,
  4. commonj.sdo.DataObject bo)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance that match this relationship, ASBO role and instance id. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantWithID("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", 1, sapCustomer);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown.
instanceId - given relationship instanceID
bo - ASBO that contains value for the participant. It could also be a BusinessGraph. If there is a matched existing participant, the instance id of the existing one is returned.
Returns:
relationship instance ID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

existsParticipant

  1. boolean existsParticipant(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. commonj.sdo.DataObject bo)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Determines the existence of a participant that matches this relationship, ASBO role and BO. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
boolean result = relService.existsParticipant("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", sapCustomer);

Parameters:
relationshipName - name of the relationship to check. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to check. If no role found, RelationshipUserException is thrown.
bo - ASBO contains the value for the target participant. It could also be a BusinessGraph.
Returns:
true, if a matched participant exists false, if can't find a matched participant.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

existsParticipantByID

  1. boolean existsParticipantByID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Determines the existence of a participant that matches this relationship, ASBO role and owns the given relationship instanceID. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
boolean result = relService.existsParticipantByID("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", 1);

Parameters:
relationshipName - name of the relationship to check. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to check. If no role found, RelationshipUserException is thrown.
instanceId - given relationship instanceID
Returns:
true, if a matched participant exists false, if can't find a matched participant.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipant

  1. void deactivateParticipant(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. commonj.sdo.DataObject bo)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that match the specified BO. This BO contains value for the ASBO role. It could aslo be a BusinessGraph. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipant("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", sapCustomer);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to deactivate the partcipants from. If no role found, RelationshipUserException is thrown.
bo - ASBO contains value for the partcipants to be deleted. It could aslo be a BusinessGraph.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantByID

  1. void deactivateParticipantByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that matche the specified relationship instanceID. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantByID("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", 1);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to deactivate the participants from. If no role found, RelationshipUserException is thrown.
instanceId - specified relationship instanceID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantByIDAndDO

  1. void deactivateParticipantByIDAndDO( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId,
  4. commonj.sdo.DataObject bo)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the partcipants that match this relationship, role, BO and instanceId. The BO contains value for the ASBO role. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantByIDAndDO("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", 1, sapCustomer);

Parameters:
relationshipName - name of the relationship to deactivate the partcipant from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to deactivate the partcipant from. If no role found, RelationshipUserException is thrown.
instanceId - specified relationship instanceID
bo - ASBO contains value for the partcipant to be deleted. It could also be a BusinessGraph.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipant

  1. void deleteParticipant(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. commonj.sdo.DataObject bo)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that match the specified BO. This BO contains value for the ASBO role. It could aslo be a BusinessGraph. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipant("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", sapCustomer);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to delete the partcipants from. If no role found, RelationshipUserException is thrown.
bo - ASBO contains value for the partcipants to be deleted. It could aslo be a BusinessGraph.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantByID

  1. void deleteParticipantByID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that matche the specified relationship instanceID. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantByID("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", 1);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to delete the participants from. If no role found, RelationshipUserException is thrown.
instanceId - specified relationship instanceID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantByIDAndDO

  1. void deleteParticipantByIDAndDO( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId,
  4. commonj.sdo.DataObject bo)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the partcipants that match this relationship, role, BO and instanceId. The BO contains value for the ASBO role. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantByIDAndDO("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", 1, sapCustomer);

Parameters:
relationshipName - name of the relationship to delete the partcipant from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to delete the partcipant from. If no role found, RelationshipUserException is thrown.
instanceId - specified relationship instanceID
bo - ASBO contains value for the partcipant to be deleted. It could also be a BusinessGraph.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteAllParticipants

  1. void deleteAllParticipants(java.lang.String relationshipName,
  2. java.lang.String roleName)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants for this relationship and the ASBO role. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteAllParticipants("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole");

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the role to delete the partcipants from. If no role found, RelationshipUserException is thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDs

  1. int[] retrieveInstanceIDs(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. commonj.sdo.DataObject bo)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves instance ids of relationship instances that match this relationship name, role name and BO. The BO contains the key values for the ASBO role. It could also be a BusinessGraph. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDs("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", sapCustomer);

Parameters:
relationshipName - name of the relationship to retrieve the instanceIDs from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the ASBO role for retrieve. If no role found, RelationshipUserException will be thrown.
bo - ASBO that corresponds to this role. It could be a BusinessObject or a BusinessGraph. Either null value or a empty BusinessGraph instance that could not retrieve a BusinessObject from will cause RelationshipUserException
Returns:
a int array of instance ids. If no target instance found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsForParentObject

  1. int[] retrieveInstanceIDsForParentObject( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. commonj.sdo.DataObject parent)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves InstanceIDs of the partcipants whose parent data match this parent ASBO. It is used in the case of composite relationship where ASBO Roles contain both key attributes of parent ASBO and child ASBO.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsForParentObject("http://www.ibm.com/CompositeRel", "http://www.ibm.com/Level1InRol", level1InBO);

Parameters:
relationshipName - name of the composite relationship to retrieve instanceIDs from
roleName - name of the ASBO role to retrieve instanceIDs from
parent - parent ASBO contained in the target participant instances. It could also be a BusinessGraph.
Returns:
int array of matched instance ids. If no target instance found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveParticipants

  1. java.util.List retrieveParticipants( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves all the participants of this relationship that match this ASBO roleName and have this instance id.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
List partcipants = relService.retrieveParticipants("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", 1);

Parameters:
relationshipName - name of the relationship to retrieve the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to retrieve the participants from. If no role found, RelationshipUserException will be thrown.
instanceId - instanceID of the target participants. It should be greater than zero.
Returns:
a list of the matched participants. If no matched participant found, an empty list will be returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveParticipants

  1. java.util.List retrieveParticipants( java.lang.String relationshipName,
  2. java.lang.String roleName)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves all the participants of this relationship that match this ASBO roleName.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
List partcipants = relService.retrieveParticipants("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole");

Parameters:
relationshipName - name of the relationship to retrieve the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to retrieve the participants from. If no role found, RelationshipUserException will be thrown.
Returns:
a list of the matched participants. If no matched participant found, an empty list will be returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveParticipants

  1. java.util.List retrieveParticipants( java.lang.String relationshipName)
  2. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  3. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves all the participants of this relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
List partcipants = relService.retrieveParticipants("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole");

Parameters:
relationshipName - name of the relationship to retrieve the participants from. If no relationship found, RelationshipUserException will be thrown.
Returns:
a list of the matched participants. If no matched participant found, an empty list will be returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveParticipants

  1. java.util.List retrieveParticipants( java.lang.String relationshipName,
  2. java.lang.String[] roleNames)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves all the participants from this relationship and the list of ASBO roles.
Parameters:
relationshipName - name of the relationship to retrieve the participants from. If no relationship found, RelationshipUserException will be thrown.
roleNames - list of role names. If any role in the list could not be found, RelationshipUserException is thrown.
Returns:
list of all the matced partcipants. If no matched participant found, an empty list is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantString

  1. int createParticipantString(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String dataString)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataString - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantLong

  1. int createParticipantLong(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. long dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantLong("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", -9223372036854775808);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantInt

  1. int createParticipantInt(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantInt("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", -2147483648);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantFloat

  1. int createParticipantFloat(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. float dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantFloat("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", -3.40282346638528860e+38F);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantDouble

  1. int createParticipantDouble(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. double dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantDouble("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantBoolean

  1. int createParticipantBoolean(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. boolean dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantStringWithID

  1. int createParticipantStringWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. java.lang.String dataString)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.createParticipantStringWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", origId, "value_String");

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataString - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantLongWithID

  1. int createParticipantLongWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. long dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.createParticipantLongWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", origId, -9223372036854775808);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantIntWithID

  1. int createParticipantIntWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. int dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.createParticipantIntWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", origId, -2147483648);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantFloatWithID

  1. int createParticipantFloatWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. float dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.createParticipantFloatWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", origId, -3.40282346638528860e+38F);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantDoubleWithID

  1. int createParticipantDoubleWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. double dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.createParticipantDoubleWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", origId, 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantBooleanWithID

  1. int createParticipantBooleanWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. boolean dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");
int id = relService.createParticipantBooleanWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", origId, false);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantString

  1. int addParticipantString(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String dataString)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataString - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantLong

  1. int addParticipantLong(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. long dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantLong("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", -9223372036854775808);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantInt

  1. int addParticipantInt(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantInt("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", -2147483648);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantFloat

  1. int addParticipantFloat(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. float dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantFloat("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", -3.40282346638528860e+38F);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantDouble

  1. int addParticipantDouble(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. double dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantDouble("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantBoolean

  1. int addParticipantBoolean(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. boolean dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantStringWithID

  1. int addParticipantStringWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. java.lang.String dataString)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.addParticipantStringWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", origId, "value_String");

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataString - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantLongWithID

  1. int addParticipantLongWithID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. long dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.addParticipantLongWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", origId, -9223372036854775808);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantIntWithID

  1. int addParticipantIntWithID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. int dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.addParticipantIntWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", origId, -2147483648);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantFloatWithID

  1. int addParticipantFloatWithID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. float dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.addParticipantFloatWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", origId, -3.40282346638528860e+38F);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantDoubleWithID

  1. int addParticipantDoubleWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. double dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
int id = relService.addParticipantDoubleWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", origId, 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantBooleanWithID

  1. int addParticipantBooleanWithID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. boolean dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int origId = relService.createParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");
int id = relService.addParticipantBooleanWithID("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", origId, false);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to add the participant to. If no role found, RelationshipUserException will be thrown.
instanceID - instanceID of the existing relationship instance. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participant to be added
Returns:
relationship instanceID of the newly added participant
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantString

  1. void deactivateParticipantString( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String dataString)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that match this data for the participant. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataString - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantLong

  1. void deactivateParticipantLong( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. long dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that match this data for the participant. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantLong("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", -9223372036854775808);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantInt

  1. void deactivateParticipantInt(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that match this data for the participant. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantInt("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", -2147483648);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantFloat

  1. void deactivateParticipantFloat( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. float dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that match this data for the participant. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantFloat("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", 1.40129846432481707e-45F);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantDouble

  1. void deactivateParticipantDouble( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. double dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that match this data for the participant. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantDouble("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantBoolean

  1. void deactivateParticipantBoolean( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. boolean dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participants of this relationship that match this data for the participant. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deactivateParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantStringByID

  1. void deactivateParticipantStringByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. java.lang.String dataString)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");
relService.deactivateParticipantStingByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", id, "value_String");

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataString - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantLongByID

  1. void deactivateParticipantLongByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. long dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantLong("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", -9223372036854775808);
relService.deactivateParticipantLongByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", id, -9223372036854775808);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantIntByID

  1. void deactivateParticipantIntByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. int dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantInt("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", -2147483648);
relService.deactivateParticipantIntByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", id, -2147483648);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
instanceID - specified relationship instanceID
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantFloatByID

  1. void deactivateParticipantFloatByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. float dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantFloat("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", -3.40282346638528860e+38F);
relService.deactivateParticipantFloatByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", id, -3.40282346638528860e+38F);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
instanceID - specified relationship instanceID
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantDoubleByID

  1. void deactivateParticipantDoubleByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. double dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantDouble("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", 4.94065645841246544e-324D);
relService.deactivateParticipantDoubleByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", id, 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
instanceID - specified relationship instanceID
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deactivateParticipantBooleanByID

  1. void deactivateParticipantBooleanByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. boolean dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deactivates all the participant instances of the relationship that match this data for the participant and have the specified relationship instanceID. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
relService.deactivateParticipantBooleanByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", id, true);

Parameters:
relationshipName - name of the relationship to deactivate the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to deactivate the participants from. If no role found, RelationshipUserException will be thrown.
instanceID - specified relationship instanceID. InstanceID equal with or less than zero is not valid.
dataSimpleType - data of the participants to be deactivated. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsUseDeactivate

  1. int[] retrieveInstanceIDsUseDeactivate( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String dataString)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of relationship instances that match this relationship name, role name and data. Deactivated instances are also considered. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". This API supports static rleationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");
relService.deactivateParticipantStringByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", id, "value_String");
int[] idArray = relService.retrieveInstanceIDsUseDeactivate("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");

Parameters:
relationshipName - name of the relationship to retrieve instanceIDs from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role for retrieve. If no role found, RelationshipUserException will be thrown.
dataString - data of the participants to be retrieved
Returns:
int array of ids of the matched instance ids. If no matched instance found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantString

  1. void deleteParticipantString(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String dataString)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that match this role and the specified data. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the participants from. If no role found, RelationshipUserException will be thrown.
dataString - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantLong

  1. void deleteParticipantLong(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. long dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that match this role and the specified data. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantLong("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", -9223372036854775808);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantInt

  1. void deleteParticipantInt(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that match this role and the specified data. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantInt("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", -2147483648);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantFloat

  1. void deleteParticipantFloat(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. float dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that match this role and the specified data. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantFloat("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", 1.40129846432481707e-45F);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantDouble

  1. void deleteParticipantDouble(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. double dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that match this role and the specified data. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantDouble("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantBoolean

  1. void deleteParticipantBoolean(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. boolean dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants of this relationship that match this role and the specified data. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the participants from. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantStringByID

  1. void deleteParticipantStringByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. java.lang.String dataString)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants that match this relationship name, role name, relationship instanceID and the data. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");
relService.deleteParticipantStringByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", id, "value_String");

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the partcipants from. If no role found, RelationshipUserException will be thrown.
instanceID - given relationship instanceID
dataString - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantLongByID

  1. void deleteParticipantLongByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. long dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantLong("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", -9223372036854775808);
relService.deleteParticipantLongByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", id, -9223372036854775808);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the partcipants from. If no role found, RelationshipUserException will be thrown.
instanceID - given relationship instanceID
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantIntByID

  1. void deleteParticipantIntByID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. int dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantInt("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", -2147483648);
relService.deleteParticipantIntByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", id, -2147483648);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the partcipants from. If no role found, RelationshipUserException will be thrown.
instanceID - given relationship instanceID
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantFloatByID

  1. void deleteParticipantFloatByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. float dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantFloat("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", -3.40282346638528860e+38F);
relService.deleteParticipantFloatByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", id, -3.40282346638528860e+38F);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the partcipants from. If no role found, RelationshipUserException will be thrown.
instanceID - given relationship instanceID
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantDoubleByID

  1. void deleteParticipantDoubleByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. double dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants that match the relationship name, role name, relationship instanceID and the data. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantDouble("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", 4.94065645841246544e-324D);
relService.deleteParticipantDoubleByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", id, 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the partcipants from. If no role found, RelationshipUserException will be thrown.
instanceID - given relationship instanceID
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipantBooleanByID

  1. void deleteParticipantBooleanByID( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceID,
  4. boolean dataSimpleType)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants that match this relationship name, role name, relationship instanceID and the data. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.createParticipantBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);
relService.deleteParticipantBooleanByID("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", id, true);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the role to delete the partcipants from. If no role found, RelationshipUserException will be thrown.
instanceID - given relationship instanceID
dataSimpleType - data of the participants to be deleted. If no matched participant found, no exception will be thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByString

  1. int[] retrieveInstanceIDsByString( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String dataString)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of all the participants that match this relationship, role and data. This role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByString("http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "value_String");

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the specified role. If no role found, RelationshipUserException will be thrown.
dataString - data of the target participants
Returns:
int array of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByLong

  1. int[] retrieveInstanceIDsByLong( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. long dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of all the participants that match this relationship, role and data. This role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByLong("http://www.ibm.com/StaticRel", "http://www.ibm.com/longRole", -9223372036854775808);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the specified role. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
int array of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByInt

  1. int[] retrieveInstanceIDsByInt( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of all the participants that match this relationship, role and data. This role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByInt("http://www.ibm.com/StaticRel", "http://www.ibm.com/intRole", -2147483648);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the specified role. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
int array of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByFloat

  1. int[] retrieveInstanceIDsByFloat( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. float dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of all the participants that match this relationship, role and data. This role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByFloat("http://www.ibm.com/StaticRel", "http://www.ibm.com/floatRole", 1.40129846432481707e-45F);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the specified role. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
int array of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByDouble

  1. int[] retrieveInstanceIDsByDouble( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. double dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of all the participants that match this relationship, role and data. This role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByDouble("http://www.ibm.com/StaticRel", "http://www.ibm.com/doubleRole", 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the specified role. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
int array of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByBoolean

  1. int[] retrieveInstanceIDsByBoolean( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. boolean dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of all the participants that match this relationship, role and data. This role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for this role is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByBoolean("http://www.ibm.com/StaticRel", "http://www.ibm.com/booleanRole", true);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - name of the specified role. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
int array of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRoleNameString

  1. int[] retrieveInstanceIDsByRoleNameString( java.lang.String relationshipName,
  2. java.lang.String[] roleName,
  3. java.lang.String dataString)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match this relationship name, the list of role names and the specified data. Each role contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String[] roleNames = {"http://www.ibm.com/StringRole_First", "http://www.ibm.com/StringRole_Second"};
int[] ids = relService.retrieveInstanceIDsByRoleNameString("http://www.ibm.com/StaticRel", roleNames, "value_String");

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - list of the specified role names. If no role found, RelationshipUserException will be thrown.
dataString - data of the target participants
Returns:
int array of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRoleNameLong

  1. int[] retrieveInstanceIDsByRoleNameLong( java.lang.String relationshipName,
  2. java.lang.String[] roleName,
  3. long dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data. Each role contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String[] roleNames = {"http://www.ibm.com/longRole_First", "http://www.ibm.com/longRole_Second"};
int[] ids = relService.retrieveInstanceIDsByRoleNameLong("http://www.ibm.com/StaticRel", roleNames, -9223372036854775808);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - list of the specified role names. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
list of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRoleNameInt

  1. int[] retrieveInstanceIDsByRoleNameInt( java.lang.String relationshipName,
  2. java.lang.String[] roleName,
  3. int dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data. Each role contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String[] roleNames = {"http://www.ibm.com/intRole_First", "http://www.ibm.com/intRole_Second"};
int[] ids = relService.retrieveInstanceIDsByRoleNameInt("http://www.ibm.com/StaticRel", roleNames, -2147483648);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - list of the specified role names. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
list of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRoleNameFloat

  1. int[] retrieveInstanceIDsByRoleNameFloat( java.lang.String relationshipName,
  2. java.lang.String[] roleName,
  3. float dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data. Each role contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String[] roleNames = {"http://www.ibm.com/floatRole_First", "http://www.ibm.com/floatRole_Second"};
int[] ids = relService.retrieveInstanceIDsByRoleNameFloat("http://www.ibm.com/StaticRel", roleNames, 1.40129846432481707e-45F);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - list of the specified role names. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
list of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRoleNameDouble

  1. int[] retrieveInstanceIDsByRoleNameDouble( java.lang.String relationshipName,
  2. java.lang.String[] roleName,
  3. double dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data. Each role contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String[] roleNames = {"http://www.ibm.com/doubleRole_First", "http://www.ibm.com/doubleRole_Second"};
int[] ids = relService.retrieveInstanceIDsByRoleNameDouble("http://www.ibm.com/StaticRel", roleNames, 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - list of the specified role names. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
list of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRoleNameBoolean

  1. int[] retrieveInstanceIDsByRoleNameBoolean( java.lang.String relationshipName,
  2. java.lang.String[] roleName,
  3. boolean dataSimpleType)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match the relationship name, the list of role names and the specified data. Each role contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String[] roleNames = {"http://www.ibm.com/booleanRole_First", "http://www.ibm.com/booleanRole_Second"};
int[] ids = relService.retrieveInstanceIDsByRoleNameBoolean("http://www.ibm.com/StaticRel", roleNames, true);

Parameters:
relationshipName - name of the specified relationship. If no relationship found, RelationshipUserException will be thrown.
roleName - list of the specified role names. If no role found, RelationshipUserException will be thrown.
dataSimpleType - data of the target participants
Returns:
list of ids of all the matched participants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRelNameString

  1. int[] retrieveInstanceIDsByRelNameString( java.lang.String relationshipName,
  2. java.lang.String dataString)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match this relationship name and data. It looks up all the roles that contains a roleObject of String type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByRelNameString("http://www.ibm.com/StaticRel", "value_String");

Parameters:
relationshipName - name of the spcified relationship. If no relationship found, RelationshipUserException will be thrown.
dataString - data of the target partcipants
Returns:
list of ids of all the matched partcipants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRelNameLong

  1. int[] retrieveInstanceIDsByRelNameLong( java.lang.String relationshipName,
  2. long dataSimpleType)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match this relationship name and data. It looks up all the roles that contains a roleObject of long type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByRelNameLong("http://www.ibm.com/StaticRel", -9223372036854775808);

Parameters:
relationshipName - name of the spcified relationship. If no relationship found, RelationshipUserException will be thrown.
dataSimpleType - data of the target partcipants
Returns:
list of ids of all the matched partcipants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRelNameInt

  1. int[] retrieveInstanceIDsByRelNameInt( java.lang.String relationshipName,
  2. int dataSimpleType)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match this relationship name and data. It looks up all the roles that contains a roleObject of int type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByRelNameInt("http://www.ibm.com/StaticRel", -2147483648);

Parameters:
relationshipName - name of the spcified relationship. If no relationship found, RelationshipUserException will be thrown.
dataSimpleType - data of the target partcipants
Returns:
list of ids of all the matched partcipants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRelNameFloat

  1. int[] retrieveInstanceIDsByRelNameFloat( java.lang.String relationshipName,
  2. float dataSimpleType)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match this relationship name and data. It looks up all the roles that contains a roleObject of float type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByRelNameFloat("http://www.ibm.com/StaticRel", -3.40282346638528860e+38F);

Parameters:
relationshipName - name of the spcified relationship. If no relationship found, RelationshipUserException will be thrown.
dataSimpleType - data of the target partcipants
Returns:
list of ids of all the matched partcipants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRelNameDouble

  1. int[] retrieveInstanceIDsByRelNameDouble( java.lang.String relationshipName,
  2. double dataSimpleType)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match this relationship name and data. It looks up all the roles that contains a roleObject of double type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByRelNameDouble("http://www.ibm.com/StaticRel", 4.94065645841246544e-324D);

Parameters:
relationshipName - name of the spcified relationship. If no relationship found, RelationshipUserException will be thrown.
dataSimpleType - data of the target partcipants
Returns:
list of ids of all the matched partcipants. If no matched participant found, an empty int array is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveInstanceIDsByRelNameBoolean

  1. int[] retrieveInstanceIDsByRelNameBoolean( java.lang.String relationshipName,
  2. boolean dataSimpleType)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves ids of the participants that match this relationship name and data. It looks up all the roles that contains a roleObject of boolean type and a keyAttribute whose path is defined as "Data". Value for these roles is specified by the data. This API supports static relationship only.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int[] ids = relService.retrieveInstanceIDsByRelNameBoolean("http://www.ibm.com/StaticRel", true);

Parameters:
relationshipName - name of the spcified relationship. If no relationship found, RelationshipUserException will be thrown.
dataSimpleType - data of the target partcipants
Returns:
list of ids of all the matched partcipants. If no matched participant found, an empty list is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveParticipantsByRoleName

  1. java.util.List retrieveParticipantsByRoleName( java.lang.String relationshipName,
  2. java.lang.String[] roleNames,
  3. int instanceID)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves all the participants from this relationship and the list of ASBO roles. The matched participants own the specified instanceID. It can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String roleNames = {"http://www.ibm.com/StringRole", "http://www.ibm.com/longRole"};
List participants = relService.retrieveParticipantsByRoleName("http://www.ibm.com/StaticRel", roleNames, 1);

Parameters:
relationshipName - name of the relationship to retrieve the participants from. If no relationship found, RelationshipUserException is thrown.
roleNames - list of role names. If any role in the list could not be found, RelationshipUserException is thrown.
instanceID - specified relationship instanceID
Returns:
list of all the matced partcipants. If no matched participant found, an empty list is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

retrieveParticipantsByRelationshipName

  1. java.util.List retrieveParticipantsByRelationshipName( java.lang.String relationshipName,
  2. int instanceID)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Retrieves all the matched participants from all the ASBO roles of this relationship. The matched participants own the given relationship instanceID. It can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
List participants = relService.retrieveParticipantsByRelationshipName("http://www.ibm.com/StaticRel", 1);

Parameters:
relationshipName - name of the relationship to retrieve participants from. If no relationship found, RelationshipUserException is thrown.
instanceID - given relationship instanceID
Returns:
list of all the matched participants. If no matched participant found, an empty list is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

maintainIdentityRelationship

  1. void maintainIdentityRelationship( java.lang.String relationshipName,
  2. java.lang.String appRoleName,
  3. commonj.sdo.DataObject inputBO,
  4. commonj.sdo.DataObject outputBO,
  5. commonj.sdo.DataObject originalInputBO,
  6. commonj.sdo.DataObject originalOutputBO,
  7. java.lang.String callingContext)
  8. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  9. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
  10. com.ibm.wbiserver.relationshipservice.exceptions.MissingIdException
Deprecated. since WPS6.1 use correlate to maintain relationships and correlateToList and correlateFromList to maintain containment relatoinships
Maintains an identity relationship, this could be used for both simple and composite relationship. Before using this API, please ensure follwoing items are true:
  • An 'identity' relationship is involved (e.g. the 'isIdentity' attribute on the relationship descriptor is set to TRUE).
  • The identity relationship has at least 1 role marked as 'managed' (role descriptor 'managed' attribute is set to TRUE).
  • Each maintainIdentityRelationship invocation involves one business object participating in a 'managed' role and the other business object participating in an unmanaged role.

Five usage scenarioes are listed below.
  • In the calling context SERVICE_CALL_REQUEST, the inputBO is an ASBO and the outputBO is a GBO. The inputBO is an instance of the ASBO role specified by the param appRoleName.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table Exceptions
    Create,
    Update
    Gets the instance id and inserts into the GBO id. If a row with given role key id exists, but is deactivated, then creates a new row with the given role key id and a new instanceId. A new row will be created in the role table with a unique instanceId and the value of role key Id obtained from the ASBO DataObject. This InstanceId is then inserted into the GBO id. If the key in the ASBO is null, RelationshipUserException will be thrown.
    Delete Gets the instance Id and inserts in the GBO. Throws MissingIdException If the key in the ASBO is null, RelationshipUserException will be thrown.
    UpdateWithDelete Figures out if the verb is create, update or deleted and applies the above behavior If the key in the ASBO is null, RelationshipUserException will be thrown.
    All other verbs Gets the instance Id and inserts in the GBO. Throws MissingIdException If the key in the ASBO is null, RelationshipUserException will be thrown.

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relSerive.maintainIdentityRelationship("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", sapCustomer, genBO, null, null, SERVICE_CALL_REQUEST);

  • In the calling context EVENT_DELIVERY, the inputBO is an ASBO and the outputBO is a GBO. The inputBO is an instance of the ASBO role specified by the param appRoleName.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table Exceptions
    Create Gets the instance id and inserts into the GBO id. If a row with given role key id exists, but is deactivated, then creates a new row with the given role key id and a new instanceId. A new row will be created in the role table with a unique instanceId and the value of role key Id obtained from the ASBO DataObject. This InstanceId is then inserted into the GBO id. If the key in the ASBO is null, RelationshipUserException will be thrown.
    Delete Gets the instance id and inserts into the GBO id. Message is logged indicating that the participant has already been deleted. If the key in the ASBO is null, RelationshipUserException will be thrown.
    Update Uses that Id for the GBO. If a row with given role key id exists, but is deactivated, then creates a new row with the given role key id and a new instanceId. A new row will be created in the table with a unique instanceId and the value of role key id obtained from the ASBO DataObject. This InstanceId is then inserted into the GBO id. If the key in the ASBO is null, RelationshipUserException will be thrown.
    UpdateWithDelete Depending on whether it is Create, Update or Delete, it will behave like one. Depending on whether it is Create, Update or Delete, it will behave like one.
    All other verbs The instance id corresponding to that row is inserted into the GBO id. Creates a new row in the table and inserts the instance id into the GBO id. If the key in the ASBO is null, RelationshipUserException will be thrown.

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relSerive.maintainIdentityRelationship("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", sapCustomer, genBO, null, null, EVENT_DELIVERY);

  • In the calling context SERVICE_CALL_REQUEST/EVENT_DELIVERY, the inputBO is a GBO and the outputBO is an ASBO. The outputBO is an instance of the ASBO role specified by the param appRoleName.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table
    Create No action is taken. The table remains as is. No action is taken. The table remains as is.
    Update The ASBO key corresponding to that row is inserted into the ASBO id. MissingIdException is thrown
    Delete The row is deactivated and the role key id is inserted into the ASBO id. MissingIdException is thrown
    UpdateWithDelete Depending on whether it is Create, Update or Delete, it will behave like one. Depending on whether it is Create, Update or Delete, it will behave like one.
    All other verbs The ASBO key corresponding to that row is inserted into the ASBO id. MissingIdException is thrown

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relSerive.maintainIdentityRelationship("http://www.ibm.com/CustomerRel", "http://www.clarify.com/ClarifyRole", genBO, clarifyCustomer, null, null, EVENT_DELIVERY);

  • In the calling context SERVICE_CALL_RESPONSE, the inputBO is an ASBO and the outputBO is a GBO. The inputBO is an instance of the ASBO role specified by the param appRoleName.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table Exceptions
    Create The instance id corresponding to that row will be inserted in the GBO id. A new row will be created in the role table with the given role key id with the InstanceId set to the same value as in the origGBO id. This InstanceId is then inserted into the new GBO id. If the origGBO does not exist, then a new entry will be created and an instance id will be generated as oppose to the one that is obtained from the origGbo. Also, an error will be logged that the origGBO is null.
    Update The instance id corresponding to that row is inserted into the GBO id. A new row will be created in the role table with the given role key id and with the InstanceId set to the same value as in the origGBO id. This InstanceId is then inserted into the new GBO id. If the origGBO does not exist, then a new entry will be created and an instance id will be generated as oppose to the one that is obtained from the origGbo. Also, an error will be logged that the origGBO is null.
    Delete In the case of delete, the incoming object is really no good because all the contained objects from there have been deleted. We need to look at the origASBO. The row is deactivated and the instance id is inserted into the GBO id. Gets the gbo id from the origgbo id and adds it to the output gbo. If the gboid is null, then throw a RelationshipUserException.
    UpdateWithDelete First figure out what the verb is whether it is a delete, create or update and apply the above behavior First figure out what the verb is whether it is a delete, create or update and apply the above behavior
    All other verbs The instance id corresponding to that row is inserted into the GBO id. Gets the gbo id from the origgbo id and adds it to the output gbo.

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relSerive.maintainIdentityRelationship("http://www.ibm.com/CustomerRel", "http://www.clarify.com/ClarifyRole", clarifyCustomer, genBO, originalGenBO, null, SERVICE_CALL_RESPONSE);

  • In the calling context SERVICE_CALL_RESPONSE, the inputBO is a GBO and the outputBO is an ASBO. The outputBO is an instance of the ASBO role specified by the param appRoleName.
    Verb/ChangeSummary on the inputBO Existing entry found in table Entry not found in table Exceptions
    Create,
    Update
    Gets the corresponding ASBO key from the table and inserts into the ASBO id. If the ASBO id obtained from the table does not match the one in the origASBO, then it should log an error. Checks the origASBO object and gets the key from that object and sets it in the output ASBO object. Also, adds a row to the table with this ASBO id and the GBO id. If we need the origASBO to create the entry and the origASBO is null or does not have a key, then we won¡¯t be able to create an entry hence we throw a RelationshipUserException
    UpdateWithDelete Same as above. Depending on whether it is Create, Update or Delete, it will behave like one. Depending on whether it is Create, Update or Delete, it will behave like one. Same as above
    Delete Same as above. Also the entry has be marked as deactivated. Same as above
    All other verbs Same as above Same as above Same as above

    RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
    relSerive.maintainIdentityRelationship("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", genBO, sapCustomer, originalSAPCustomer, null, SERVICE_CALL_RESPONSE);

  • In the calling context SERVICE_CALL_FAILURE, simply puts the key attribute in this original input BO into the output BO.
Parameters:
relationshipName - name of the identity relationship to maintain
appRoleName - name of the ASBO role
inputBO - input BO, it could also be a BG.
outputBO - output BO, it could also be a BG.
originalInputBO - original input BO, it could also be a BG.
originalOutputBO - original output BO, it could also be a BG.
callingContext - calling context including SERVICE_CALL_REQUEST, SERVICE_CALL_RESPONSE, EVENT_DELIVERY and SERVICE_CALL_FAILURE
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
com.ibm.wbiserver.relationshipservice.exceptions.MissingIdException
Since:
WPS6.0

In WPS6.0, the need for parent-children relationships in composite relationship maintenance, will be done away with with the new maintainIdentityRelationship API. That is:

  • In WPS6.0, users will no longer be required to create parent-children relationships in order to help maintain composite relationships if they choose to adopt the new maintainIdentity api.
  • maintainIdentityRelationship now replaces both maintainSimpleIdentityRelationship and maintainCompositeIdentityRelationship.
  • maintainSimpleIdentityRelationship and maintainCompositeIdentityRelationship will still be supported but will be marked as deprecated.
  • Likewise, the WBI ICS *child* relationship api (updateMyChildren, etc.) will still be supported but will be marked as deprecated.
  • The map 'relationshipCall' transform type will only invoke maintainIdentity (vs. maintainSimple or maintainComposite) for direct relationship maintenance purposes (i.e., for non foreign-key application - for these applications, the foreignKey* methods will be used in place of maintain*).
  • [MIGRATION] The coexistence scenario for composite relationship support requires that the old (deprecated) maintainComposite*, *children* api be used, instead of the new maintainIdentity api, when composite relationships are shared by both a WBI ICS instance and a Diamond Server instance.

correlate

  1. void correlate(java.lang.String relationshipName,
  2. java.lang.String inputRoleName,
  3. java.lang.String outputRoleName,
  4. commonj.sdo.DataObject inputBO,
  5. commonj.sdo.DataObject outputBO,
  6. commonj.sdo.DataObject originalInputBO,
  7. commonj.sdo.DataObject originalOutputBO,
  8. java.lang.String callingContext)
  9. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  10. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
  11. com.ibm.wbiserver.relationshipservice.exceptions.DataNotFoundException
  12. com.ibm.wbiserver.relationshipservice.exceptions.DuplicateDataException
Correlates an inputBO of the given inputRoleName with the outputBO of the given outputRoleName and maintains the relationship between them according to the meta data contained in the inputBO (currently either verb or change summary information or both). In order to make use of this API, the following criteria must be met:
  • The relationship that the relationshipName refers to is an 'identity' relationship (i.e. the isIdentity attribute on the relationship definition is set to true
  • The relationship has at least one role marked as 'managed' (i.e. the managed attribute in the role definition is set to true).
  • Either the inputRoleName or the outputRoleName refer to the managed role
  • The inputBO matches the role object type of the role for the inputRoleName and the outputBO matches the role object type of the role for the outputRoleName
  • If the calling context is a response or a failure (see usage scenarios below), the originalInputBO matches the role object type of the role for the outputRoleName and the originalOutputBO matches the role object type of the role for the inputRoleName
  • Both input and output role are simple roles, i.e. not a parent/child role. A parent/child role refers to a role that contains one or more key attributes from the parent BO and one or more key attributes from a child BO with the intention to maintain the child in the context of its parent.
The following tables document the usage scenarios categorized by the calling context, the direction of the correlation, and the command derived from the meta data contained in the inputBO. The direction of the correlation can be either generic business object (GBO) to application specific business object (ASBO) or ASBO to GBO. The managed role in the relationship is considered the generic role, while all other roles are considered application specific roles. (Note: In the following the header 'existing participant found for input' indicates that a corresponding entry in the role table exists that has not been deactivated, whereas 'no participant found for input' indicates that either no corresponding entry in the role table was found or that the corresponding entry is deactivated)
  • The calling context is SERVICE_CALL_REQUEST, the inputBO is an ASBO and the outputBO is a GBO.
    Command derived from verb/change summary Existing participant found for input No participant found for input
    Create The retrieved instance id is set in the key attribute property of the generic output BO. A new participant is created and the generated instance id is set in the key attribute property of the generic output BO.
    Update The instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    Delete The participant is deactivated and the instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    All other commands The instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
  • The calling context is SERVICE_CALL_REQUEST, the inputBO is a GBO and the outputBO is an ASBO.
    Command derived from verb/change summary Existing participant found for input No participant exists for input
    Create No action is taken No action is taken.
    Update All key attributes are retrieved and set in the key attribute property of the application specific output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    Delete All key attributes are retrieved and set in the key attribute property of the application specific output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    All other commands All key attributes are retrieved and set in the key attribute property of the application specific output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
  • The calling context is SERVICE_CALL_RESPONSE, the inputBO is an ASBO and the outputBO is a GBO.
    Command derived from verb/change summary Existing participant found for input No participant exists for input
    Create The retrieved instance id is set in the key attribute property of the generic output BO. A new participant is created and the generated instance id is set in the key attribute property of the generic output BO.
    Update The instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    Delete The participant is deactivated and the instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    All other commands The instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
  • The calling context is SERVICE_CALL_RESPONSE, the inputBO is a GBO and the outputBO is an ASBO.
    Command derived from verb/change summary Existing participant found for input No participant exists for input
    Create All key attribute values are extracted from the originalInputBO and set to the key attribute properties in the outputBO
    Update All key attribute values are extracted from the originalInputBO and set to the key attribute properties in the outputBO
    All key attribute values are extracted from the originalInputBO and set to the key attribute properties in the outputBO
    All other commands All key attribute values are extracted from the originalInputBO and set to the key attribute properties in the outputBO
  • The calling context is EVENT_DELIVERY, the inputBO is an ASBO and the outputBO is a GBO.
    Command derived from verb/change summary Existing participant found for input No participant found for input
    Create The retrieved instance id is set in the key attribute property of the generic output BO. A new participant is created and the generated instance id is set in the key attribute property of the generic output BO.
    Update The instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    Delete The participant is deactivated and the instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    All other commands The instance id is retrieved and set in the key attribute property of the generic output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
  • The calling context is EVENT_DELIVERY, the inputBO is a GBO and the outputBO is an ASBO.
    Command derived from verb/change summary Existing participant found for input No participant exists for input
    Create A RelationshipUserException is thrown to indicate that the pattern has been violated by attempting to create a participant.
    Update All key attributes are retrieved and set in the key attribute property of the application specific output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    Delete The participant is deactivated and all key attributes are retrieved and set in the key attribute property of the application specific output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
    All other commands All key attributes are retrieved and set in the key attribute property of the application specific output BO. A DataNotFoundException is thrown to indicate that an expected participant could not be found.
  • If the calling context is SERVICE_CALL_FAILURE, the originalInputBO is used to populate the outputBO. No retrieval or modification of participants is done
Example for service call request ASBO to GBO invocation: RelationshipService relationshipService = (RelationshipService)ServiceManager.INSTANCE.locateService("com/ibm/wbiserver/rel/RelationshipService";
relationshipService.correlate("http://www.ibm.com/CustomerRel", "http://www.clarify.com/ClarifyRole", "http://www.ibm.com/GenericRole", clarifyCustomerBO, genericBO, null, null, SERVICE_CALL_REQUEST);
Example for service call response GBO to ASBO invocation: RelationshipService relationshipService = (RelationshipService)ServiceManager.INSTANCE.locateService("com/ibm/wbiserver/rel/RelationshipService";
relationshipService.correlate("http://www.ibm.com/CustomerRel", "http://www.ibm.com/GenericRole", "http://www.clarify.com/ClarifyRole", genericBO, clarifyCustomerBO, origClarifyCustomerBO, origGenericBO, SERVICE_CALL_REQUEST);
Parameters:
relationshipName - The fully qualified name of the relationship
inputRoleName - The fully qualified name of the input role
outputRoleName - The fully qualified name of the output role
inputBO - The input business object of the input role type
outputBO - The output business object of the output role type
originalInputBO - The original input business object. For calling context SERVICE_CALL_RESPONSE or SERVICE_CALL_FAILURE this BO may not be null and must be of the output role type.
originalOutputBO - The original output business object. For calling context SERVICE_CALL_RESPONSE or SERVICE_CALL_FAILURE this BO may not be null and must be of the input role type.
callingContext - The calling context for the invocation. One of SERVICE_CALL_REQUEST, EVENT_DELIVERY, SERVICE_CALL_RESPONSE, and SERVICE_CALL_FAILURE.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException - Indicates an exception internal to the Relationship Service, such as a missing database connection or other runtime failures.
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException - Indicates an error in the usage of this API. Examples of incorrect use are invalid relationship/role names, business objects that are null or of invalid type, or lack of change summary/verb information in the inputBO.
com.ibm.wbiserver.relationshipservice.exceptions.DataNotFoundException - Indicates that a participant was not found when attempting to retrieve it.
com.ibm.wbiserver.relationshipservice.exceptions.DuplicateDataException - Indicates a duplicate.
Since:
WPS6.1 This API replaces maintainIdentityRelationship for maintaining relationships between simple roles (i.e. not parent/child roles). For parent/child roles use correlateToList and correlateFromList.

correlateToList

  1. void correlateToList(java.lang.String relationshipName,
  2. java.lang.String inputRoleName,
  3. java.lang.String outputRoleName,
  4. commonj.sdo.DataObject inputBO,
  5. java.util.List outputBOs,
  6. java.util.List originalInputBOs,
  7. commonj.sdo.DataObject originalOutputBO,
  8. java.lang.String callingContext)
  9. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  10. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
  11. com.ibm.wbiserver.relationshipservice.exceptions.DataNotFoundException
  12. com.ibm.wbiserver.relationshipservice.exceptions.DuplicateDataException
Used to correlate the children of a parent/child input role with a list of business objects of a simple output role. The children of the input role are extracted from the inputBO according to the key attribute path defined in the according role definition. The relationship is maintained based on the meta data conatined in the inputBO and the children (currently either verb or change summary information or both). In order to make use of this API, the following criteria must be met:
  • The relationship that the relationshipName refers to is an 'identity' relationship (i.e. the isIdentity attribute on the relationship definition is set to true
  • The relationship has at least one role marked as 'managed' (i.e. the managed attribute in the role definition is set to true).
  • The outputRoleName refers to the managed role.
  • The inputBO matches the role object type of the role for the inputRoleName and the outputBO matches the role object type of the role for the outputRoleName
  • If the calling context is a response or a failure (see usage scenarios below), the type of the originalInputBOs matches the role object type of the role for the outputRoleName and the originalOutputBO matches the role object type of the role for the inputRoleName
  • The input role is a parent/child role, i.e. the role is defined on the parent and contains at least one key attribute path to the child.
This API supports the same usage scenarios described for correlate(String, String, String, DataObject, DataObject, DataObject, DataObject, String) and applies these rules to all children. In addition, the containment relationship between the inputBO and its children is maintained with repect to the type of business graph and derived command: For after image updates: - all children that have matching participants in the database, but are not contained in the graph are deleted. - all children that exist in the graph, but are not contained in the database are created. For after image deletes: - all children under the parent are deleted In order to facilitate using this API, a helper is provided with getListOfChildren(DataObject, String) to retrieve the list for the outputBOs and originalInputBOs. Example for service call request invocation: RelationshipService relationshipService = (RelationshipService)ServiceManager.INSTANCE.locateService("com/ibm/wbiserver/rel/RelationshipService";
List genricLineItems = relationshipService.getListOfChildren(genericOrder, "lineItems"); relationshipService.correlateToList("http://www.ibm.com/OrderRel", "http://www.sap.com/SAPOrder", "http://www.ibm.com/GenericOrder", sapOrder, genricLineItems, null, null, SERVICE_CALL_REQUEST);
Parameters:
relationshipName - The fully qualified name of the relationship
inputRoleName - The fully qualified name of the input role
outputRoleName - The fully qualified name of the output role
inputBO - The input business object of the input role type
outputBOs - A list of output business objects that match the role object child type.
originalInputBOs - A list of original input business objects. For calling context SERVICE_CALL_RESPONSE or SERVICE_CALL_FAILURE this list may not be null or empty and the contained business objects must be of the input role type.
originalOutputBO - The original output business object. For calling context SERVICE_CALL_RESPONSE or SERVICE_CALL_FAILURE this BO may not be null and must be of the input role type.
callingContext - The calling context for the invocation. One of SERVICE_CALL_REQUEST, EVENT_DELIVERY, SERVICE_CALL_RESPONSE, and SERVICE_CALL_FAILURE.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException - Indicates an exception internal to the Relationship Service, such as a missing database connection or other runtime failures.
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException - Indicates an error in the usage of this API. Examples of incorrect use are invalid relationship/role names, business objects that are null or of invalid type, or lack of change summary/verb information in the inputBO.
com.ibm.wbiserver.relationshipservice.exceptions.DataNotFoundException - Indicates that a participant was not found when attempting to retrieve it.
com.ibm.wbiserver.relationshipservice.exceptions.DuplicateDataException - Indicates a duplicate.
Since:
WPS6.1 This API replaces maintainIdentityRelationship for maintaining relationships between parent/child roles.

correlateFromList

  1. void correlateFromList(java.lang.String relationshipName,
  2. java.lang.String inputRoleName,
  3. java.lang.String outputRoleName,
  4. java.util.List inputBOs,
  5. commonj.sdo.DataObject outputBO,
  6. commonj.sdo.DataObject originalInputBO,
  7. java.util.List originalOutputBOs,
  8. java.lang.String callingContext)
  9. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  10. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
  11. com.ibm.wbiserver.relationshipservice.exceptions.DataNotFoundException
  12. com.ibm.wbiserver.relationshipservice.exceptions.DuplicateDataException
Used to correlate a list of business objects of a simple input role with the children of parent/child output role. The children of the output role are extracted from the outputBO according to the key attribute path defined in the according role definition. The relationship is maintained based on the meta data contained in the list of inputBOs (currently either verb or change summary information or both). In order to make use of this API, the following criteria must be met:
  • The relationship that the relationshipName refers to is an 'identity' relationship (i.e. the isIdentity attribute on the relationship definition is set to true
  • The relationship has at least one role marked as 'managed' (i.e. the managed attribute in the role definition is set to true).
  • The inputRoleName refers to the managed role.
  • The inputBO matches the role object type of the role for the inputRoleName and the outputBO matches the role object type of the role for the outputRoleName
  • If the calling context is a response or a failure (see usage scenarios below), the type of the originalInputBO matches the role object type of the role for the outputRoleName and the type of the originalOutputBOs matches the role object type of the role for the inputRoleName
  • The output role is a parent/child role, i.e. the role is defined on the parent and contains at least one key attribute path to the child.
This API supports the same usage scenarios described for correlate(String, String, String, DataObject, DataObject, DataObject, DataObject, String) and applies these rules to all children. In addition, the containment relationship between the inputBO and its children is maintained with repect to the type of business graph and derived command: For after image updates: - all children that have matching participants in the database, but are not contained in the graph are deleted. - all children that exist in the graph, but are not contained in the database are created. For after image deletes: - all children under the parent are deleted In order to facilitate using this API, a helper is provided with getListOfChildren(DataObject, String) to retrieve the list for the inputBOs and originalOutputBOs. Example for service call request invocation: RelationshipService relationshipService = (RelationshipService)ServiceManager.INSTANCE.locateService("com/ibm/wbiserver/rel/RelationshipService";
List genricLineItems = relationshipService.getListOfChildren(genericOrder, "lineItems"); relationshipService.correlateToList("http://www.ibm.com/OrderRel", "http://www.ibm.com/GenericOrder", "http://www.sap.com/SAPOrder", genricLineItems, sapOrder, null, null, SERVICE_CALL_REQUEST);
Parameters:
relationshipName - The fully qualified name of the relationship
inputRoleName - The fully qualified name of the input role
outputRoleName - The fully qualified name of the output role
inputBOs - A list of input business objects that match the role object child type.
outputBO - The output business object of the output role type
originalInputBO - The original input business object. For calling context SERVICE_CALL_RESPONSE or SERVICE_CALL_FAILURE this BO may not be null and must be of the input role type.
callingContext - The calling context for the invocation. One of SERVICE_CALL_REQUEST, EVENT_DELIVERY, SERVICE_CALL_RESPONSE, and SERVICE_CALL_FAILURE.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException - Indicates an exception internal to the Relationship Service, such as a missing database connection or other runtime failures.
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException - Indicates an error in the usage of this API. Examples of incorrect use are invalid relationship/role names, business objects that are null or of invalid type, or lack of change summary/verb information in the inputBO.
com.ibm.wbiserver.relationshipservice.exceptions.DataNotFoundException - Indicates that a participant was not found when attempting to retrieve it.
com.ibm.wbiserver.relationshipservice.exceptions.DuplicateDataException - Indicates that an existing participant was found when attempting to create it.
Since:
WPS6.1 This API replaces maintainIdentityRelationship for maintaining relationships between parent/child roles.

getListOfChildren

  1. java.util.List getListOfChildren( commonj.sdo.DataObject parent,
  2. java.lang.String pathToChildren)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

isSetRelationshipProperty

  1. boolean isSetRelationshipProperty( java.lang.String relationshipName,
  2. java.lang.String propertyName,
  3. int instanceid)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Determines if the user defined property for the given relationship instance is set. This property name is one of properties defined in the relationship. In a relationship instance, it is optional to set value for relationship properties. It can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
boolean isSet = relService.isSetRelationshipProperty("http://www.ibm.com/CustomerRel", "DatetimeProperty", 1);

Parameters:
relationshipName - name of the relationship to check. If no relationship found, RelationshipUserException is thrown.
propertyName - property name to be set. If no property name found in this relationship, RelationshipServiceException is thrown.
instanceid - ID of the target relationship instance. instanceid equal with or less than zero is not valid.
Returns:
true, if the target property is set; false, if the target property is not set
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

setRelationshipProperty

  1. void setRelationshipProperty(java.lang.String relationshipName,
  2. java.lang.String propertyName,
  3. java.lang.Object value,
  4. int instanceid)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Sets value for the user defined property into this relationship instance. It can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.setRelationshipProperty("http://www.ibm.com/CustomerRel", "StringProperty", "value_String", 1);

Parameters:
relationshipName - name of the relationship to set relationship instance property. If no relationship found, RelationshipUserException is thrown.
propertyName - property name to be set. If no property name found in this relationship, RelationshipServiceException is thrown.
value - value to set for the property
instanceid - ID of the relationship instance
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

getRelationshipProperty

  1. java.lang.Object getRelationshipProperty( java.lang.String relationshipName,
  2. java.lang.String propertyName,
  3. int instanceid)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Gets the value of the user defined property in this relationship instance. In case of no property value set in this relationship instance, if there is a default value defined in the relationship definition, the default value is returned; otherwise, null is returned. It can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String value = (String) relService.getRelationshipProperty("http://www.ibm.com/CustomerRel", "StringProperty", 1);

Parameters:
relationshipName - name of the relationship to get property from. If no relationship found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this relationship, RelationshipServiceException is thrown.
instanceid - given relationship instanceID
Returns:
relationship property value
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

unsetRelationshipProperty

  1. void unsetRelationshipProperty( java.lang.String relationshipName,
  2. java.lang.String propertyName,
  3. int instanceid)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Unsets this property for the given relationship instance. It can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.unsetRelationshipProperty("http://www.ibm.com/CustomerRel", "DatetimeProperty", 1);

Parameters:
relationshipName - name of the relationship to unset property value. If no relationship found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this relationship, RelationshipServiceException is thrown.
instanceid - given relationship instanceID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

isSetRoleProperty

  1. boolean isSetRoleProperty(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. int instanceid,
  5. java.lang.Object dataobject)
  6. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  7. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Determines if this user defined property for the given role instance is set. This property name is one of properties defined in the role. In a role instance, it is optional to set value for role properties. This API can be used for static as well as dynamic relationship.
For dynamic relationship or static relationship with BO roleObject, param dataobject is an String:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
boolean result = relService.isSetRoleProperty( "http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", "IntProperty", 1, bo);

For static relationship with simple type roleObject, param dataobject could be String, long, int, float, double or boolean:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
boolean result = relService.isSetRoleProperty( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty", 1, "value_String");
Parameters:
relationshipName - name of the relationship to check. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to check. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this role, RelationshipServiceException is thrown.
instanceid - given relationship instanceID
dataobject - data of the target role instance. For dynamic relationship and static relationship with BO roleObject, dataobject is a ASBO. For static relationship with simple type roleObject, data could be String, long, int, float, double or boolean.
Returns:
true, if the target role property is set false, if the target role property is not set
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

getRoleProperty

  1. java.lang.Object getRoleProperty( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. int instanceid,
  5. java.lang.Object dataobject)
  6. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  7. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Gets the value of this user defined property for the given role instance. In case of no role property set in this role instance, if there is a default value defined in the role definition, the default one is returned; otherwise, null is returned. This API can be used for static as well as dynamic relationship.
For dynamic relationship or static relationship with BO roleObject:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
Integer value = (Integer) relService.getRoleProperty( "http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", "IntProperty", 1, bo);

For static relationship with simple type roleObject:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
Integer value = (Integer) relService.getRoleProperty( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty", 1, "value_String");
Parameters:
relationshipName - name of the target relationship. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to get property from. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this role, RelationshipServiceException is thrown.
instanceid - given relationship instanceID
dataobject - data of the target role instance. For dynamic relationship and static relationship with BO roleObject, dataobject is a ASBO. For static relationship with simple type roleObject, data could be String, long, int, float, double or boolean.
Returns:
property value or the default value if the property is not set
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

setRoleProperty

  1. void setRoleProperty(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. java.lang.Object propertyValue,
  5. int instanceid,
  6. java.lang.Object object)
  7. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  8. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Sets the specified property with the specifed value for the given role instance. It can be used for static as well as dynamic relationship.
For dynamic relationship or static relationship with BO roleObject, param object is an String:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.setRoleProperty( "http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", "IntProperty", new Integer(123456), 1, bo);

For static relationship with simple type roleObject, param object could be String, long, int, float, double or boolean:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.setRoleProperty( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty", new Integer(123456), 1, "value_String");
Parameters:
relationshipName - name of the target relationship. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that defines this property name. If no role found, RelationshipUserException is thrown.
propertyName - name of the property that is defined in the ASBO role. If no property name found in this role, RelationshipServiceException is thrown.
propertyValue - specified property value
instanceid - given relationship instanceID
object - data of the target role instance. For dynamic relationship and static relationship with BO roleObject, dataobject is a ASBO. For static relationship with simple type roleObject, data could be String, long, int, float, double or boolean.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

unsetRoleProperty

  1. void unsetRoleProperty(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. int instanceid,
  5. java.lang.Object dataobject)
  6. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  7. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Removes property value for this this role instance.It can be used for static as well as dynamic relationship.
For dynamic relationship or static relationship with BO roleObject, param object is an String:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.unsetRoleProperty( "http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", "IntProperty", 1, bo);

For static relationship with simple type roleObject, param object could be String, long, int, float, double or boolean:
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.unsetRoleProperty( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty", 1, "value_String");
Parameters:
relationshipName - name of the target relationship. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that defines this property name. If no role found, RelationshipUserException is thrown.
propertyName - name of the property that is defined in the ASBO role. If no property name found in this role, RelationshipServiceException is thrown.
instanceid - given relationship instanceID
dataobject - data of the target role instance. For dynamic relationship and static relationship with BO roleObject, dataobject is a ASBO. For static relationship with simple type roleObject, data could be String, long, int, float, double or boolean.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipant

  1. int createParticipant(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. commonj.sdo.DataObject bo)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant to a new relationship instance. The BO contains value for the ASBO role. It could also be a BusinessGraph. This API can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int instanceID = relService.createParticipant("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", bg);

Parameters:
relationshipName - name of the relationship to add the relationship instance to. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown.
bo - data to be set for the role attribute. It could also be an BusinessGraph.
Returns:
relationship instance ID. If there is an existing participant with the same bo, the instanceID of the existing one is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

createParticipantWithID

  1. int createParticipantWithID(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. int instanceId,
  4. commonj.sdo.DataObject bo)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds a participant for an existing relationship instance that has this instanceId. BO contains value for this ASBO role. It could also be an BusinessGraph. This API can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int instanceID = relService.createParticipantWithID("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", targetID, bg);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown.
instanceId - given relationship instanceID
bo - data to be set for the role attribute. It could also be an BusinessGraph.
Returns:
relationship instance ID. If there is an existing participant with the same bo, the instanceID of the existing one is returned.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

setRolePropertyWithOldValue

  1. void setRolePropertyWithOldValue( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. java.lang.Object propertyValue,
  5. java.lang.Object oldPropertyValue,
  6. int instanceid)
  7. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  8. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Sets this propertyValue to the given role property in the role instance. This role instance has the specified instanceID and this oldPropertyValue in the specified role property name. This API can be used for static as well as dynamic relationship.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.setRolePropertyWithOldValue("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", "IntProperty", new Integer(123456), new Integer(11111), 1);

Parameters:
relationshipName - name of the target relationship. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that defines this property name. If no role found, RelationshipUserException is thrown.
propertyName - name of the property that is defined in the ASBO role. If no property name found in this role, RelationshipServiceException is thrown.
propertyValue - new property value
oldPropertyValue - old property value
instanceid - given relationship instanceID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

unsetRolePropertyWithOldValue

  1. void unsetRolePropertyWithOldValue( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. java.lang.Object oldPropertyValue,
  5. int instanceid)
  6. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  7. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Unsets value of this role property in the give role instance. This role instance has the specified instanceID and this oldPropertyValue in the specified role property name.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.unsetRolePropertyWithOldValue("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", "IntProperty", new Integer(11111), 1);

Parameters:
relationshipName - name of the target relationship. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that defines this property name. If no role found, RelationshipUserException is thrown.
propertyName - name of the property that is defined in the ASBO role. If no property name found in this role, RelationshipServiceException is thrown.
oldPropertyValue - specified old property value
instanceid - given relationship instanceID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

staticLookup

  1. void staticLookup(java.lang.String relName,
  2. java.lang.String inputRoleName,
  3. commonj.sdo.DataObject inputBO,
  4. java.lang.String[] inputAttrNames,
  5. java.lang.String outputRoleName,
  6. commonj.sdo.DataObject outputBO,
  7. java.lang.String[] outputAttrNames)
  8. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  9. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Performs a static relationship lookup using input Business Object and its property name. Sets the output Business Object property
to the retrieved value.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.staticLookup("http://www.ibm.com/StateRel", "http://www.sap.com/SAPRole", inputBO, inputAttrNames, "http://www.clarify.com/ClarifyRole", outputBO, outputAttrNames);

inputRoleName - name of the input role. If no role found, RelationshipUserException is thrown.
inputAttrNames - list of input Business Object property names. If input role is based on a BO, then input property names have to match the key attributes of
the input role.
outputRoleName - name of the output role. If no role found, RelationshipUserException is thrown.
outputAttrNames - list of output Business Object property names. If output role is based on a BO, then output property names have to match the key attributes of
the output role.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

staticLookup

  1. java.lang.Object staticLookup(java.lang.String relName,
  2. java.lang.String inputRoleName,
  3. java.lang.Object inputAttrValue,
  4. java.lang.String outputRoleName)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Performs a static lookup by taking relationship name, input and output role names and input key attribute value. Returns the retrieved value of the output key attribute. This API is added initialy for the static relationship lookup call from XSLT map.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String stateFullName = (String)relService.staticLookup("http://www.ibm.com/StateRel", "http://www.sap.com/SAPRole", "CA", "http://www.clarify.com/ClarifyRole");

Parameters:
relName - name of a static relationship. If no relationship found or relationship is not static, RelationshipUserException is thrown.
inputRoleName - name of the input role. If no role found, RelationshipUserException is thrown.
inputAttrValue - input key attribute value. It could be a primitive type that matches the key attribute type of input role
outputRoleName - name of the output role. If no role found, RelationshipUserException is thrown.
Returns:
Object output key attribute value. Its type is a primitive type that matches the key attribute type of output role
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

setRelationshipProperties

  1. void setRelationshipProperties( java.lang.String relationshipName,
  2. java.lang.String propertyName,
  3. java.lang.Object propertyValue)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Sets a relationship property to a specified value for all the instances of a relationship. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.setRelationshipProperties("http://www.ibm.com/CustomerRel", "StringProperty", "value_String");

Parameters:
relationshipName - name of the relationship whose property needs to be set. If no relationship found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in the specified relationship, RelationshipServiceException is thrown.
propertyValue - property value
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

setRoleProperties

  1. void setRoleProperties(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. java.lang.Object propertyValue,
  5. int instanceid)
  6. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  7. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Sets a role property to a specified value for a relationship instance. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.setRoleProperties( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty", new Integer(123456), 1);

Parameters:
relationshipName - name of the relationship whose role property needs to be set. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that contains the specified property. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in the specified role, RelationshipServiceException is thrown.
propertyValue - property value
instanceid - id of the relationship instance whose role property needs to be set.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

setRoleProperties

  1. void setRoleProperties(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. java.lang.Object propertyValue)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Sets a role property to a specified value for all instances. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.setRoleProperties( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty", new Integer(123456));

Parameters:
relationshipName - name of the relationship whose role property needs to be set. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that contains the specified property. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this role, RelationshipServiceException is thrown.
propertyValue - property value
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

unsetRelationshipProperties

  1. void unsetRelationshipProperties( java.lang.String relationshipName,
  2. java.lang.String propertyName)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Unsets a relationship property for all instances of a relationship. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.unsetRelationshipProperties("http://www.ibm.com/CustomerRel", "DatetimeProperty");

Parameters:
relationshipName - name of the relationship whose property needs to be unset. If no relationship found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in the relationship, RelationshipServiceException is thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

unsetRoleProperties

  1. void unsetRoleProperties(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Unsets a role property for all relationship instances. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.unsetRoleProperties( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty");

Parameters:
relationshipName - name of the relationship that contains the specified role. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that contains the specified property. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this role, RelationshipServiceException is thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

unsetRoleProperties

  1. void unsetRoleProperties(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. int instanceid)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Unsets a role property for a relationship instance. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.unsetRoleProperties( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty",1);

Parameters:
relationshipName - name of the relationship that contains the specified role. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role that contains the specified property. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this role, RelationshipServiceException is thrown.
instanceid - id of the relationship instance whose role proprety needs to be unset. If the id is invalid, RelationshipUserException is thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

getRelationshipProperties

  1. java.util.List getRelationshipProperties( java.lang.String relationshipName,
  2. java.lang.String propertyName)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Gets the values of a user defined relationship property for all instances of a relationship. In case of no property value set in an instance, the default value is returned if there is a default value defined in the relationship definition; otherwise, an empty string is returned for that instance. It can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
String value = (String) relService.getRelationshipProperties("http://www.ibm.com/CustomerRel", "StringProperty");

Parameters:
relationshipName - name of the relationship to get property from. If no relationship found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this relationship, RelationshipServiceException is thrown.
Returns:
a list of instance id and property value pairs. An empty list if there is no relationship instance exists.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

getRoleProperties

  1. java.util.List getRoleProperties( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Gets the values of a user defined role property for all instances of the specified relatinoship, role. In case of no role property value set in an instance, the default value is returned if there is a default value defined in the role definition; otherwise, an empty string is returned for the instance. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
Integer value = (Integer) relService.getRoleProperties( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty");

Parameters:
relationshipName - name of the target relationship. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to get property from. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in this role, RelationshipServiceException is thrown.
Returns:
a list that each element in the list is also a list that contains instance id, role id and property value.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

getRoleProperties

  1. java.util.List getRoleProperties( java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.lang.String propertyName,
  4. int instanceid)
  5. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  6. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Gets the values of a user defined role property for a instance based on the given relationship name, role name, property name and instance id. In case of no role property value set in an instance, default value is returned if there is a default value defined in the role definition; otherwise, an empty string is returned for the instance. This API can be used for static as well as dynamic relationships.

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
Integer value = (Integer) relService.getRoleProperties( "http://www.ibm.com/StaticRel", "http://www.ibm.com/StringRole", "IntProperty", 1);

Parameters:
relationshipName - name of the relationship to get property from. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to get property from. If no role found, RelationshipUserException is thrown.
propertyName - name of the target property. If no property name found in the role, RelationshipServiceException is thrown.
instanceid - id of the relationship instance to get property for. If the id is invalid, RelationshipUserException is thrown.
Returns:
a list of role id and property value pairs.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantsWithID

  1. void addParticipantsWithID(java.lang.String relationshipName,
  2. int instanceid,
  3. java.util.HashMap roleName_value)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds multiple participants to a relationship instance for multiple roles. This API can be used for static as well as dynamic relationships.

Map roleName_value = new HashMap();
roleName_value.put("http://www.sap.com/SAPRole", sapCustomer);
roleName_value.put("http://www.clarify.com/ClarifyRole", clarifyCustomer);

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.addParticipantsWithID("http://www.ibm.com/CustomerRel", 1, rolaName_value);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException is thrown.
instanceid - id of the relatinoship instance to add participant to. If id is invalid, RelationshipUserException is thrown.
roleName_value - a HashMap that contains role name and participant data pairs. role name is the name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown. participant data could be BusinessObject, BusinessGraph, or the supported primitive types.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipants

  1. void addParticipants(java.lang.String relationshipName,
  2. java.lang.String roleName,
  3. java.util.HashMap iid_value)
  4. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  5. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds multiple participants to multiple relationship instances for a role. This API can be used for static as well as dynamic relationships.

Map iid_value = new HashMap();
iid_value.put(1,sapCustomer1);
iid_value.put(2,sapCustomer2);

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.addParticipants("http://www.ibm.com/CustomerRel", "http://www.sap.com/SAPRole", iid_value);

Parameters:
relationshipName - name of the relationship to add the participant to. If no relationship found, RelationshipUserException is thrown.
roleName - name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown.
iid_value - a HashMap that contains instance id and participant data pairs. iid is the id of the relationship instance to add the participant to. If no role found, RelationshipUserException is thrown. participant data could be BusinessObject, BusinessGraph, or the supported primitive types.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipants

  1. void addParticipants(java.lang.String relationshipName,
  2. java.util.HashMap iid_subMap)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds mulitple participants to multiple relationship instances for multiple roles. This API can be used for static as well as dynamic relationships.

Map roleName_value1 = new HashMap();
roleName_value.put("http://www.sap.com/SAPRole", sapCustomer1);
roleName_value.put("http://www.clarify.com/ClarifyRole", clarifyCustomer1);

Map roleName_value2 = new HashMap();
roleName_value2.put("http://www.sap.com/SAPRole", sapCustomer2);
roleName_value2.put("http://www.clarify.com/ClarifyRole", clarifyCustomer2);

Map iid_subMap = new HashMap>();
iid_subMap.put(1,roleName_Value1);
iid_subMap.put(2,roleName_value2);

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.addParticipants("http://www.ibm.com/CustomerRel", iid_subMap);

Parameters:
relationshipName - name of the relationship to add the participants to. If no relationship found, RelationshipUserException is thrown.
iid_subMap - a HashMap that contains instance id and subMap pairs. instance id determines the instance to add participants to. subMap contains participtns of the instance. It is a HashMap that contains role name and participant data pairs. role name is the name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown. participant data could be BusinessObject, BusinessGraph, or the supported primitive types.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

addParticipantsWithoutID

  1. int addParticipantsWithoutID(java.lang.String relationshipName,
  2. java.util.HashMap roleName_value)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Adds multiple participants to a new relationship instance for multiple roles. This API can be used for static as well as dynamic relationships.

Map roleName_value = new HashMap();
roleName_value.put("http://www.sap.com/SAPRole", sapCustomer);
roleName_value.put("http://www.clarify.com/ClarifyRole", clarifyCustomer);
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int id = relService.addParticipantsWithoutID("http://www.ibm.com/CustomerRel", roleName_value);

Parameters:
relationshipName - name of the relationship to add the participant to. If no Relationship found, RelationshipUserException is thrown.
roleName_value - a HashMap that contains role name and participant data pairs. role name is name of the ASBO role to add the participant to. If no role found, RelationshipUserException is thrown. participant data could be BusinessObject, BusinessGraph, or supported primitive types.
Returns:
relationship instance ID
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

deleteParticipants

  1. void deleteParticipants(java.lang.String relationshipName,
  2. java.util.List roleNames)
  3. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  4. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Deletes all the participants for the sepecified roles of a relationship. It can be used for static as well as dynamic relationships.

List roleNameList = new ArrayList();
roleNameList.add("http://www.sap.com/SAPRole");
roleNameList.add("http://www.clarify.com/ClarifyRole");
RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
relService.deleteParticipants("http://www.ibm.com/CustomerRel", roleNameList);

Parameters:
relationshipName - name of the relationship to delete the participants from. If no relationship found, RelationshipUserException is thrown.
roleNames - a list of role names to delete the partcipants from. If no role found, RelationshipUserException is thrown.
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException

getNewInstanceId

  1. int getNewInstanceId(java.lang.String relationshipName)
  2. throws com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
  3. com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException
Gets a new instance id for a new relationship instance

RelationshipService relService = (RelationshipService) new ServiceManager().locateService("com/ibm/wbiserver/rel/RelationshipService");
int instanceId = relService.getNewInstanceId("http://www.ibm.com/CustomerRel");

Parameters:
relationshipName - name of the relationship to get the new instance id for. If no relationship found, RelationshipUserException is thrown.
Returns:
a new instance id that is generated by RelationshipService
Throws:
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipServiceException
com.ibm.wbiserver.relationshipservice.exceptions.RelationshipUserException