Skip to main content
Planview Customer Success Center

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>