Portal Knowledge Quick Links widget instance options form

  • Release version: Washingtondc
  • Updated February 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 Form

    The Portal Knowledge Quick Links widget allows ServiceNow customers to configure how knowledge articles are displayed on portal pages. This widget enhances user access to important knowledge base articles by providing customizable options for selection, display, and behavior.

    Show full answer Show less

    Key Features

    • Knowledge Table: Default is the Knowledge [kbknowledge] table.
    • Display Articles: Options include:
      • Manually select
      • Dynamic query
      • Criteria based (Most viewed, Most useful, Featured)
    • Sort by: Field to sort articles, default is View Count.
    • Sort Order: Options are z to a or a to z, default is z to a.
    • Max Quicklinks to Display: Default is 10 articles.
    • Show Options: Toggle for displaying author, view count, last updated, and rating.
    • Article View Page: Default page for article access is Knowledge Article View (kbarticleview).

    Key Outcomes

    By configuring the Portal Knowledge Quick Links widget, customers can effectively manage how knowledge base articles are presented to users, facilitating easier navigation and access to vital information. This customization leads to improved user experience and engagement with knowledge content.

    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.