GetRelatedEntity<>

The GetEntity<> activity must precede the GetRelatedEntity<> activity.

The GetRelatedEntity<> activity retrieves logical identifiers of records in the specified recordlist tab of the object record that was retrieved in the GetEntity<> activity.

For an object, the GetRelatedEntity<> activity retrieves the following details:

From a RecordList tab:

1. Instance Id of the Object
2. Row Id of the RecordList Property Value
3. RecordList Property Values

From a tab of a Many-To-Many relationship without relationship properties:

1. BaseObject Instance Id
2. Related Object Instance Id

From a tab of a Many-To-Many relationship with relationship properties:

1. BaseObject Instance Id
2. Related Object Instance Id
3. Associated relationship property value

When you select the 'Browse for Type' option, the list of assemblies and associated entities is displayed. Find and select the entity and click OK.

After you have selected an entity, the name of the entity is inserted in the DisplayName field, e.g., GetRelatedEntity <Contact>. Proceed to specify the entity to be retrieved, and the related entity name details.

Properties

GetRelatedEntity<> Properties

Property	Value	Required	Notes
DisplayName	String	No	Specify a name for the activity or accept the default.
Entity	InOutArgument<Entity>	Yes	Specify the entity identifier using a VB expression or variable.
RelatedEntityName	String	Yes	Specify the logical identifier of the related entity that can be retrieved.