Afficher les articles de la base de connaissances ServiceNow sur une page Adobe Experience Manager

Rversion finale: Xanadu

Mis à jour 1 août 2024

8 minutes de lecture

Utilisez les composants de connaissances disponibles dans Adobe Experience Manager (AEM) pour accéder aux bases de connaissances de l'instance ServiceNow et afficher les articles de la base de connaissances associés sur un site Web basé sur AEM.

Avant de commencer

Activez le module d'extension Knowledge API (sn_km_api) pour utiliser les points de terminaison de l'API REST Knowledge Management pour les articles de la base de connaissances. Pour plus d'informations, consultez API REST Knowledge Management.
Définissez la règle de partage des ressources interorigines (CORS) pour accéder à Knowledge API depuis votre instance AEM. Pour plus d'informations, consultez Définir une règle de partage des ressources interorigines pour accéder aux points de terminaison de l'API ServiceNow à partir d'AEM.

Rôle requis : auteur AEM

Procédure

Connectez-vous à votre instance AEM.
Ouvrez votre page AEM en mode d'édition.
Ouvrez le navigateur de composants.
Dans la liste Tous, sélectionnez ServiceNow.
Faites glisser un composant à l'emplacement requis sur la page.

Remarque :
Si des composants ne sont pas disponibles, mettez à jour votre configuration de modèle pour inclure les composants de connaissances. Vous devez également modifier les propriétés du modèle de site et ajouter chaque composant d'article de la base de connaissances à la liste des composants autorisés.
Ouvrez la boîte de dialogue du composant pour effectuer les modifications.

Remarque :
Par défaut, les composants de connaissances en mode d'édition d'une page dans AEM ne sont pas accessibles par les utilisateurs publics, qui sont des utilisateurs AEM anonymes non connectés. Pour changer le comportement par défaut, vous devez activer la propriété Public pour chaque composant de connaissances.

Définissez les propriétés du composant Résultats de recherche de façon à afficher les résultats de recherche de connaissances qui incluent une liste d'articles de la base de connaissances dans l'instance ServiceNow.

Tableau 1. Propriétés du composant Résultats de recherche
Propriété	Description
Public	Option permettant de rendre le composant visible pour les utilisateurs publics. Lorsque cette option est sélectionnée, les articles de la base de connaissances disponibles pour les utilisateurs non authentifiés inclus dans le composant sont disponibles pour tous les utilisateurs, y compris les utilisateurs publics.
Bases de connaissances	Identificateur système (sys_id) d'une base de connaissances qui contient les articles de la base de connaissances associés. Cliquez sur Ajouter un champ et saisissez le sys_id d'une base de connaissances. Vous pouvez ajouter plusieurs entrées. Remarque : si vous n'ajoutez pas de valeur, les bases de connaissances des paramètres de configuration OSGi sont utilisées pour les composants ServiceNow.
Langue	Active l'affichage des résultats de recherche d'articles de la base de connaissances dans différentes langues. Sélectionnez l'une des options suivantes : Sélectionner dans la configuration OSGi ServiceNow : les articles de la base de connaissances s'affichent dans la langue définie dans la configuration OSGi pour les composants ServiceNow. Cette valeur est sélectionnée par défaut. Limiter à la langue du portail : les articles de la base de connaissances s'affichent dans la langue définie sur le site AEM. Toutes les langues : les articles de la base de connaissances s'affichent dans toutes les langues.
Paramètre de recherche	Clé de paramètre de la requête de recherche. Exemple : `kb_query`
Champs secondaires	Métadonnées d'un article de la base de connaissances qui s'affichent avec l'article. Les métadonnées incluent des informations telles que l'auteur, la date de la dernière mise à jour de l'article et la date de la dernière consultation de l'article. En cas d'entrées multiples, séparez les champs par des virgules. Exemple : `auteur,sys_view_count,sys_updated_on,évaluation`
Nombre de résultats de recherche	Nombre maximum d'articles inclus dans la liste des résultats de recherche. Utilisez les icônes d'augmentation ou de diminution pour augmenter ou réduire les valeurs. Vous pouvez également saisir une valeur manuellement. La valeur doit être supérieure à `1`.
URL de la page de l'article	URL relative de la page de l'article vers laquelle la redirection s'effectue. Exemple : /content/NOWApp/now_article_view.html
Classe CSS personnalisée	Classe CSS personnalisée pour l'application de styles personnalisés à ce composant. Pour plus d'informations, consultez Personnalisation des couleurs des composants ServiceNow dans AEM.

