Navigate the Portal

On this page

The Self Service Portal has one top app bar and one menu. The home page is a dashboard of widgets, and a breadcrumb trail is shown above the page title. For what the portal offers and which areas you can use, see About the Self Service Portal.

The top app bar

The top app bar holds:

  • A toggle that opens the menu.
  • The logo, which takes you to the home page, with a title and subtitle.
  • A search box, on every page except the home page, while any portal module is enabled. The home page can show a search banner instead; see Search.
  • The + button for adding a ticket. It is shown when you are signed in, the portal's module for tickets is enabled, and an action for creating a ticket is available.
  • Your user area, with the notifications bell beside it; see Notifications.
  • A help button, which opens the Self Service Portal user guide in a new browser tab.

The + button (when shown), your user area, and the help button sit at the right-hand end of the bar, in that order.

Your user area

When you are signed in, your user area is a round button with your picture. Its tooltip reads Profile. Select it to open a card that shows your e-mail address, your picture, your name and, when your profile has one, your job title. The card has two buttons:

  • Profile opens your profile page.
  • Sign Out signs you out of the portal. When the portal is configured for Windows authentication, the card has no Sign Out button.

When you are not signed in, a Sign in button takes the place of your user area and opens the sign-in page.

The menu

The toggle in the top app bar opens the menu. The menu can list these items:

  • Tickets and Requests
  • My Assets
  • Knowledge Base
  • Service Catalog
  • Reserve Equipment
  • Announcements

An item appears only when its module is enabled for the portal and allowed by the portal's license. Tickets and Requests, My Assets, Service Catalog, and Reserve Equipment also require you to be signed in. Knowledge Base and Announcements appear when you are signed in, or when the portal allows visitors who are not signed in to open them.

On every page except the home page, the search box is in the top app bar, while any portal module is enabled. On the home page, search is a banner: a heading and a search box over a background image. Whether the home page shows the search banner depends on how the home page is set up. When the home page is built from the JSON template and the search box is turned off there, the background image stays but the heading and the search box are not shown. When the home page is built from the JSON template and shows the search banner, the banner scrolls up with the page only until a strip as high as the top app bar remains, and that strip stays at the top. The home page setup is described in Portal Home Page.

To search:

  1. Type your search text in the search box. To move to the search box from the keyboard, press / without Ctrl, Alt, or Cmd while the focus is not in a field or another editable control.
  2. Press Enter or select the search icon.

The portal opens the search results for your text. If the search box is empty, nothing happens.

The home page

The home page is made of widgets. Which widgets it shows, and how they are arranged, is set by the home page's template, which your administrator sets up; see Portal Home Page. A widget can be:

  • The search banner.
  • A banner for submitting a ticket.
  • A banner for requesting a service.
  • A banner for asking a question.
  • A list of your tickets and service requests.
  • A list of approval requests.
  • A list of latest updates.
  • A list of service catalog items.
  • A list of announcements.
  • A list of knowledge base articles.
  • On a home page built from the HTML template, custom content that your organization adds to the home page.

When the home page is built from the HTML template on the portal's web server, a widget whose module is not enabled for the portal is not shown, and the search banner and custom content are shown only while at least one portal module is enabled.

Banners

When you select the banner for submitting a ticket while you are not signed in, the portal takes you to the sign-in page. When you are signed in, the tickets or incidents module is enabled for the portal, and at least one action for creating a ticket is available to you, the banner opens the form for creating a ticket.

Lists

While a list loads, it shows a placeholder. A list then shows one of these instead of its items:

  • A message that you need to sign in, when you are not signed in and the list is not available to visitors who are not signed in, or when the portal refuses the list because you are not signed in.
  • A message that the widget type is not supported, when the portal does not find the list's data.
  • A message that there are no items, when the list has nothing to show.
  • An error message, when the list cannot be loaded for any other reason.

A list shows up to the number of items that the home page's template sets for it. When the template sets no number, or sets 0, a list shows up to five items, and the list of announcements up to three.

The rows of each list show:

  • Your tickets and service requests: the summary, the ID, and the creation date, behind an icon that differs for incidents and service requests.
  • Approval requests: the kind of item and its stage, its ID, the requester, and the due date when one is set.
  • Knowledge base articles: the number of views and the date the article was last modified. An article opens in the category of all articles.
  • Service catalog items: an item opens with its details shown.
  • Announcements: a high-priority announcement is marked with a colored border on its left side.
  • Latest updates: an entry opens the page of the item it is about, the same page a notification about that item opens. A service catalog item opens with its details shown.

For finding and reading articles, see Knowledge Base.

Lists for visitors who are not signed in

Only the list of announcements and the list of knowledge base articles can be shown to a visitor who is not signed in. Each of them is shown only when all of these are true:

  • The widget is set up to allow visitors who are not signed in.
  • The portal allows visitors who are not signed in to open announcements, for the list of announcements, or knowledge base articles, for the list of knowledge base articles.
  • The area's module is enabled for the portal.

In the list of knowledge base articles, a visitor who is not signed in sees the link to more articles only when the portal allows such visitors to open the whole Knowledge Base.

Notifications

When you are signed in, the notifications bell sits beside your picture in the top app bar. Its badge shows how many of your notifications are unread and updates while you work. When you have no notifications at all, the bell is unavailable.

To work with your notifications:

  1. Select the bell. The notifications panel opens with your notifications.
  2. Select a notification, not its menu, to open it. The notification is marked as read, the panel closes, and the portal opens the page of the item the notification is about, when the notification refers to an item the portal can open.

Each notification has its own menu with Mark as Read or Mark as Unread, depending on whether it is read, and an option to delete it. The menu in the panel header offers Mark All as Read and Delete All, which apply to every notification in the list. When you delete the last notification in the list, or use Delete All, the panel closes.

When you mark a notification as read or unread, mark all notifications as read, delete a notification, or delete all notifications, the list shows the change at once. If the portal cannot complete the change, the list returns to how it was before, and a message shows the error.

Emergency alerts

When an emergency alert is in effect, the portal shows its message in a red strip across the top of the page, above everything else on the page, including open dialogs. The message is shown on one line; a message that is too long for the strip is cut off. The strip is not interactive, and you cannot close it.

Above the page title, the portal shows a breadcrumb trail. The trail always starts with a Home item. The Home item is unavailable when you cannot open the home page: when you are not signed in and the portal does not allow visitors who are not signed in to open the home page, or when no portal module is enabled.

On the page of an item, the trail includes an item labeled with the caption of the item's form, which links to the item's page, and the page title is that caption too. On other pages, the page title is the page's own title.