{"id":2902,"date":"2017-11-10T08:33:46","date_gmt":"2017-11-10T08:33:46","guid":{"rendered":"https:\/\/www.threesl.com\/blog\/?p=2902"},"modified":"2022-08-23T15:19:08","modified_gmt":"2022-08-23T14:19:08","slug":"displaying-item-hierarchies","status":"publish","type":"post","link":"https:\/\/www.threesl.com\/blog\/displaying-item-hierarchies\/","title":{"rendered":"Displaying Item Hierarchies"},"content":{"rendered":"

You will often want to organise information in a hierarchy. In a hierarchy, each item of information will have a unique Identity<\/em>, a hierarchical number<\/em> and (usually) a name. Displaying item hierarchies nicely will help everyone to clearly understand the information and its structure.<\/p>\n

For example, here is a (very!) simple collection of System Breakdown Structure<\/em> (SBS) hierarchies:<\/p>\n

\"displaying
A Collection of SBS Hierarchies<\/figcaption><\/figure>\n

This display clearly shows the hierarchical structure of the items, their hierarchical numbers, and their names.<\/p>\n

Displaying Item Hierarchies<\/h2>\n

Hierarchies display items with a label. This label contains the item’s Identity<\/strong>, Name<\/strong>, Version<\/strong> and Draft ID<\/strong> attributes.<\/p>\n

3SL recommends that hierarchical items are auto-numbered. Therefore, their Identity<\/strong> will not be the nice hierarchical number that users will want to see. That hierarchical number is normally stored in the Key<\/strong> attribute.<\/p>\n

Therefore, we want the labels for items in a hierarchy to contain the Key<\/strong> and Name<\/strong> attributes.<\/p>\n

Create a View for Trees<\/h2>\n

So, your first step is to define a view to show items in trees, such as:<\/p>\n

\"define
Define Items’ Tree View<\/figcaption><\/figure>\n

This contains only the Key<\/strong> and Name<\/strong> attributes, and a small text separator containing\u00a0 a colon. This separator is cosmetic. If you prefer not to have it, then don’t!<\/p>\n

Save the view with a simple name such as the item type followed by Tree. In this case, the view name is:<\/p>\n

SBS – Tree<\/strong><\/p>\n

Save it as a Project <\/em>scope view. If you save the view with Project <\/em>scope, everyone in the project can use it.<\/p>\n

Tell Cradle to Use this View in Trees<\/h2>\n

The final step is to tell Cradle to use the new view when displaying hierarchies of this type of information:<\/p>\n

\"displaying
Specify a View to Show Items in Trees<\/figcaption><\/figure>\n