Widgets

The Knowledge widgets make it easier for you to use Serviceware Knowledge on mobile devices. The widgets can be included in the Serviceware Portal and also on your own website.

How to provide the widgets on your website, so that it is possible to use your knowledge content through your website, you will learn in the following paragraph.
Screenshot: Portal page with Serviceware Knowledge widget

Screenshot: Portal page with Serviceware Knowledge widget

The Knowledge widgets allow you to access the information in your Knowledge system. The functions search, filter, result lists and detailed view as well as the navigation via the tree is possible via the Knowledge widgets.

Tip: When configuring the widgets, note that it is not possible to switch views within the widgets. You can distribute information via a public view or via the logged-in users' own views.

To make the widget usable in a website, a configuration script must firstly be created, which is integrated into the HTML code of the website in the next step.

The widgets for the Serviceware Portal are configured in a similar way, but the configuration for this should nevertheless be carried out in the Serviceware Portal.

Warning: The parameters set here have no influence on the Portal widgets.

Warning: To use the widgets in Serviceware Processes you only need the API key. The configuration of the widgets has no influence on the display of the widgets in Serviceware Processes.

First, set the API Key and Use authentication parameters to generate a script to embed the widgets in your web page.

API Key: Select the API keys from the drop-down list.; The API is used to define access to specific views.
Use authentication: Active: You use single sign-on with the for the authentication.

Screenshot: Embedding the widgets into Portal

You can configure the individual widgets in the lower part of the screen. Thereby, in three tabs you have the possibility to configure, preview each widget and view the HTML code of the widgets.

Proceed as follows to configure the widgets:

Select the API Key from the drop-down list.
Choose whether you want Use authentication.
Copy the script for embedding Knowledge widgets into the HTML source code of your website.
Configure the individual widgets.
1. Set the desired parameters.
2. Check the settings in the preview.
3. Open the HTML code to check it.
4. Copy the code for the widget and paste it into the HTML source code of your website.
Save the source code of your website.

You can use the configured widgets on your website. You can embed the following widgets in your website.

Search

The Search widget allows you to search in the Serviceware Knowledge content by text input.

For more information on the behavior of the Search widget, see section Behavior of the widget Search.

Screenshot: Configuration of the search widget

The following parameters can be set additionally for the Search widget:

Automatic search

The Automatic search widget can be associated with a DOM element, then an automatic search for content can be carried out. This widget has no user interface.

For more information on the behavior of the Search widget, see section Suggestions within the widgets Search and Automatic search.

Screenshot: Configuring the automatic search widget

Numerous parameters may be set for the widget. Besides general parameters, there are specific parameters that are only applicable to individual widgets. These are linked in the corresponding sections. The tooltips give you information on the individual parameters.

General parameters contain settings for interaction with other widgets.
Dialog parameters contain settings for the way in which the widget is displayed on the Portal pages.
Display parameters contain parameters that allow the design of the individual widgets.
Navigation parameters allow customization of the navigation.

Filter

The Filter widget enables the filtering of results found via the search and further narrowing the search.

For more information on the Filter widget behavior, see section Behavior of the widget Filter.

Result lists

The Results list widget displays the results found by the search.

For more information on the behavior of the widget for displaying the results lists, see section Behavior of the widget Result lists.

Screenshot: Settings for the results list widget

Detailed view

The Detailed view widget displays the knowledge content from the search, tree or result list.

For more information on the behavior of the widget for the Details view of the content found, see section Behavior of the widget Detailed view and Display behavior of the widget Detailed view.

Screenshot: Settings for the details view widget

The following parameters can additionally be set for the behavior of the Details view widget for the automatic search:

Tree (Navigation)

You can make your knowledge content available in a hierarchical structure using the Tree widget.

For more information on the Tree widget's behavior for navigating the tree structure, see section Behavior of the widget Tree (navigation) and Display behavior of the widget Tree (navigation).