Relationship Clause for the Expand Businessobject Command

This clause returns all objects connected to the starting object with a specific relationship. The command can be made to be more particular by specifying the direction of the relationship and/or the types of objects to return.

The Relationship clause is useful when you are working with an object that can use multiple relationship types. If the starting object can connect with only one relationship, this clause has the effect of listing all of the connection ends used by the starting object. It does not matter if the end is defined as a TO end or a FROM end. Only the relationship type is important.

For example, assume you have an object that contains a drawing. This drawing can use a number of relationships such as a User Manual Relationship, Design Relationship, Marketing Relationship, and Drawing Storage Relationship. You might want to examine all objects that use a particular relationship type. For example, you might want to learn about all objects that have used the drawing for marketing. To do this, you might enter a command similar to: 

expand businessobject Drawing “Mona Lisa” 1
relationship “Marketing Relationship”;

This command lists all objects connected to the Drawing with the Marketing Relationship relationship. It searches through all connections that use the Marketing Relationship definition for the named business object. If it finds the object, MQL displays the other connection end and identifies the end’s directional relationship. It does not matter if the related objects are defined as the FROM end or the TO end of the relationship. Only the relationship type is important.