Moving around the application
How to use the global navigation bar
- Spira’s main global navigation is the horizontal bar at the top of the application - visible on every page
- It lets you move between all pages of the application
From left to right, it has links and dropdowns for the following:
- the My Page (shown by the application icon)
- the workspace dashboard (shown by the workspace icon - eg product, or program)
- the workspace selector
- the artifact selector
- reporting (if relevant)
- the user menu (shown by your user avatar)
- the dynamic administration menu, where relevant
What are workspaces and how to pick one
- To start getting things done in the application you need to select a workspace to explore, manage, or work on. Workspaces can be products (e.g. for a specific application) or programs (that groups a number of products together)
- Change your workspace by using the workspace selector dropdown on the global navigation bar
- Each workspace has a dedicated dashboard which provides a "one-stop shop" for understanding the overall status of the current workspace, with comprehensive, easily digestible (and customizable) information.
- Access the workspace dashboard by clicking the large workspace icon on the navigation bar
What are artifacts and how to pick one
- Artifacts are the building blocks of a product or program and contain all of their data.
- Each artifact holds different data and is used in different ways. For instance, requirements are one artifact, and releases are another. They both work differently, and are not interchangable.
- Spira has specific artifacts designed to help you do things like test, plan, track bugs and tasks, and more.
- By using the artifact selector on the global navigation bar you can see all the artifacts available to you for the current workspace.
- To learn more about each artifact, hover over the artifact name in the artifact selector to see its tooltip
- If you do not see the artifacts you expect for a particular product, it may be because of your role on the product. Discuss this with your product administrator
Using the user menu
- Clicking on your user avatar on the global navigation bar will open the user menu
- At the top there is a large user avatar next to your name. Clicking on this will open your user profile
- Other links in the user menu let you access various help: documentation for the page you are on; keyboard shortcuts; or in-app onboarding tours.
- From the user menu you can also go to your timecard (SpiraTeam or SpiraPlan only), and change your dark mode settings
Artifact list and details pages
- Each artifact has its own dedicated pages of the Spira application.
- For example, when viewing a product, you can go to the incident artifact from the artifact selector of the global navigation bar. This will take you to the incident list page.
What is an artifact list page?
- An artifact list page has a table that lists 15-500 artifacts at a time. You can, depending on the specific artifact, move things around this table, sort, or filter the table.
- On the left hand side of many list pages there are sidebars that help you navigate around the list more quickly or easily, or provide other useful information
- At the top of each list page there is a toolbar with buttons to do things like add or delete items on the list, apply or remove filters, and more
Clicking on a specific artifact from its page or elsewhere will open the artifact details page. What is an artifact details page?
- An artifact details page shows all the information about a single artifact - you can only view one at a time
- There are often different tabs on the main part of this page to help you focus on different parts of the page. For instance there maybe an attachments tab, or a test coverage tab
- On the left hand side of the detail page there will be a sidebar that helps you navigate between other relevant artifacts without having to go back to the artifact list page
- At the top of each list page there is a toolbar with buttons to do things like save any changes, email the artifact to a teammate, or create a new artifact