April 23rd, 2019 by Simon Bor
In a recent post, we highlighted new templating functionality in SpiraTest/SpiraTeam/SpiraPlan 6.0. Templates let you have multiple products (formerly known as projects) that all share the same workflow configuration, types, priorities, and more with each other. If you change the template, all the products based off of that template immediately change too. This post will explore how templates will work. A more detailed post about how to plan your migration to templates will be out soon.
Top facts about SpiraPlan's new Templates
- Each template can have many products using it. Each product only uses one template
- When existing users upgrade, every product will get its own template
- Most customizations you can make at a product level, along with a range of new customizations will be done at the template level. This includes editing artifact types, custom fields, notifications, and workflows. See the diagram below for how the main parts of administration have moved around
- A number of areas for a product are managed at the individual product level. This includes who is a member of that product, the product's components, and version control
- Product admins can be made a template admin for the template the product uses. You cannot be a template admin and not an admin of at least one of the template's products
- A template does not contain any actual data - all of that lives in your products
- You cannot, yet, move a product from one template to another
- When you create a new product you can tie it to any active template in your system
- Templates will, in 6.1, allow you to move a product to a different template. For existing users, you will then be able to consolidate your templates. This will require some planning and we will release more help about how to do this before 6.1 is released
The above rule set for templates hopefully shows how powerful they are. They should make using SpiraPlan easier and more streamlined. But it can be hard to wrap your head around them (it certainly did for a number of the Inflectra team). Let's try and explore templates in a small example.
A real world example of upgrading to 6.0
Sansa works at The North Enterprises. She is a system administrator of SpiraTeam 5.4. The North has eight products. When they upgrade to 6.0, they still have eight products. But now they also have eight templates: one for each product. The data in every product is the same as before. The priorities, types, statuses, workflows are all the same. To a normal user like Ned, SpiraTeam 6.0 works basically the same as before (just prettier and nicer).
Sansa, as the system admin, can see all the products and all the templates from the administration section of the application. Arya, a colleague of Sansa, is a product admin of product Stark. With SpiraPlan 6.0, product Stark now has its own template - template Stark. Through the upgrade process, Arya is automatically an admin for template Stark. She can go to administration for either product Stark or template Stark to make any change she wishes. For instance, she can add or remove members from product Stark via its product admin.
What if Arya wants to change the incident workflows for product Stark? These are no longer attached to the product. They are now part of template Stark. So from the admin menu she would select Incidents > Workflows, just like in 5.4, but now this menu item is on the template, not the product.
Meanwhile Sansa has been asked to create a new product - the Snow product. She creates it but does not give it its own template. Instead Sansa makes it use the same template as product Stark - template Stark. Now product Snow and product Stark use the same template. With the new product made, Sansa adds her colleague Jon as a product admin of product Snow. Jon automatically also becomes an admin of template Stark. Jon wants to fiddle with a requirement priority color for his product Snow (so that one of the priority's is black). He makes this change in template Stark. This means all requirements with that priority in both product Snow AND product Stark will now be black, because they both get this information from the template. If Arya isn't happy with this change, she can go to template Stark and change it back (or better yet take up the matter with Jon first).
