Portal Knowledge Quick Links widget instance options form

  • Release version: Xanadu
  • Updated August 1, 2024
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Portal Knowledge Quick Links Widget Instance Options

    The Portal Knowledge Quick Links widget allows for the configuration of knowledge article displays on portal pages. This widget provides several options for selecting and presenting articles to enhance user experience and access to information.

    Show full answer Show less

    Key Features

    • Knowledge Table: Defines the source table for articles, defaulting to Knowledge [kbknowledge].
    • Display Articles: Options include:
      • Manually select: Choose specific articles.
      • Dynamic query: Use a query to filter articles; defaults to displaying all if none is provided.
      • Criteria based: Filter articles by Most Viewed, Most Useful, or Featured criteria.
    • Sort by: Determines how articles are sorted, defaulting to View Count.
    • Sort Order: Controls the display order (z to a or a to z), defaulting to z to a.
    • Presentation Options: Includes a required title, with default text as "Article Quicklinks."
    • Behavior Options: Allows for carousel or grid view, sets max quick links (default 10), and options to show author, view count, last updated date, and rating.
    • Article View Page: Defines the page that opens when an article is accessed, defaulting to the Knowledge Article View (kbarticleview).

    Key Outcomes

    By configuring the Portal Knowledge Quick Links widget, ServiceNow customers can effectively curate and display knowledge articles that are most relevant to their users, thereby improving access to important information and enhancing overall user engagement with the knowledge base.

    The instance options enable you to configure the Portal Knowledge Quick Links widget on a portal page.

    Table 1. Data fields on the Instance form
    Instance option Description
    Knowledge Table Table from which the records shown as a card on the widget are selected.

    By default, this field is set to the Knowledge [kb_knowledge] table.
    Display Articles Displays knowledge articles from the associated knowledge base.
    The available options are:
    • Manually select: Displays knowledge articles chosen in the Manually Select Articles field.
    • Dynamic query: Displays knowledge articles that meet the condition of a query in the Knowledge [kb_knowledge] table defined in the Dynamic Query field. If no query is provided, all knowledge articles are displayed in the widget. For more information, seeGenerate an encoded query string through a filter
    • Criteria based: Displays knowledge article based on the criteria Most viewed, Most useful, and Featured. The criteria is determined by the View field in the Knowledge [kb_knowledge] table.

    The default selection is Criteria based.

    Note:
    Currently, if you select None, the selection is set to Criteria based.
    Manually Select Articles The knowledge base articles to appear on the widget that are chosen manually from a set of predefined articles associated with the portal using the knowledge base ID of the article.

    This field applies only when Manually select is selected from Display Articles.
    Dynamic Query Query to filter the records to display on the widget
    Criteria Based Displays articles on the widget based on the selected criteria.
    The available options are:
    • Most Viewed
    • Most Useful
    • Featured

    This field applies only when Criteria based is selected from Display articles.

    Note:
    Currently, if you select None, the criteria is set to Most Viewed.
    Sort by Determines the field in the Knowledge [kb_knowledge] table by which quick links are sorted and displayed on the widget.

    The default value is View Count.

    This field applies only when Manually select or Dynamic query is selected from Display articles.
    Sort Order The order in which knowledge articles appear on the widget. By default, the order is z to a
    The available options are:
    • z to a
    • a to z

    This field applies only when Manually select or Dynamic query is selected from Display articles.

    Note:
    Currently, if you select None, the order is set to z to a.
    Table 2. Presentation fields on the Instance form
    Instance option Description
    Title Required title of a Portal Knowledge Quick Links widget. The default text is Article Quicklinks.
    Table 3. Behavior fields on the Instance form
    Instance option Description
    Show Carousel Option to switch between carousel view and grid view.
    Max Quicklinks to Display Number of knowledge article quick links to appear by default on the widget.
    Note:

    The default value is 10.
    Glyph Glyph to appear on all cards chosen from a set of predefined glyphs.
    Show Author Option to display the author's name.
    Show View Count Option to display the total number of views of an article.
    Show Last Updated Option to display the date of the last changes made to an article.
    Show Rating Option to display the rating received on an article.

    The appearance of the star rating is defined by the (glide.knowman.show_star_rating) system property.
    Article View Page The article page that opens when the article card is accessed.

    By default, this field is set to the Knowledge Article View (kb_article_view) page.