Définissez les propriétés du composant Zone de recherche de façon à afficher une zone de recherche permettant aux utilisateurs d'entrer du texte de recherche et de trouver des articles de la base de connaissances dont le texte de recherche correspond dans l'instance ServiceNow.

Remarque :

Déclencher une recherche à partir du composant Zone de recherche amène au composant Résultats de recherche.

Tableau 2. Propriétés du composant Zone de recherche
Propriété	Description
Public	Option permettant de rendre le composant visible pour les utilisateurs publics. Lorsque cette option est sélectionnée, les articles de la base de connaissances disponibles pour les utilisateurs non authentifiés inclus dans le composant sont disponibles pour tous les utilisateurs, y compris les utilisateurs publics.
Espace réservé	Texte de conseil affiché dans la zone de recherche pour fournir des informations sur ce que les utilisateurs peuvent rechercher ou sur les conditions du texte de recherche. Exemple : `recherche (trois caractères minimum)`
Bases de connaissances	Identificateur système (sys_id) d'une base de connaissances qui contient les articles de la base de connaissances associés. Cliquez sur Ajouter un champ et saisissez le sys_id d'une base de connaissances. Vous pouvez ajouter plusieurs entrées. Remarque : si vous n'ajoutez pas de valeur, les bases de connaissances des paramètres de configuration OSGi sont utilisées pour les composants ServiceNow.
Langue	Permet d'afficher des articles de la base de connaissances dans différentes langues dans la zone de recherche. Sélectionnez l'une des options suivantes : Sélectionner dans la configuration OSGi ServiceNow : les articles de la base de connaissances s'affichent dans la langue définie dans la configuration OSGi pour les composants ServiceNow. Cette valeur est sélectionnée par défaut. Limiter à la langue du portail : les articles de la base de connaissances s'affichent dans la langue définie sur le site AEM. Toutes les langues : les articles de la base de connaissances s'affichent dans toutes les langues.
URL de la page de recherche	URL relative de la page de recherche vers laquelle la redirection s'effectue. Exemple : /content/NOWApp/now_article_search.html
Paramètre de recherche	Clé de paramètre de la requête de recherche. Exemple : `kb_query`
Suggestion automatique	Option permettant d'activer la suggestion automatique.
Nombre de résultats de la suggestion automatique	Nombre maximum d'articles à inclure dans la liste des résultats de suggestion automatique. Utilisez les icônes d'augmentation ou de diminution pour augmenter ou réduire les valeurs. Vous pouvez également saisir une valeur manuellement. La valeur doit être supérieure à `1`.
URL de la page de l'article	URL relative de la page de l'article vers laquelle la redirection s'effectue. Exemple : /content/NOWApp/now_article_view.html
Classe CSS personnalisée	Classe CSS personnalisée pour l'application de styles personnalisés à ce composant. Pour plus d'informations, consultez Personnalisation des couleurs des composants ServiceNow dans AEM.

Définissez les propriétés du composant Vue de l'article de façon à afficher les articles de la base de connaissances et leurs pièces jointes, le cas échéant, à partir d'une instance ServiceNow.

