Help

Viewing a card tree

Card trees can be viewed in a number of ways. In addition to the usual List and Grid views, you can choose to view the card tree represented as an explorer-like Hierarchy, or as an inverted Tree.

Card trees can be included in favorites and tabs if they are likely to be used often.

Select a card tree...

To begin, you need to select a card tree to view

  • From the All, select a card tree from the drop-down list in the header area.

    Select a card tree from the All tab

  • From the Favorites, select a favorite that is based on a card tree.

    Select a card tree from the Favorites sidebar

General tree controls...

Configure current tree

The Configure current tree link is displayed in the view header whenever a tree is selected. It allows you to quickly navigate to configure the tree you are currently viewing if you have to appropriate permissions.

Manage trees

The Manage trees link is always displayed in the view header. It allows you to quickly navigate to administer card trees for the project if you have to appropriate permissions.

Using the tree filter

The tree filter is similar to the list view card filter, except that it allows you to set filter conditions separately for each card type in the tree.

card tree - tree filter
User selects to view cards with Release-size > 30 and Iteration-priority = high. The following cards are displayed
  • All Release cards with size > 30
  • All high priority Iteration cards within releases that have size > 30
  • All stories belonging to the above iterations
User selects to view cards with Story Priority = High
  • This would display all release cards and all iteration cards
  • Only story cards having priority = High would be displayed
  • If a Release or Iteration does not contain a story with priority set to High, it is still displayed, but its child stories are not
If filter criteria is defined as Release = R1
  • R1 is displayed
  • Only iterations and stories which belong to R1 will be displayed

You can choose to hide all cards of a given type in the tree by checking the box next to the card type in the Do not show section at the top of the filter.

  1. To add a new filter condition, click on the Add a filter link. A new row will be inserted into the filter control.

    New filter condition

  2. Choose a property by clicking on the (select...) link. You will be able to choose any property which is associated with the card type.

  3. Choose a comparison operator by clicking on the is link. The options available will depend on what is applicable to the property you selected in the step above. You won't be able to select anything except the default until you've selected a property, because the allowable values are dependent on the property selected.

    Full list of comparison operators
    • is - the default operator; will restrict the property to only the value specified.
    • is not - will restrict the property to only values other than the one specified.
    • is less than - shown when the property is ordered. Will restrict the property to values which are strictly less than the specified value. Does not include cards having the property value equal to the specified value.
    • is greater than - shown when the property is ordered. Will restrict the property to values which are strictly greater than the specified value. Does not include cards having the property value equal to the specified value.
    • is before - shown when the property is a date, equivalent to is less than. Does not include cards having the property value equal to the specified date.
    • is after - shown when the property is a date, equivalent to is greater than. Does not include cards having the property value equal to the specified date.

    • Properties can have a natural order, such as numbers or dates - in this case that natural ordering is used to resolve 'is less/greater than' conditions.
    • Enumerated properties, where the allowable values are specified in a list - use the sort order of the list to resolve 'is less/greater than' conditions.

  4. Choose a value by clicking on the (any) link. The options available will depend on what is applicable to the property you selected in the step above. You won't be able to select anything except the default until you've selected a property, because the allowable values are dependent on the property selected.

    There are several special values which can appear here:

    • (any) - Specifies cards having any value for the selected property. Available for operators is and is not.This is the same as having no condition for the property at all.
    • (not set) - Specifies cards which have no value set for the property. Available for operators is and is not. This is analogous to the 'null' term in SQL. It is not available for mandatory Mingle card properties such as Type.
    • (current user) - Specifies cards which have the currently logged in user assigned to the selected property. Available for operators is and is not. Available for properties which take Mingle users as values.
    • (today) - Specifies cards which have the current date assigned to the selected property. Available for operators is, is not, is before, is after. Available for date properties.

    The available values depend on the data type of the property you selected
    • if you selected the Type property, then you will be presented with the list of all card types and the special value (any).
    • if you selected a Managed List property, then you will be presented with the list of all values that have been specified in the managed list and the special values (any), (not set).
    • if you selected a Date, then you will be presented with a calendar widget that will allow you to select a date, as well as the special values (any), (not set) and (today).
    • if you selected a Team member property, then you will be presented with a list of the current team members, as well as the special values (any), (not set) and (current user).
  5. Your new filter condition will be applied as soon as you've selected a value, and you should see the results reflected in the cards displayed in the view.
  6. You can optionally filter the tree by specifying tags. Click on the Add tags link, type in the tags separated by commas, and click the Add tags button. Only cards which have all of the specified tags will be displayed.

  7. To remove a filter condition, simply click on the Delete filter condition button next to the condition you want to remove. Again, the effect of removing the condition will immediately be reflected in the view.

Tree specific views