Display ServiceNow knowledge articles on an Adobe Experience Manager page
Use knowledge components available within Adobe Experience Manager (AEM) to access knowledge bases from the ServiceNow instance and display associated knowledge articles on an AEM-based website.
Before you begin
- Activate the Knowledge API plugin (sn_km_api) to use the Knowledge Management REST API endpoints for knowledge articles. For more information, see Knowledge Management REST API.
- Define the cross-origin resource sharing (CORS) rule to access the Knowledge API from your AEM instance. For more information, see Define a cross-origin resource sharing rule (CORS) to access ServiceNow API endpoints from AEM.
Role required: AEM author
Procedure
Log in to your AEM instance.
Open your AEM page in Edit mode.
Open the components browser.
From the All list, select ServiceNow.
Drag a component to the required position on the page.
Note: If components are not available, update your template configuration to include the knowledge components. In addition, you must modify the properties of the site template and add each knowledge article component to the list of allowed components.
Open the component dialog for editing.
Note: By default, the knowledge components in the Edit mode of a page in AEM aren't accessible by public users, which are anonymous AEM users who are not logged in. To change the default behavior, you must enable the Public property for each knowledge component.
Set the Search Results component properties to display knowledge search results that include a list of knowledge articles from the knowledge bases in the ServiceNow instance.
| Property | Description |
|---|---|
| Public | Option to make the content of the component visible to public users. When selected, the knowledge articles available to unauthenticated users included in the component are available to all users, including public users. |
| Knowledge Bases | System identifier (sys_id) of a knowledge base that contains associated knowledge articles. Click Add field and enter the sys_id of a knowledge base. You can add multiple entries. Note: If you don't add a value, knowledge bases from the OSGi configuration settings are used for ServiceNow components. |
| Language | Enables the display of knowledge article search results in different languages. Select one of the following options:
|
| Search parameter | Parameter key for the search query. Example: `kb_query` |
| Secondary fields | Metadata of a knowledge article that appear with the article. Metadata include information such as the author, the date the article was last updated, and the date the article was last viewed. For multiple entries, separate the fields by commas. Example: `author,sys_view_count,sys_updated_on,rating` |
| Search results count | Maximum number of articles included in the search results list.Use the increment or decrement icons to increase or decrease the values. You can also manually enter a value. The value must be greater than `1`. |
| Article page URL | Relative URL of the article page to redirect to. Example: `/content/NOWApp/now_article_view.html` |
| Custom CSS class | Custom CSS class for applying custom styles to this component. For more information, see [](). |
Set the Search Box component properties to display a search box for users to enter search text and find knowledge articles in the ServiceNow instance matching the search text.
Note: Triggering a search from the Search Box component leads to the Search Results component.
| Property | Description |
|---|---|
| Public | Option to make the content of the component visible to public users. When selected, the knowledge articles available to unauthenticated users included in the component are available to all users, including public users. |
| Placeholder | Hint text displayed in the search box to provide information about what users can search for or conditions for the search text. Example: `Search (minimum three characters)` |
| Knowledge Bases | System identifier (sys_id) of a knowledge base that contains associated knowledge articles. Click Add field and enter the sys_id of a knowledge base. You can add multiple entries. Note: If you don't add a value, knowledge bases from the OSGi configuration settings are used for ServiceNow components. |
| Language | Enables the display of knowledge articles in different languages in the search box. Select one of the following options:
|
| Search page URL | Relative URL of the search page to redirect to. Example: `/content/NOWApp/now_article_search.html` |
| Search parameter | Parameter key for the search query. Example: `kb_query` |
| Typeahead | Option to enable typeahead search. |
| Typeahead search results count | Maximum number of articles to include in the typeahead search results list.Use the increment or decrement icons to increase or decrease the values. You can also manually enter a value. The value must be greater than `1`. |
| Article page URL | Relative URL of the article page to redirect to. Example: `/content/NOWApp/now_article_view.html` |
| Custom CSS class | Custom CSS class for applying custom styles to this component. For more information, see [](). |
- Set the Article View component properties to display knowledge articles and their attachments, if available, from a ServiceNow instance.
| Property | Description |
|---|---|
| Public | Option to make the content of the component visible to public users. When selected, the knowledge articles available to unauthenticated users included in the component are available to all users, including public users. |
| Article parameter | Name of the URL query parameter for the article number. Example: `kb_article` |
| Secondary fields | Metadata of a knowledge article that appear with the article. Metadata include information such as the author, the date the article was last updated, and the date the article was last viewed. For multiple entries, separate the fields by commas. Example: `author,sys_view_count,sys_updated_on,rating` |
| Language parameter | Name of the URL query parameter containing the requested language for a knowledge article. Example: `kb_lang` |
| Custom CSS class | Custom CSS class for applying custom styles to this component. For more information, see [](). |
- Set the Article List component properties to display a list of knowledge articles depending on the list criteria.
| Property | Description |
|---|---|
| Public | Option to make the content of the component visible to public users. When selected, the knowledge articles available to unauthenticated users included in the component are available to all users, including public users. |
| Title | Title corresponding to the articles list that appears as the component header. Example: `Most viewed articles` |
| Knowledge Bases | System identifier (sys_id) of a knowledge base that contains associated knowledge articles. Click Add field and enter the sys_id of a knowledge base. You can add multiple entries. Note: If you don't add a value, knowledge bases from the OSGi configuration settings are used for ServiceNow components. |
| Language | Enables the display of a knowledge article in different languages when viewing the article. Select one of the following options:
|
| Secondary fields | Metadata of a knowledge article that appear with the article. Metadata include information such as the author, the date the article was last updated, and the date the article was last viewed. For multiple entries, separate the fields by commas. Example: `author,sys_view_count,sys_updated_on,rating` |
| Criteria | List of criteria for the knowledge articles list. Select one of the following options:- Featured: List of featured knowledge articles based on the keywords configured in the glide.knowman.default_keyword property. For information about featured articles, see Add a knowledge article to featured content and Knowledge properties. - Most Viewed: List of knowledge articles with the most views. |
| Article count | Maximum number of articles to include in the articles list. Use the increment or decrement icons to increase or decrease the values. You can also manually enter a value. The value must be greater than `1`. |
| Article page URL | Relative URL of the article page to redirect to. Example: `/content/NOWApp/now_article_view.html` |
| Hide component when empty | Option to hide the component when there are no knowledge articles to display. |
| Custom CSS class | Custom CSS class for applying custom styles to this component. For more information, see [](). |