Configuration des paramètres d’intégration pour ServiceNow les services et les composants dans AEM

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Vous devez configurer vos services et composants ServiceNow pour les intégrer à votre instance Adobe Experience Manager (AEM).

    Paramètres permettant d'activer l'utilisation des services ServiceNow dans AEM

    Vous pouvez définir les types de paramètres de configuration suivants pour les services ServiceNow dans AEM :

    Paramètres pour l'utilisation des composants ServiceNow dans AEM

    Pour utiliser le point de terminaison Knowledge API sur votre instance AEM, vous devez définir la règle de partage des ressources interorigines (CORS) sur votre instance ServiceNow. 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.

    Définir les paramètres de la configuration OSGi pour des services ServiceNow

    Définissez les paramètres de la configuration OSGi pour les services ServiceNow utilisés par les composants ServiceNow dans Adobe Experience Manager (AEM).

    Avant de commencer

    Rôle requis : administrateur AEM

    Procédure

    1. Accédez à la console Web dans AEM avec une URL au format suivant : https://<AEM_hostname>:<AEM_port>/system/console/configMgr.
    2. Recherchez Configuration de ServiceNow.
    3. Dans la colonne Nom , cliquez sur le lien Configuration de ServiceNow.
    4. Fournit des valeurs pour les paramètres de configuration.
      Tableau 1. Paramètres de configuration de ServiceNow
      Champ Description
      URL d'instance de base URL complète de votre instance ServiceNow.
      Bases de connaissances Identificateur système (sys_id) d'une base de connaissances qui contient les articles de la base de connaissances associés. En cas d'entrées multiples, séparez les bases de connaissances par des virgules.
      Remarque :
      Une valeur vide indique les articles de toutes les bases de connaissances de votre instance ServiceNow accessibles à un utilisateur avec les autorisations appropriées.
      Afficher les articles dans toutes les langues Option permettant d'afficher les articles de la base de connaissances dans toutes les langues pour les composants ServiceNow.
    5. Cliquez sur Enregistrer.

    Configurer les paramètres des fichiers journaux pour les services ServiceNow dans Adobe Experience Manager

    Configurez les paramètres du fichier journal pour les services ServiceNow dans Adobe Experience Manager (AEM) pour générer des journaux de débogage afin d'identifier les problèmes dans le processus d'authentification.

    Avant de commencer

    Rôle requis : administrateur AEM

    Procédure

    1. Accédez à la console Web dans AEM avec une URL au format suivant : https://<AEM_hostname>:<AEM_port>/system/console/configMgr.
    2. Accédez à la OSGi > Configuration.
    3. Recherchez et sélectionnez logs/project-servicenow-components.log: info.
    4. Vérifiez les valeurs de champ par défaut ou renseignez vos propres valeurs pour personnaliser la configuration.
      Tableau 2. Paramètres de configuration de l'enregistreur
      Champ Valeur
      Niveau de journal Debug
      Fichier journal Chemin du fichier journal ServiceNow.
      Modèle de message Modèle de format de message pour le format des messages journaux.
      Enregistreur Nom de l'enregistreur pour les services de connexion ServiceNow.
      Additivité Option permettant de désactiver l'envoi de journaux à un appender attaché plus haut dans la hiérarchie.
    5. Cliquez sur Enregistrer.

    Définir une règle de partage des ressources interorigines pour accéder aux points de terminaison de l'API ServiceNow à partir d'AEM

    Définissez une règle de partage des ressources interorigines (CORS) sur votre instance ServiceNow pour accéder aux points de terminaison de l'API REST Knowledge Management, l'API de ticket ou l'API de pièce jointe CSM depuis votre instance Adobe Experience Manager (AEM).

    Avant de commencer

    Vérifiez que vous avez configuré l'API pour laquelle vous définissez la règle CORS.
    • 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.
    • Activez le module d’extension Customer Service (com.sn_customerservice) pour utiliser les points de terminaison de l’API de ticket pour les tickets de service client. Pour plus d'informations, consultez API de ticket.
    • Configurez la propriété système glide.rest.attachment_csm_api.allowed_tables et incluez la table Tickets [sn_customerservice_case] pour utiliser les points de terminaison de l’API de pièce jointe CSM pour les pièces jointes de tickets. Pour plus d'informations, consultez API de pièce jointe CSM.

    Rôle requis : web_service_admin

    Pourquoi et quand exécuter cette tâche

    Procédure

    1. Accédez à la Tout > Services web du système > Règles CORS.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du formulaire de règle CORS.
      Tableau 3. Formulaire de règle CORS
      Champ Description
      Nom Nom servant à identifier votre règle CORS.
      API REST L'API REST à laquelle s'applique cette règle CORS.
      • Pour les articles de la base de connaissances, sélectionnez API REST Knowledge Management [sn_km_api/knowledge].
      • Pour les tickets de service client, sélectionnez Ticket [sn_customerservice/case].
      • Pour les pièces jointes de tickets, sélectionnez API de pièce jointe CSM [now/attachment_csm]
      Domaine Instance AEM à laquelle s'applique cette règle CORS.
      Durée maximale Nombre de secondes pour mettre en cache la session client.
    4. Dans la liste connexe des méthodes HTTP, sélectionnez des méthodes HTTP pour envoyer une demande à un fournisseur de service Web.
      • Pour les articles de la base de connaissances, sélectionnez GET.
      • Pour les tickets de service client, sélectionnez GET, PUT, POST.
      • Pour les pièces jointes de tickets, sélectionnez GET, POST, DELETE.
    5. Pour l'API de ticket, dans le champ En-têtes exposés de la liste connexe des en-têtes HTTP, saisissez X-Total-Count.
    6. Cliquez sur Envoyer.