IBM BPM, V8.0.1, All platforms > Administer applications and processes in the runtime environment > Manage relationships
Manage relationship instances
Managing relationship instances can include tasks like viewing and editing instances, exporting and importing instances, creating and deleting instances, and rolling back instance data.
- Viewing relationship instances
- You can view a list of relationship instances that match a specific relationship query. The results display in table view and include the relationship instance ID and the property values associated with the instance.
Restriction: Filtering or sorting on a large relationship instance count might result in performance problems as it requires getting the full query result set from the server in order to do the sorting.
For example, sorting the relationship instance data on a query that would return 20,000 relationship instances needs to sort on those 20,000 instances. The total count (bottom of page) gives an estimate of how many relationship instances you can expect and whether sorting or filtering on a large set of data might lead to long wait times.
You can view detailed information for the selected relationship instance, including the relationship name, relationship instance ID, property values, participating roles, and role instance values (role instance ID, logical state, key attributes, and property values). You can view multiple roles concurrently.
- Creating or deleting relationship instances
- You can create new relationship instances in the relationship manager. For each new relationship instance you create, create a corresponding role instance.
When a relationship instance is no longer needed, you can delete it.
- Editing relationship instance details
- If property values have previously been defined for a relationship instance, you can use the relationship manager to edit those values.
- Rolling back relationship instance data
- You can roll back the relationship instance data to a specified date and time. The following actions take place during the rollback:
- Relationship instances which are created during the given period get deleted (hard delete) from the database.
- Relationship instances which are activated get deleted (hard delete) from the database.
- Relationship instances which are deactivated in the given time period get activated.
Before you roll back relationship instance data, ensure that the Process Server and the database server are set to the same time zone to help prevent a rollback failure.
- Exporting relationship instances
- You can export data from an existing relationship to an RI or CSV file. Exporting a relationship is useful in situations when you want to incorporate an existing relationship from one platform into a system running on another platform, but do not want to write code or use relationship manager to add instance details individually.
- Importing relationship instances
- You can use the relationship manager to import relationships that have been exported in RI or CSV file format. Importing an existing relationship is useful in situations when you want to incorporate a relationship from another platform into your solution, but do not want to write code or use relationship manager to add instance details individually
If there are existing relationship instances in the database, existing relationship instances and newly imported relationship instances will be merged. If the relationship definition that you are importing does not exist, a RelationshipUserException will be thrown.
For more information on these tasks, see the relationship manager online help.