Modifying or deleting project variables
Navigate to the project variables page...
Steps to create a new project variable
- Sign in to Mingle as a project administrator and open the project (if you're not already working in the project).
-
Click the Project admin tab.
Mingle displays the Project settings page.
if you are logged in as a project team member, Mingle displays the Team page.
-
Click the Project variables link.
Mingle displays the Project variables page with all project variables set up for this project.
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.
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.
TODO: there probably should be a warning about the consequences of changing the data type - or is this change prevented by the UI?
available types:
- Text - any text value
- Numeric - any numeric value
- Selected from team list -
- Date -
Change the value of a project variable
Enter the new value you want to assign to the project variable, or if you chose Selected from team list then select a team member from the list.
Change which card properties are linked to the project variable...
Select any card properties where you want to offer the project variable value as an option. This will add the project variable as a selectable value in the drop list for each of the selected card properties.
Only properties which have the same data type as the project variable will be shown in the list
Save your work...
Click on the Save project variable link to save the project variable
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
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
- TODO: can't see any direct consequences?
Card transitions
- Any card transitions which assign the project variable to a card property will be deleted
Favorites and tabs
- TODO: check if users will be able to use PLV in filters - then either update or delete this section
- 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.