Help

Modifying or deleting card properties

Modify a card property

Navigate to the Card properties page

Card properties page - edit property

What you can change in the Card properties page...

  • Show / Hide - properties can be hidden if they are not required for data entry - for example calculated values used in reporting. Hidden card properties are not displayed in the card view, the value can only be set by declaring a default value, or via a transition, or calculated if it's a formula property.

    You can also hide a property instead of deleting it, which will retain historical data about changes to that property.

  • Lock / Unlock - any Managed List property can be locked, this restricts the set of allowed values to only those predefined by the Project Administrator, team members will not be able to dynamically add new values.
  • Transition only? - indicates that the property can only have its value set via a transition, it will not be directly editable by team members.

Editing the details of a card property...

Click the Edit link next to the card property you wish to modify.

Mingle displays the Edit property definition page.

The things you can edit depend on the type of property you chose

Edit card property definition page

You can't change the property type here. If you've accidentally created the property with the incorrect type - you will need to delete it and recreate a new property with the same name.

You can always change the name and description of a property, however do consider whether you should be renaming an existing property or creating a new one.

Effects of renaming a property
  • The name will be changed in any card types using the property
  • Any MQL which referenced the original property name will display an error, this may affect charts and tables
  • Any Formula property which referenced the original property name will be updated to reference the new name
  • Any Favorite which used the original property name in a filter condition will be changed to use the new name
  • Any Transition which used the original property name in its 'has' or 'set' clause will be changed to use the new name
  • Any Aggregate properties which referenced the original property name will be updated to reference the new name

For Managed list properties - you can change the list of allowed values by clicking on the Edit values

Edit card property page - edit values link

For Formula properties - you can change the formula definition

Edit card property page - edit formula

Aggregate properties and relationship properties are separately defined as part of a card tree, see Modifying or deleting aggregate properties and Modifying card treesfor details.

Delete a card property

Navigate to the Card properties page

Card properties page

Delete the property...

Click the Delete link next to the card property you wish to delete.

Deletion is not possible if:
  • The property is referenced by a formula property.

Mingle will display the Delete property confirmation page

Delete property confirmation page

Click on the Continue to delete to permanently delete the property

Deletion of a card property is an unrecoverable action (short of restoring from a database backup). You should consider the consequences of deleting a property, and if you are in any doubt it may be safer to use the hide property feature instead of deleting.

The effects of deleting a property...

Cards using the property

  • The property will be removed from any cards which were using it, and the values will be deleted.

History view

  • The property will be removed from all cards and values for that property will no longer be displayed in history.
  • Any card versions which contained only changes to this property will no longer appear in history

Card transitions

  • Any card transitions which reference the property as a 'has' value or which assign a value to the property will be deleted

Favorites and tabs

  • Favorites that include the deleted property as a display column or in a filter condition will be deleted
  • Any tabs based on those favorites will also be deleted

Wiki pages

  • Wiki pages and tables/charts that reference the deleted property will no longer work. The MQL syntax will not be changed, so you will need to manually alter any affected wiki pages to remove references to the deleted property.

A fast way to find all of the wiki pages which use the card property in MQL is to use the Mingle search.

Simply type in the name of the card property e.g. "some property" and hit the Search

Mingle will show all wiki pages referencing the card property - you can then open each of these pages for editing and make the appropriate changes.

Note that if your property name is a common word or phrase - you may get some additional pages that contain that word outside of MQL statements.

Aggregate properties

  • Aggregate properties which operate on the deleted property will also be deleted.
  • Consequently - any Wiki pages, Favorites, Tabs or Feeds which reference the aggregate property will also be affected.

Formula properties

  • It's not possible to delete a component property (referenced in the formula definition) of a Formula property. The property has to be removed from the formula definition before it can be deleted.

Externally stored bookmarks

  • Externally stored URLs will become invalid if they included the original property name. This may affect browser bookmarks that users have made to quickly navigate to specific card views.

Subscribed atom feeds

  • Previously subscribed atom feeds that use the deleted property will no longer provide new data