Tableau 3. Propriétés du composant Vue de l'article
Propriété	Description
Public	Option permettant de rendre le composant visible pour les utilisateurs publics. Lorsque cette option est sélectionnée, les articles de la base de connaissances disponibles pour les utilisateurs non authentifiés inclus dans le composant sont disponibles pour tous les utilisateurs, y compris les utilisateurs publics.
Paramètre de l'article	Nom du paramètre de requête d'URL pour le numéro de l'article. Exemple : `kb_article`
Champs secondaires	Métadonnées d'un article de la base de connaissances qui s'affichent avec l'article. Les métadonnées incluent des informations telles que l'auteur, la date de la dernière mise à jour de l'article et la date de la dernière consultation de l'article. En cas d'entrées multiples, séparez les champs par des virgules. Exemple : `auteur,sys_view_count,sys_updated_on,évaluation`
Paramètre de langue	Nom du paramètre de requête URL contenant la langue demandée pour un article de la base de connaissances. Exemple : `kb_lang`
Classe CSS personnalisée	Classe CSS personnalisée pour l'application de styles personnalisés à ce composant. Pour plus d'informations, consultez Personnalisation des couleurs des composants ServiceNow dans AEM.

Définissez les propriétés du composant Liste d'articles de façon à afficher une liste des articles de la base de connaissances en fonction des critères de la liste.

Tableau 4. Propriétés du composant Liste d'articles
Propriété	Description
Public	Option permettant de rendre le composant visible pour les utilisateurs publics. Lorsque cette option est sélectionnée, les articles de la base de connaissances disponibles pour les utilisateurs non authentifiés inclus dans le composant sont disponibles pour tous les utilisateurs, y compris les utilisateurs publics.
Titre	Titre correspondant à la liste d'articles qui s'affiche comme en-tête du composant. Exemple : `Articles les plus consultés`
Bases de connaissances	Identificateur système (sys_id) d'une base de connaissances qui contient les articles de la base de connaissances associés. Cliquez sur Ajouter un champ et saisissez le sys_id d'une base de connaissances. Vous pouvez ajouter plusieurs entrées. Remarque : si vous n'ajoutez pas de valeur, les bases de connaissances des paramètres de configuration OSGi sont utilisées pour les composants ServiceNow.
Langue	Permet d'afficher un article de la base de connaissances dans différentes langues lorsque l'article est consulté. Sélectionnez l'une des options suivantes : Sélectionner dans la configuration OSGi ServiceNow : les articles de la base de connaissances s'affichent dans la langue définie dans la configuration OSGi pour les composants ServiceNow. Cette valeur est sélectionnée par défaut. Limiter à la langue du portail : les articles de la base de connaissances s'affichent dans la langue définie sur le site AEM. Toutes les langues : les articles de la base de connaissances s'affichent dans toutes les langues.
Champs secondaires	Métadonnées d'un article de la base de connaissances qui s'affichent avec l'article. Les métadonnées incluent des informations telles que l'auteur, la date de la dernière mise à jour de l'article et la date de la dernière consultation de l'article. En cas d'entrées multiples, séparez les champs par des virgules. Exemple : `auteur,sys_view_count,sys_updated_on,évaluation`
Critères	Liste des critères pour la liste des articles de la base de connaissances. Sélectionnez l'une des options suivantes : Présenté : liste des articles de la base de connaissances présentés en fonction des mots clés configurés dans la propriété glide.knowman.default_keyword. Pour plus d'informations sur les articles présentés, consultez Ajouter un article de la base de connaissances au contenu proposé et Propriétés de la base de connaissances. Plus consulté : liste des articles de la base de connaissances ayant le plus de vues.
Nombre d'articles	Nombre maximum d'articles à inclure dans la liste des articles. Utilisez les icônes d'augmentation ou de diminution pour augmenter ou réduire les valeurs. Vous pouvez également saisir une valeur manuellement. La valeur doit être supérieure à `1`.
URL de la page de l'article	URL relative de la page de l'article vers laquelle la redirection s'effectue. Exemple : /content/NOWApp/now_article_view.html
Masquer le composant lorsqu'il est vide	Option permettant de masquer le composant lorsqu'il n'y a aucun article de la base de connaissances à afficher.
Classe CSS personnalisée	Classe CSS personnalisée pour l'application de styles personnalisés à ce composant. Pour plus d'informations, consultez Personnalisation des couleurs des composants ServiceNow dans AEM.