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
  • Direct links

Direct links

Contents

  • Links to items and documents
  • Links to apps and views
  • Links to a selection in a navigator
  • Links to workspaces, users and configuration objects
  • Links to a search
  • Links from earlier versions
  • If a Link Cannot Be Opened

Direct links#

Every page in Allegra has its own address. The address in your browser changes when you switch to another app, select a node in a navigator or open an item. You can save an address as a bookmark, send it to a colleague or use it in another system.

All addresses start with the address of your Allegra system, followed by /app. The examples on this page show only the part after the system address. A complete address looks like this:

https://allegra.example.com/app/items/1000

Whoever opens a link sees only what their permissions allow. If you are not logged in, Allegra shows the login page first and then opens the page of the link.

Links to items and documents#

Address

Opens

/app/items/1000

The item with the number 1000. Allegra uses this form in e-mails and for copied links.

/app/items/PRJ-12

The item with the workspace-specific number PRJ-12

/app/wiki/documents/6400

The wiki document with the number 6400

After the item has opened, the address bar shows the app in which it was opened, for example /app/task-management/items/1000. Both forms lead to the same item.

If the number in a document link belongs to an item that is not a document, Allegra opens the item instead.

Links to apps and views#

The first part after /app is the app, the second part is the view:

Address

Opens

/app

The app and view you used last

/app/scrum

The Scrum app with the view you used last

/app/task-management/item-navigator

The item navigator in the Task Management app

/app/scrum/backlog-navigator

The backlog in the Scrum app

/app/wiki/wiki-navigator

The wiki navigator

/app/admin/admin-users

The user list in the administration

The apps have the following names in addresses: task-management, project-management, scrum, help-desk, alm, wiki and admin.

Links to a selection in a navigator#

If you select a node in a navigator, for example a workspace or a filter, the address contains this node. The link opens the view with the same selection.

Address

Opens

/app/task-management/item-navigator/filters/-1

The item navigator with a filter. Predefined filters have a negative number.

/app/task-management/item-navigator/workspaces/12

The item navigator with the items of a workspace

/app/task-management/item-navigator/releases/1040

The item navigator with the items of a release

/app/task-management/item-navigator/statuses/1

The item navigator with the items in a status

/app/task-management/item-navigator/baskets/1

The item navigator with the items in a personal basket

/app/task-management/taskboard-navigator/workspaces/12

The task board of a workspace

/app/project-management/gantt-navigator/workspaces/12

The Gantt chart of a workspace. Filters and releases are also possible.

/app/project-management/scheduler-navigator/persons/7

The workload view for a person. Organizational units, workspaces and releases are also possible.

/app/scrum/scrum-taskboard-navigator/releases/1040

The Scrum task board of a sprint

/app/wiki/wiki-navigator/documents/6400

The wiki navigator with a document selected. Folders, workspaces and releases are also possible.

Note

Private filters cannot be shared by a link. See Sharing filters.

Links to workspaces, users and configuration objects#

Objects that open in a tab of their own also have an address:

Address

Opens

/app/task-management/workspaces/12

A workspace

/app/wiki/releases/1040

A release

/app/admin/users/12

A user

/app/admin/guest-users/12

A guest user

/app/admin/departments/3

An organizational unit

/app/admin/workspace-templates/5

A workspace template

/app/admin/workflows/5

A workflow

/app/admin/item-screens/5

An item form

/app/admin/card-screens/5

A card template

/app/admin/mail-templates/5

An e-mail template

/app/admin/html-templates/5

An HTML template

/app/admin/dashboards/5

A cockpit template

/app/admin/ldap-connections/1

An LDAP connection

/app/admin/openid-providers/1

An OpenID provider

Links to a search#

A search tab has an address that contains the search text:

Address

Opens

/app/task-management/search?text=invoice

A search for “invoice” in all object types

/app/task-management/search/items?text=invoice

A search for “invoice” in items only

For details, see Search Results.

Links from earlier versions#

Up to version 9.0, the addresses ended in .action. These links still work, so you do not need to change bookmarks or links in other systems. Allegra forwards them to the new address:

Old address

Is forwarded to

/printItem.action?key=1000

The item

/taskmanagement.action

/app/task-management

/projectmanagement.action

/app/project-management

/scrum.action

/app/scrum

/helpdesk.action

/app/help-desk

/alm.action

/app/alm

/admin.action

/app/admin

If a Link Cannot Be Opened#

If a link points to a view or an item that does not exist, Allegra opens your default page and shows a warning. A link to an unknown type of object shows a “not found” page.

previous

Structure of the user interface

next

Onboarding for project managers

Contents
  • Links to items and documents
  • Links to apps and views
  • Links to a selection in a navigator
  • Links to workspaces, users and configuration objects
  • Links to a search
  • Links from earlier versions
  • If a Link Cannot Be Opened

© Copyright 2026 Alltena GmbH.

Last updated on 2026-11-20.

Structure of the user interface
Onboarding for project managers
© Copyright 2026 Alltena GmbH .
Version 9.1