GetLink Function
GetLink (entityType as String, ref1 as ObjectIdentifier, ref2 as ObjectIdentifier) as ObjectIdentifier
Category: | ObjectReference |
Description: | Retrieves a link between two objects, where the entity type variable indicates the type of link and the ref1 and ref2 variables indicate the specific objects between which the link exists |
Supported Context: | BusinessRules |
Parameters: | |
entityType as String | Represents the link type of the desired link object (i.e. RelatedWork). You can access all the available link types using the values denoted in the "Class" option in the "Pick lists" tab of the formula helper |
ref1 as ObjectIdentifier | Represents a specific object, or reference to a field that returns a specific object, to which the desired link object is attached |
ref2 as ObjectIdentifier | Represents a specific object, or reference to a field that returns a specific object, to which the desired link object is attached |
Returned value as ObjectIdentifier | Returns the a reference to a link between the two objects specified in the "ref1" and "ref2" parameters |
Example #1 |
To get the link that connects the current object (of type work item) to its direct parent: GetLink('RealWorkItemHierarchyLink',CurrentObject(),$Parent) |
Example #2 |
To find out if there is a dependency between two work items, check if the following is not null: GetLink('DependencyLink','T-4','T-13') || GetLink('DependencyLink','T-13','T-4') |
Additional Information
Internal Link Name |
Related Entity 1 |
Related Entity 2 |
Comments |
|
---|---|---|---|---|
Assigned |
'ResourceLink' |
Work Item |
User |
|
Rate Holder |
'JobTitleRateLink' |
Project |
Job Title |
|
Resource |
'RegularResourceLink' |
Work Item |
User |
|
Reviewer |
'ReviewerLink' |
Work Item |
User |
|
(Additional) Manager |
'ManagerResourceLink' |
Work Item |
User |
|
Attachment |
'AttachmentLink' |
Work Item, Expense, All Issue Types |
Document |
|
Dependency |
'DependencyLink' |
Work Item |
Work Item |
Where ref1 is the predecessor work item, and ref2 is the successor work item |
Hierarchy |
'WorkItemHierarchyLink' |
Work Item |
Work Item |
Where ref1 is the parent work item, and ref2 is the child work item |
Parent |
'RealWorkItemHierarchyLink' |
Work Item |
Work Item |
Where ref1 is the hammock (parent) work item, and ref2 is the sub work item (child) |
Progress Impact |
'ProgressImpactLink' |
Work Item |
Work Item |
Where ref1 is the impacted (parent) work item, and ref2 is the impacting (child) work item |
Shortcut |
'ShortcutLink' |
Work Item |
Work Item |
Where ref1 refers to the location of the shortcut (parent), and ref2 is the original work item (child) |
Issue Customer Link |
'CaseCustomerLink' |
All Issues Types |
Customer |
|
Issue's Team |
'IssueTeamMembers' |
All Issue Types |
User |
|
Membership |
'MembershipLink' |
Resource Entity |
Resource Entity |
Where ref1 refers to the resource entity object where ref2 resource entity object is a member of |
Group Hierarchy |
'GroupHierarchyLink' |
Group |
Group, User |
|
Job Title Link |
'JobTitleLink' |
Job Title |
User |
|
Skill Link |
'SkillLink' |
Skill |
Group User |
|
Project Customer Link |
'CustomerLink' |
Project |
Customer |
|
Related Work |
'RelatedWork' |
All Issue Types |
Work Item |
|
Stopwatch |
'Stopwatch' |
Work Item |
User/td> |
|