Accessing Allegro UI
This section presents an overview of the various components of the Aria Allegro UI.
Logging in to Allegro UI
The Allegro UI uses the same Key Cloak service as the Aria Admin UI and Aria Customer Care Portal (CCP) UI. Key Cloak acts as an interface for OAuth 2.0 authentication and supports Single Sign-On (SSO) with an identity manager service.
There are two login scenarios:
- Active session: If you already have an active session in Aria Admin UI or Aria CCP UI and you access Allegro UI from a link within those applications, Allegro UI recognizes your session and does not require you to log in again.
- New session: If your session has ended or you are logging in to Allegro UI directly, you will see the same login screen used by Aria Admin UI and Aria CCP UI. Enter your credentials to access Allegro UI.
How Allegro UI controls access levels
Allegro UI uses the existing Aria framework to manage user access and does not require a separate set of roles or user management processes. Access control works as follows:
- Allegro maintains a table of all Allegro permissions, which is updated with each release as new capabilities are added.
- A static configuration maps the relevant Aria Admin UI permissions to the corresponding Allegro permissions.
- You create roles in Aria Admin UI using the same process you use today.
- You add new users using the same existing framework in Aria Admin UI.
- For new sessions, Allegro UI directs users to the same login screen used by Aria Admin UI or the SSO login configured for the deployment.
- For active sessions, Allegro UI receives a token from existing services and uses it to grant access, including the session timeout parameter.
The following core Allegro APIs support access management in Allegro UI:
- getCurrentUser: Allegro UI calls the Allegro core API, which calls the core Aria API to retrieve the current user.
- getUiAccountPrivileges: Allegro UI calls the Allegro core API, which calls the core Aria API to retrieve the current user's privileges, overlays the static permission mapping, and manages access accordingly.
- getUiProductCatalogPrivileges: Allegro UI calls the Allegro core API, which calls the core Aria API to retrieve the current user's product catalog privileges, overlays the static permission mapping, and manages access accordingly.
Accessing Allegro Topics
- Navigation Pane
- This article provides an overview of the navigation pane in the Allegro UI, detailing how it allows users to navigate through various menu options, with sub-menus automatically expanding upon selection.
- Activity Pane
- This article explains that the Allegro Activity Pane is the primary workspace where users perform all activities in the UI. It notes that this pane consists of several UI sections, including header links and multiple optional tabs.
- Client Selection
- This article explains how client selection works in the Allegro UI. Allegro and core Aria deployments may not have a 1:1 client mapping due to high-volume clients with their own Allegro deployment.
- Header Links
- This article explains that header links in the Allegro UI display your current navigation path, with each segment representing a step such as menu, sub-menu, and active tab. Each segment is clickable, allowing you to quickly return to the corresponding section in the interface.
- Tabs
- This article explains that Allegro’s multiple tabs are optional UI elements that appear only in certain sections when additional tabs are available, allowing users to navigate between them as needed. It notes that the active tab is visually indicated by an Aria blue underline so users can easily see which tab is selected.
- Usage—Account Switch
- This article explains that the Allegro UI includes an account switch control that lets users toggle between usage management and account views, with the selected mode highlighted in Aria blue. As users change the switch, the options shown in the navigation pane update to match the selected view, provided they have the necessary permissions.
- Home Page
- This article explains that Allegro has separate home pages depending on whether the Usage or Account switch is selected, with the Home menu option indicating which one is active. When the Account switch is selected, Home opens the account search page, and when the Usage switch is selected, Home opens the Usage Data and Master Usage Data tab, always returning you to the current switch’s home page.
- Drawer vs. Expand Activity Pane
- This article explains that in Allegro UI, an activity pane can either expand in place or open a right-hand drawer to support different ways of performing tasks. It highlights single and multi-level drawers, sub-table expansions, and combinations of expanded sections with drawers to balance usability for specific functional components.
- Search Options
- This article explains that in the Allegro UI you can toggle between CCP search and multi-attribute search via the System Properties > UI Defaults configuration by setting the “Multi search enabled” Boolean to true or false. When disabled (false), CCP search provides a single-filter style search, and when enabled (true), multi-attribute search allows entering multiple filter attributes with Search and Clear options to refine or reset results.
- Pagination with Multi-Attribute Search
- This article explains how Allegro’s multi-attribute search displays pagination controls that let users set page size and move to previous or next pages using arrow buttons. It also describes when the Previous and Next controls are automatically disabled based on whether the user is on the first page or has fewer rows than the configured page size on the last page.
- Cozy and Compact Views
- This article explains that Allegro lets administrators set a default Cozy or Compact view via system properties, which control how the UI displays tables and drawers. In Cozy view, drawers show 2 attributes per row, while Compact view shows 3 attributes per row, and users can switch styles on any screen.
- Minimizing and Maximizing the Navigation Pane
- This article explains that Allegro users can minimize or maximize the left navigation pane by clicking an icon located at the top right edge of the pane. It notes that UI screenshots illustrate how the pane appears before and after being minimized.
- Full Screen View
- This article explains that Allegro users can switch the UI to a full-screen view by clicking the full-screen icon located in the top left corner of the navigation pane. To exit full-screen mode, users can either click the icon again or press the Escape key, as illustrated in the accompanying UI screenshot.