Help

Modifying or deleting project variables

Navigate to the project variables page...

Project variables page

Modify a project variable...

Open the Edit project variable page...

To modify a project variable, click on the Edit link to the left of the project variable name

Mingle displays the Edit project variable page.

Edit project variable dialog

Renaming a project variable...

Type a new Name for the project variable.

This is the name which will identify the variable wherever it is used in the project, it should be as succinct and descriptive as possible.

The name should be not blank, should not contain "'&', '=', '#', '[' or ']'" characters, and must be less than 40 characters in length.

Mingle will display how the project variable name will look - all project variable names are enclosed in parenthesis, e.g. (variable)

While it is possible to use the same name for both a project variable and a card property, it's probably less confusing to avoid doing so.

Effect on wiki pages
  • Wiki pages and tables/charts that reference the renamed project variable will no longer work. The MQL syntax will not be changed, so you will need to manually alter any affected wiki pages to alter references to the new project variable name.

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

Simply type in the old name of the project variable e.g. "some project variable" and hit the Search

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

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

Changing the type of a project variable...

Select a new type for the project variable.

Changing the type of a project variable is effectively the same as deleting it and creating a new one with the same name. See The effects of deleting a project variable below to understand the impact of changing the type of a project variable.

available types:
  • Text - any text value
  • Numeric - any numeric value
  • Selected from team list - any project team member
  • Date - any valid date
  • Card - a reference to any card of the specified type
Update project variable confirmation page

Change the value of a project variable

Enter or select the new value you want to assign to the project variable.

Change which card properties are linked to the project variable...

The project variable will only be available in filter conditions, transitions and MQL queries for properties that it has been explicitly linked to.

Only properties which have the same data type as the project variable will be shown in the list

Effects:
  • Transitions - any transition which used the project variable to set a property which is no longer linked to that project variable will be deleted.
  • Favorites and Tabs - any favorites or tabs which use the project variable to filter a property which is no longer linked to that project variable will be deleted.
  • Wiki pages - any MQL statement which use the project variable as part of a condition on a property which is no longer linked to that project variable will no longer work.

Save your work...

Click on the Save project variable link to save the project variable

Save project variable link

Delete a project variable...

To delete a project variable, click on the Delete link to the left of the project variable name

If there are any transitions which reference the project variable, Mingle will display the Delete project variable confirmation page

Delete project variable confirmation page

Review the confirmation message, and if you want to continue click on the Continue to delete link to permanently delete the project variable.

The effects of deleting a project variable...

Card properties using the project variable
  • There is no direct impact on card properties which are associated with the project variable.
Card transitions
  • Any card transitions which assign the project variable to a card 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 project variable 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 project variable.

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

Simply type in the name of the project variable e.g. "some project variable" and hit the Search

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

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