Naming conventions

Introduction

Powell Teams Administrators create naming conventions in the template creation form or in the "Naming convention" in the governance section. In this section, you can modify them afterward. In the burgundy panel, go to the "Governance" section and click on "Naming convention" to open the list. 

 

The list shows all existing naming conventions in one place and gives all the necessary information to administrators. 

 

Capture d’écran 2023-07-25 165903.png

 

 

Add a new naming convention. 

Click on "Add a new naming convention" to create one. Read about how naming conventions are created and assigned to a template in Team template settings.

 

P_naming_2.png
 

Configuring the naming convention 

To identify the naming convention, give your naming convention a title. Then you can add the rules to define your convention.

 

mceclip2.png

 

"Select a rule" does have four options in the dropdown menu. 

  1. Tag's value: add a tag to the naming convention.
  2. Automatic number assignment: add a number that will be automatically incremented with every team created using the template this naming policy is assigned to.
  3. Team name: add the Team name a user filled in the Team creation form.
  4. String: add static text.
 

Tag's value 

Click into the search box to get all existing tags. The tags are sorted in alphabetical order. Choose an available tag from the list or create a new one. 

 

mceclip3.png

 

To add a tag, click on the tag you want to add. Then click "ADD." Click "CREATE" at the end of the list to create a new tag.

 

P_naminhg_3.png

 
 

Read more information regarding the type of tags, tag creation and management Manage Tags and Refiners.

 

Automatic number assignment

An Automatic number assignment rule increments a number with every team created with this template. 

 

P_naming_4.png

 
 

Team name

A user enters a "Team name in the Team creation process." This rule adds this name to the naming convention. 

 

P_naming_5.png

 

Read more in "Create a new team." 

 

String

Type a text and click "Add" to add the String to the naming convention.

 

mceclip0.png
 

Use String-Rules to add characters like "-" between different rules to achieve better readability for the name.

 

Powell Teams gives you a Preview of the configured naming convention. 

 

Example: final result where all four rules were used. In the screenshot, the first two are tags that we added. An Automatic number assignment is placed next, followed by a team name, and finally by an assigned text "MYPROJECT." When users create a team using this naming convention in a template, their Team name will correspond to the screenshot except for "Team's name" and the current number of created teams.

n9.png

To choose the order of the rules, drag and drop the options until you have configured the naming convention to be used.

 

n10.png

 

Manage existing naming conventions

Naming conventions are listed in alphabetical order. Click on the Settings Wheel icon or the Delete recycle bin icon to modify and update a naming convention. 

 

Click Delete and confirm the confirmation prompt to remove the naming convention—all templates that used the naming convention return to "None" in their naming convention setting.

 

mceclip2.png

 

P_naming_62.png

 

 

To modify the naming convention, click the settings icon. 

 

You see the title of the naming convention and the rules that have been applied to it. You can give it a different name or apply different rules. You can delete the rules that have been used or rearrange them. 

 

You see the list of templates associated with this naming convention. In those templates, this naming convention is used.  

 

To check the template, click on the title of the template. You are redirected to the template's settings. 

 

After editing your naming convention click "SAVE" to save your changes. 

 

For example, the naming convention with the title "Agile Squad" is used in one template: the "R&D Agile Squad" template. Your modifications to the naming convention are automatically active in this template.

 

mceclip4.png 

 
Update your naming conventions
 
mceclip3.png
 
The list of templates associated to your naming conventions
 


 

 

Was this article helpful?
0 out of 0 found this helpful