Help

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

  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. TODO: the rule is that the list is sorted in ascending order from top to bottom, should add graphics here to explain

  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. 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.