Skip to main content
Ctrl+K

Allegra User Manual

Getting Started

  • About this manual
  • The basic principle: items in workspaces
  • The first project
  • Structure of the user interface
  • Direct links
  • Onboarding for project managers
  • Onboarding for team members
  • Modeling your own processes
  • Configuration basics

Managing Users

  • Users, groups, and organizational units
  • Managing your user profile
  • Managing regular users
  • Managing guest users
  • Managing groups
  • System roles & user interface
  • Workspace roles and permissions
    • Adding and editing roles
    • Deleting roles
    • Restricting access to item types
    • Restricting access to item attributes
  • Managing organizational units
  • LDAP configuration
  • Authentication
    • OpenID Providers
      • Microsoft Entra ID
      • Keycloak
      • Google
      • OpenID Connect

Managing Workspaces

  • Managing workspaces
    • Creating a workspace from scratch
    • Creating a workspace by copying
    • Creating a workspace from a template
    • Assigning roles
    • Assigning accounts
    • Archiving a workspace
    • Deleting a workspace
  • Releases, sprints & backlogs
  • Workspace templates
  • Workspace types
  • Workspace type categories
  • Workspace states
  • Release states
  • Workspace-specific lists
  • Workspace-specific cockpits
  • Workspace-specific notifications

Working with Items

  • Items: what needs to be done
    • Items and workspaces
    • Item types
    • Creating an item
    • Creating an item from a template
    • Attachments
    • Rich text: mentions, checklists and reading views
    • Efforts
    • Tab permissions
  • The item browser
    • Item browser left area
    • Item browser right area
    • General behavior in the right area
    • Item context actions
    • Editing a set of items
    • Copying a set of items
    • Linking items
    • Keyboard shortcuts
    • Split view of the right-hand area
    • Adjusting the column width
    • Moving columns
    • Sorting and grouping
    • Exporting to an XML file
    • Printing
    • Creating a template-based report
  • Search
    • Search Results
    • Search Syntax
  • Filters and views
    • Finding items
    • Item browser views
    • Workspace filters
    • The Allegra Query Language (AQL)
    • Managing filters
  • Importing and exporting
    • Exporting to an Excel file
    • Importing items from Excel
    • Exporting in the Allegra format
    • Importing from Allegra installations
    • Exporting to a CSV file

Forms & Attributes

  • Managing item types
  • Standard attributes
  • Item attributes
    • Item attribute configuration
    • Item attribute types
    • Adding an item attribute
    • Overriding item attributes
    • Changing item attributes
    • Deleting item attributes
  • Forms
  • Managing item statuses
  • Managing priorities
  • Managing severities
  • Custom lists
    • Custom lists
    • Exporting custom lists
    • Importing custom lists
    • Import rules for lists

The Cockpit

  • Working with the cockpit
  • Changing the cockpit layout
  • Configuring widgets
  • Cockpit widgets
    • My items
    • My watch list
    • My filters
    • Quick search
    • Activity stream
    • Filtered item overview
    • Project overview
    • Project navigator
    • Manager list
    • Budget overview
    • Release notes
    • Calendar
    • Meetings
    • Version control activities
    • Traffic light chart
    • Average processing time
    • Milestone trend analysis
    • Status over time
    • Two-dimensional project statistics
  • Cockpit templates

Reports

  • Creating reports
  • Creating reports with MS Power BI
    • The Allegra Power BI connector
    • Data sources
  • Creating reports with JasperReports
  • Creating report templates
  • Accounting reports

