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
How to view in-app help¶
Every page in Spira has a link to the exact right place in our online documentation for that page. To open the help:
- Click on your user avatar from the top right of any page in the app
- Click on the "Documentation" entry from the dropdown
- This will open the correct page and place in a new tab
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
How to open a product¶
- Open the workspace dropdown from the global navigation bar
- Each workspace type has a unique icon. The icon for products is a single hexagon. They are nested inside of programs (this icon is three hexagons)
- Click on the product you want to open
- By default this will open the product home page
- But if you are changing from one product to another then the page you are on will stay the same, but for the new product
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