Relationship properties
Introduction...
There are two types of relationship properties; Card Relationship Property and Tree Relationship Property. Relationship properties are used to reference one card to another.
Card relationship properties
The card relationship properties allow users to create a link between any cards. It's not limited to any specific card type so user can link a story to another story, bug or task. One thing to note here is that card relationship properties do not require to create a tree - unlike tree relationship properties.
Please refer the screen shot below. It shows a current card is 'Depend on', which is a card relationship property, another story 'Story 1'.
Tree relationship properties
The tree relationship properties in a child card can reference its ancestors in a card tree. This type of properties are created and named as part of configuring a card tree, and they appear on cards visually grouped under the name of the card tree they belong to.
Please refer the screen shot below. You can easily notice that a current card belongs to Iteration 1 of Release 2.
Assigning a value to relationship properties...
- In a card tree view - when you add a card to a tree by dragging it onto an existing parent card, the proper tree relationship properties are set automatically. You can also drag a child card from one parent to another and the appropriate tree relationship properties will be modified to refer to the new parent.
- From a card default - you can assign a specific card to card relationship properties or tree relationship properties from card defaults. Then when this type of card is created, new card will be obtain the assigned value.
- On a card view - you can manually set card relationship property or tree relationship property from the card view by clicking on it and selecting a new card reference from the displayed list.
For card relationship properties, entire cards that exist on current project will be available as a value of a property.
For tree relationship properties, only cards of the appropriate type which are already in the card tree will be available.
- On card list or card grid view - you can bulk update card relationship properties or tree relationship properties. If different types of multiple cards are selected, only common properties will be listed on bulk edit action bar.
Removing a relationship property
Card relationship properties
You can delete card relationship properties from the card properties management page. When you click on 'delete' link, user will be taken to a warning page and get informed about the consequences of deleting a card relationship property.
Tree relationship properties
The tree relationship properties for a card tree will be deleted from all cards if the tree itself is deleted. Likewise, if a card is removed from a tree, these properties will be removed from that card.