Applications

  • Task management
    • Flat list
    • Tree view
    • Hierarchical view
    • Board
  • Project management
    • Project management terminology
    • Creating a new project
      • Creating a project completely from scratch
      • Creating a project by copying
      • Creating a project from a template
      • Registering team members
      • Assigning roles to team members
    • Project planning
      • Prerequisites for project planning
      • Work breakdown structure
      • Entering the work breakdown structure
      • Creating a schedule
      • Planning working time
      • Planning resources
      • The earned value method
      • Cost centers and accounts
      • Working with the Gantt chart
      • Working with the allocation view
    • Exchange with MS Project
      • Exporting a project to MS Project
      • Importing tasks from MS Project
      • MS Project import conflict resolution rules
  • Scrum
    • Scrum overview
    • Managing users
    • Managing Scrum teams
    • Managing Scrum projects
    • Managing releases
    • Working with backlogs
    • Working with sprints
    • Using the board
    • Monitoring a project with burndown charts
    • Scaled Agile Framework (SAFe)
      • Teams, programs, large solutions, and portfolios
      • Modeling dependencies
      • Overview and navigation
  • Customer portal
    • Customer portal overview
    • Example of a customer portal integration
    • Handling incoming emails
    • Conversations
    • Email filter scripts for the customer portal
    • Processing emails with JSON content
    • Email templates for the customer portal
    • Customer portal workflows
    • ITIL mapping
  • Wiki
    • Wiki overview
    • Creating documents
    • Creating document sections
    • Editing content
    • Multilingual documents
    • Embedding items
    • Embedding attributes
    • Reading and commenting on the wiki
    • Exporting documents

Filters

  • Working with filters
  • Filter repositories
  • Configuring filters
  • Sharing filters

Workflows

  • Workflows

Notifications

  • Notifications
  • Item-related notifications
    • Notification triggers
    • Notification filters
    • Notification rules
    • Automail for unregistered authors
  • Reminders
  • System-related notifications
  • Notifications from workflows
  • E-mail templates

Templates

  • Managing templates
  • Freemarker context variables for item templates
  • Excel report templates
  • JasperReports report templates
    • Report template repositories
    • Loading a report template
    • Adding JasperReport templates
    • Uploading a report template
    • Removing report templates
  • Managing text templates
  • Email templates
  • Wiki inline templates
  • Item export templates
    • Creating HTML templates
    • Creating Word templates
      • Creating Word Freemarker based templates
      • Creating Word Legacy templates
  • Cockpit templates
  • Board card templates
  • Managing base calendars
  • Workspace templates

Miscellaneous

  • Cost centers and accounts
  • Account states
  • Linking items
  • Scripts
    • Workflow activity scripts
    • Workflow guard scripts
    • General scripts
    • Parameter scripts
  • Adding event handlers
  • Tutorial videos
  • Configuration files
  • SSL and TLS encryption

Email

  • Incoming email connection
  • Outgoing email connection
  • Cleaning up e-mail content
  • Filtering reply e-mails

Server Administration

  • Server status
  • Data backup
  • Restoring data
  • Broadcasting emails to Allegra users
  • Configuring diagnostic messages
  • Directories
  • Miscellaneous settings

Global Settings

  • Configuring the login page text
  • Configuring full-text search
  • Security

Integrations

  • Managing integrations
  • Webhooks
  • GitLab CI/CD
  • MS Azure integration
  • Slack integration

Customization & License

  • Translations
  • Logos and background image
  • License data

Indices

  • General Index
  • Search

Search

Contents

  • The Search Menu
    • The Result List
    • Filtering the Results
    • Opening the Search Results
  • What Is Searched

Search#

The search field in the header finds items, documents, users, guest users and workspaces from anywhere in Allegra. While you type, a menu below the field shows the best matches. From there you open a result directly or continue to the full list of search results.

The search covers all item attributes, comments and the content of attachments. You only see results that you have permission to read.

Note

Guest users do not have a search field.

The Search Menu#

Click the search field to open the search menu. As long as the field is empty, the menu lists the objects you accessed recently, so you can return to them quickly.

../../_images/search-menu-recent.png

The search menu with recently accessed objects#

When you start typing, the menu shows the matches for your text. The list updates shortly after you stop typing.

../../_images/search-menu-results.png

The search menu with results, the filter panel and the “Go to” bar#

