Afficher les articles de la base de connaissances ServiceNow sur une page Adobe Experience Manager
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 API Knowledge (sn_km_api) pour utiliser les points de terminaison d’API REST Gestion des connaissances pour les articles de la base de connaissances. Pour plus d’informations, consultez API REST Gestion des connaissances.
- Définissez la règle de partage des ressources d’origine croisée (CORS) pour accéder à l’API Knowledge à partir de votre instance AEM. Pour plus d'informations, consultez Définir une règle de partage des ressources entre origines (CORS) pour accéder ServiceNow aux points de terminaison d’API à partir d’AEM.
Rôle requis : auteur AEM
Procédure
- Connectez-vous à votre instance AEM.
- Ouvrez votre page AEM en mode Édition.
- Ouvrez le navigateur de composants.
- Dans la liste Tous , sélectionnez ServiceNow.
-
Faites glisser un composant vers la position requise sur la page.
Remarque :Si les composants ne sont pas disponibles, mettez à jour votre configuration de modèle pour inclure les composants de la base de connaissances. En outre, vous devez 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 modification.
Remarque :Par défaut, les composants de connaissances en mode d’édition d’une page dans AEM ne sont pas accessibles aux utilisateurs publics, qui sont des utilisateurs AEM anonymes qui ne sont pas connectés. Pour modifier le comportement par défaut, vous devez activer la propriété Public pour chaque composant de la base de connaissances.
-
Définissez les propriétés du composant Résultats de recherche pour afficher les résultats de recherche dans la base de connaissances qui incluent une liste des articles de la base de connaissances provenant des bases de connaissances de l’instance ServiceNow .
Tableau 1. Propriétés du composant des résultats de recherche Propriété Description Public Option permettant de rendre le contenu du composant visible aux 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 contenant des articles de la base de connaissances associés. Cliquez sur Ajouter un champ et saisissez les 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 ServiceNow les composants.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 à partir de la configuration OSGi ServiceNow : les articles de la base de connaissances sont affichés dans la langue configurée dans la configuration OSGi pour ServiceNow les composants. Cette valeur est sélectionnée par défaut.
- Restreindre à la langue du portail : les articles de la base de connaissances sont affichés dans la langue configurée sur le site AEM.
- Toutes les langues : les articles de la base de connaissances sont affichés dans toutes les langues.
Paramètre de recherche Clé de paramètre pour 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 comprennent des informations telles que l’auteur, la date de dernière mise à jour de l’article et la date de la dernière consultation de l’article. Pour plusieurs entrées, séparez les champs par des virgules. Exemple :
auteur,sys_view_count,sys_updated_on,évaluationNombre de résultats de recherche Nombre maximal d’articles inclus dans la liste des résultats de recherche. Utilisez les icônes d’incrémentation ou de diminution pour augmenter ou diminuer les valeurs. Vous pouvez également entrer 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 permettant d’appliquer des 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 pour afficher une zone de recherche permettant aux utilisateurs de saisir du texte de recherche et de trouver des articles de la base de connaissances dans l’instance ServiceNow correspondant au texte de recherche.
Remarque :Le déclenchement d’une recherche à partir du composant Zone de recherche mène au composant Résultats de recherche.
Tableau 2. Propriétés du composant de la zone de recherche Propriété Description Public Option permettant de rendre le contenu du composant visible aux 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 : rechercher (minimum trois caractères)
Bases de connaissances Identificateur système (sys_id) d’une base de connaissances contenant des articles de la base de connaissances associés. Cliquez sur Ajouter un champ et saisissez les 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 ServiceNow les composants.Langue Active l’affichage 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 à partir de la configuration OSGi ServiceNow : les articles de la base de connaissances sont affichés dans la langue configurée dans la configuration OSGi pour ServiceNow les composants. Cette valeur est sélectionnée par défaut.
- Restreindre à la langue du portail : les articles de la base de connaissances sont affichés dans la langue configurée sur le site AEM.
- Toutes les langues : les articles de la base de connaissances sont affichés dans toutes les langues.
URL de 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 pour la requête de recherche. Exemple : kb_query
Suggestion automatique Option permettant d’activer la recherche par suggestion automatique. Nombre de résultats de recherche de suggestion automatique Nombre maximum d’articles à inclure dans la liste des résultats de la recherche de suggestion automatique. Utilisez les icônes d’incrémentation ou de diminution pour augmenter ou diminuer les valeurs. Vous pouvez également entrer 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 permettant d’appliquer des 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 d’article pour afficher les articles de la base de connaissances et leurs pièces jointes, le cas échéant, à partir d’une ServiceNow instance.
Tableau 3. Propriétés du composant de la vue d’article Propriété Description Public Option permettant de rendre le contenu du composant visible aux 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 d’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 comprennent des informations telles que l’auteur, la date de dernière mise à jour de l’article et la date de la dernière consultation de l’article. Pour plusieurs entrées, séparez les champs par des virgules. Exemple :
auteur,sys_view_count,sys_updated_on,évaluationParamè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 permettant d’appliquer des 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 pour afficher une liste d’articles de la base de connaissances en fonction des critères de liste.
Tableau 4. Propriétés des composants de la liste d’articles Propriété Description Public Option permettant de rendre le contenu du composant visible aux 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 apparaît 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 contenant des articles de la base de connaissances associés. Cliquez sur Ajouter un champ et saisissez les 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 ServiceNow les composants.Langue Permet l’affichage d’un article de la base de connaissances dans différentes langues lors de la consultation de l’article. Sélectionnez l'une des options suivantes :- Sélectionner à partir de la configuration OSGi ServiceNow : les articles de la base de connaissances sont affichés dans la langue configurée dans la configuration OSGi pour ServiceNow les composants. Cette valeur est sélectionnée par défaut.
- Restreindre à la langue du portail : les articles de la base de connaissances sont affichés dans la langue configurée sur le site AEM.
- Toutes les langues : les articles de la base de connaissances sont affichés 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 comprennent des informations telles que l’auteur, la date de dernière mise à jour de l’article et la date de la dernière consultation de l’article. Pour plusieurs entrées, séparez les champs par des virgules. Exemple :
auteur,sys_view_count,sys_updated_on,évaluationCritère Liste des critères pour la liste des articles de la base de connaissances. Sélectionnez l'une des options suivantes : - En vedette : liste des articles de la base de connaissances proposés en fonction des mots clés configurés dans la glide.knowman.default_keyword propriété. Pour en savoir plus sur les articles proposés, consultez Ajouter un article de la base de connaissances au contenu proposé et auxpropriétés de la base de connaissances.
- Plus consulté : liste des articles de la base de connaissances avec le plus de vues.
Nombre d'articles Nombre maximum d’articles à inclure dans la liste d’articles. Utilisez les icônes d’incrémentation ou de diminution pour augmenter ou diminuer les valeurs. Vous pouvez également entrer 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 si 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 permettant d’appliquer des styles personnalisés à ce composant. Pour plus d'informations, consultez Personnalisation des couleurs des composants ServiceNow dans AEM.