Knowledge Base

On this page

The Knowledge Base holds articles. In the Self Service Portal, you browse the articles by category, search for them, read them, and mark whether an article was helpful. Technicians work with the Knowledge Base in the Web App; see Knowledge Base. The portal's AI Assistant is described in AI Assistant.

The Knowledge Base in the Self Service Portal

Which articles you see

The Self Service Portal shows an article only when the article is public and in the Live status, and your access rights to the article are checked as well.

Browse articles by category

  1. In the menu, select Knowledge Base.
  2. In the category tree, select a category.
  3. In the list of the category's articles, select an article to open it.

The category tree begins with a category that holds all articles, placed ahead of the other categories. The tree lists any other category only when:

  • the category is public,
  • all its parent categories are public, and
  • the category, or one of its subcategories, holds an article that is filed in a public category and that passes the portal's article filter. The filter admits an article that is public, in the Live status, and either assigned to no service or assigned to one of the services available to you; see Services and SLAs.

A category shows the articles filed in it and in its public subcategories at every level. A public article that is filed only in a category that is not public cannot be reached by browsing the category tree, but you can reach it through the category that holds all articles and by a direct link.

Sort and page the article list

The sort control of the article list offers four orders:

Sort order Articles are listed
Alphabetical In alphabetical order. This is the order the list starts with.
Highest Rated Highest rating first
Most Popular Most viewed first
Newest First Most recently modified first

The list shows 10 articles per page until you choose another page size in the pager. The pager also has buttons for the first, previous, next, and last page, and shows the current page and the number of pages.

The portal remembers the sort order and the page size you choose in your browser, and uses them again in later sessions.

A change to the articles of a category can take up to a minute to appear in the category's article list.

Search for an article

  1. Type your search text in the search box. On every page except the home page, the search box is in the top bar. On the home page, use the search box of its search banner when the home page has one.
  2. Press Enter, or select the search icon.

The search results page opens. When the search box is empty, nothing happens.

The search is not limited to Knowledge Base articles. If the portal does not accept the search text, the results page shows the portal's message about it instead of a general error.

Read an article

  • To print the article, select Print. Only the article is printed, not the portal page around it.
  • A link to another place in the same article scrolls to that place. In Firefox, it does so only when the place is marked with a name; a place marked only with an id is not reached. Other links in the article open in a new browser tab, except a link for which the article sets its own target.
  • A link to another Alloy Navigator record leads to that record's page in the portal. When the portal cannot resolve the record the link points to, selecting the link shows an error alert instead of opening a page.
  • Images in an article are shown at most 300 pixels wide. Select an image to see it at full size.
  • An attachment that the article links to opens from the portal: an HTML or plain text file opens in the browser, and any other file is downloaded.
  • Localized text placeholders in the article are replaced with their localized text.

Rate an article

When voting is allowed for an article, the article page lets you mark the article as helpful or not helpful. After you vote, the page shows "Thank you for your vote:" with a thumbs icon and the date of your vote. If the vote cannot be saved, the portal shows an error message.

An article page can also open with voting already read-only. You cannot vote on the article then.

Alloy Navigator stores one rating per person for each article and keeps a vote count and an average rating for each article.

If you have not signed in

What a visitor who has not signed in can read depends on the portal's anonymous access. Anonymous access to the Knowledge Base and anonymous access to Knowledge Base articles are granted separately; see About the Self Service Portal.

  • With anonymous access to the Knowledge Base, and while the Knowledge Base module is available in the portal, the menu shows Knowledge Base, and the visitor can browse the category tree and the article lists.
  • With anonymous access to Knowledge Base articles only, a visitor who opens an article's address sees the article alone, without the category tree and the article list, and the breadcrumb item for the Knowledge Base itself is disabled.
  • A direct link to an article opens it for a visitor who has not signed in only when anonymous access to Knowledge Base articles is granted.
  • A visitor can search only when anonymous access to Knowledge Base articles or to announcements is granted.
  • The home page's list of Knowledge Base articles appears for a visitor only when the list is set up for anonymous visitors, anonymous access to Knowledge Base articles is granted, and the Knowledge Base module is enabled. Its link to more articles appears for a visitor only with anonymous access to the Knowledge Base as well.
  • A visitor can open the attachments of an article only when anonymous access to Knowledge Base articles is granted.