The menu has three areas:

  • Result list: The matches, grouped by object type. Each group shows the total number of hits in its heading, for example “Items (37)”.

  • Filter panel: Criteria on the right to narrow down the results.

  • “Go to” bar: Links at the bottom that open the search results in a tab.

To close the menu, press Esc or click outside of it. The x in the search field clears the text and the filters.

The Result List#

Each group shows only its best matches. Items and documents that you accessed recently appear first. If a group has more hits than it shows, click Show all below the group to open all of them in a search tab.

The entries show the following information:

Object type

Information shown

Item

Item number and title, and either the last modified date or “Recently accessed”

Document

Title, last modified date, and an excerpt of the text with the words found in bold. If the match is in a section, the title reads “Document title -> Section title”.

User, guest user

Picture, name and e-mail address

Workspace

Name and parent workspaces

Click an entry to open it. Items and documents open for viewing. Users, guest users and workspaces open in their navigator.

If you rest the mouse pointer on an item or document for a moment, a card with more details appears, such as the status, the responsible and the description. With the buttons on the card you copy the item title to the clipboard or share a link to the object.

../../_images/search-hovercard.png

Details card for an item in the search menu#

Filtering the Results#

With the filter panel on the right you narrow down the results without writing a search expression. A filter takes effect as soon as you select it, even if the search field is empty.

../../_images/search-menu-filter.png

The filter panel of the search menu#

  • Last modified: Limits the results to objects changed today, yesterday, last week, last month or last year. “Any time” removes this limit.

  • Filter by …: Each card filters by one attribute. Select one or more of the suggested values. Show more lets you pick any other value. The x removes the card.

  • Add criteria: Adds a card for another attribute, for example the item type, the priority or one of your own selection attributes.

  • Reset to default: Clears all filters and restores the standard cards. Your search text remains.

For items, the standard cards are workspace, responsible and status. For documents, they are workspace, document type and author.

If you select a workspace or a release, its sub-workspaces or sub-releases are included.

Note

The filters apply to items, or to documents in the Wiki. While a filter is active, the menu shows only this object type. In the Administration app the filter panel is not available.

Allegra remembers which cards you use and suggests the values you selected last.

Opening the Search Results#

The “Go to” bar at the bottom of the menu opens the results in a tab:

  • All opens the search results for all object types. Pressing Enter in the search field does the same.

  • Items, Documents and the other links open the results for this object type only.

The section Search Results describes how to work with these tabs.

What Is Searched#

The object types that the search covers depend on the app you are in:

App

Object types searched

Task management

Items, documents, guest users, users, workspaces

Project management

Items, documents, users, workspaces

Help desk

Tickets, articles, guest users, workspaces

Scrum

Items, documents

Wiki

Documents

Administration

Workspaces, users, guest users

An object type is only offered if you have access to it in this app. Archived and deleted items are not found.

For each object type, the following content is searched:

  • Items: All system attributes and your own attributes, comments, the names, descriptions and content of attachments, link comments, expenses, budgets and plans, and watchers.

  • Documents: Title and content, including attachments.

  • Users and guest users: Name, user name, e-mail address, phone number, organization and further master data.

  • Workspaces: Name, description, workspace type, status, prefix and releases.

The content of attachments is searched for common text and office formats such as PDF, Word, Excel, PowerPoint, OpenDocument, HTML, XML and plain text files.

Note

The system administrator can switch the indexing of attachments on and off, see Configuring full-text search.

A single word is usually enough to start. If you want to search for an exact phrase, restrict the search to an attribute or exclude words, see Search Syntax.

  • Search Results
  • Search Syntax

previous

Creating a template-based report

next

Search Results

Contents
  • The Search Menu
    • The Result List
    • Filtering the Results
    • Opening the Search Results
  • What Is Searched

© Copyright 2026 Alltena GmbH.

Last updated on 2026-11-20.

Creating a template-based report
Search Results
© Copyright 2026 Alltena GmbH .
Version 9.1