Direkt zum Hauptinhalt

Admin Info

EN | Administrator Guide for Configuring the UPPS! Extension Intelligent Navigator (IN)

Overview

Who is this documentation for?

This documentation is intended for system or project administrators responsible for configuring the UPPS! Extension Intelligent Navigator (IN).

Prerequisites

BeforeThis readingdocumentation thisassumes documentation,that you should beare familiar with the administration area of a Polarion project.

What you will learn

After reading this documentation, you will be able to configure the fields displayed in the WorkItem Preview Window of the Intelligent Navigator.Navigator for specific projects individually.

Configuration

Scope

The Intelligent Navigator can only be activated and configured by a user with acces to the , and only at the project level.

Step 1: Open the Configuration Page

To access the Intelligent Navigator configuration for a project:

  1. Open the Polarion administrationAdministration area for the relevant project.
  2. In the navigation sidebar, go to UPPS! Extensions.
  3. Select Intelligent Navigator from the menu.

image.png

Step 2: Configure the Work Item Preview Windows

Overview

Three categories of fields control what information appears in the Preview Window when you hover over a Work Item:

  • Inherent Fields — always shown, in every WorkItem preview
  • Typed Fields — shown based on the WorkItem type
  • Fallback Fields — shown when no type-specific configuration matches
Field Categories

Inherent Fields

Inherent fields are displayed in every Work Item preview regardless of any other configuration. They always appear first, before any typed or fallback fields.

These fields cannot be conditionally suppressed. They will always be visible at the top of every WorkItem preview.

Typed Fields

Typed fields are displayed based on the type of the Work Item being hovered. When the cursor rests on a WorkItem whose type matches a configured type-specific rule and satisfies the associated WorkItem query, the fields defined in that rule are displayed.

Use typed field configurations to tailor the preview for specific WorkItem types — for example, showing test-specific fields only for test cases.

Fallback Fields

Fallback fields are displayed when a Work Item does not match any type-specific configuration. If the hovered Work Item has no matching typed rule, the system searches for a fallback configuration with a matching WorkItem query and displays those fields instead.

Fallback configurations ensure that all Work Items show meaningful preview data, even if no type-specific rule applies.

WorkItem Query

The WorkItem Query field (optional) identifies which WorkItems should display the fields configured in this rule. Leave the field empty to match all Work Items of the applicable type or fallback scope.

The query field accepts any valid WorkItem query that can be built in the Polarion Query Builder.

Fields

The Field Configuration section defines which fields appear in the Work Item preview and in what order. Fields are listed in the order they will be displayed, subject to the filter's type or fallback scope and the Work Item query condition being met.

Test Steps

When enabled, the test step table of the hovered Work Item is displayed in the Work Item preview. The table is only shown if a test step table is configured for that Work Item and is available within your Polarion project.

nach oben