ServiceNow : Configuration de l'intégration avec les Histoires XOps

Pour créer des champs personnalisés :

1. Connectez-vous à la plateforme ServiceNow.
2. Ouvrir n'importe quel incident.
3. Depuis la bannière supérieure, cliquez avec le bouton droit et naviguez vers Configurer > Constructeur de formulaire.
4. Si nécessaire, acceptez d'essayer le constructeur de formulaire et sélectionnez la vue par défaut.
5. Cliquez sur Ajouter un nouveau champ dans la Table des incidents.

6. Ajoutez ces champs :

   • ID de compte CMA

     • Type : Entier
     • Propriétés : Lecture seule, Obligatoire, Actif

   • ID d'histoire CMA

     • Type : Chaîne
     • Propriétés : Lecture seule, Obligatoire, Actif

Pour créer une propriété du système sécurisée :

1. Accédez à https://<your instance>.service-now.com/sys_properties_list.do
2. Cliquez sur Nouveau.

3. Dans le formulaire Nouveau record de propriétés système, ajoutez ces détails :

   
   • Nom : cma_prod_api_key
   • Type : Mot de passe2
   • Valeur : La clé API de service que vous avez créée à l'étape 2
4. Cliquez sur Soumettre.

Pour créer un message REST :

1. Dans votre plateforme ServiceNow, naviguez vers Tous > Services Web système > Sortant > Message REST.
2. Cliquez sur Nouveau.

3. Dans le formulaire Message REST, ajoutez ces détails :

   • Nom : Ajoutez un nom pour le message REST
   • Point de terminaison : https://<your Cato account name>.cc.catonetworks.com/api/v1/graphql2
   • Type d'authentification : Pas d'authentification

   • Méthodes HTTP : Cliquez sur Nouveau et ajoutez ces détails :

     • Nom : Ajoutez un nom
     • Méthode HTTP : POST
     • Point de terminaison : https://<your Cato account name>.cc.catonetworks.com/api/v1/graphql2
4. Cliquez sur Soumettre.

Pour créer une règle métier :

1. Dans votre plateforme ServiceNow, naviguez vers Tous > Définitions système > Règle métier.
2. Cliquez sur Nouveau.

3. Dans le formulaire Nouvelle record de règle métier, ajoutez ces détails :

   
   • Nom : Ajoutez un nom pour la règle métier
   • Table : Incident
   • Quand : Après
   • Mettre à jour : Vrai (Cochez la case)
   • Condition de filtre : Changements de commentaires

4. Dans l'onglet Avancé, ajoutez ce script :

   (function executeRule(current, previous) {
     try {
       var lastComment = current.comments.getJournalEntry(1) || '';
       lastComment = stripJournalHeader(lastComment);
       if (!lastComment) {
         gs.info("Webhook GraphQL : Commentaire vide, ignorer " + current.number);
         return;
       }
       var accountId = current.u_cma_account_id;
       var storyId = current.u_cma_story_id;
           gs.info("Webhook GraphQL : accountId " + accountId + " histoire " + storyId);
       if (!accountId || !storyId) {
         gs.error("Webhook GraphQL : Identifiant de compte/de récit manquant pour " + current.number);
         return;
       }
       var gqlQuery = "mutation CreateStoryComment($accountId: ID!, $input: AddStoryCommentInput!) {" +
         "  xdr(accountId: $accountId) {" +
         "    addStoryComment(input: $input) {" +
         "      comment { id type __typename }" +
         "      __typename" +
         "    }" +
         "    __typename" +
         "  }" +
         "}";
       var body = {
         query: gqlQuery,
         variables: {
           accountId: accountId.toString(),
           input: {
             type: "USER",
             storyId: storyId.toString(),
             text: lastComment
           }
         }
       };
           var apiKey = gs.getProperty('cma_prod_api_key');
       var r = new sn_ws.RESTMessageV2('Mettre à jour les commentaires de l'histoire XDR CMA Prod', 'post');
       r.setRequestHeader('Content-Type', 'application/json');
       r.setRequestHeader('Accept', 'application/json');
           r.setRequestHeader('x-api-key', apiKey);
       r.setRequestBody(JSON.stringify(body));
       //var response = r.execute(); // peut être changé en Async - seulement à des fins de débogage
           var eccSysId = r.executeAsync();
       gs.info("Webhook GraphQL en file d'attente, ECC sys_id=" + eccSysId);
       var status = response.getStatusCode();
       var responseBody = response.getBody();
     // Journalisation sécurisée (voir la section suivante pour le masquage)
        gs.info("Webhook GraphQL : statut=" + status);
        gs.info("Webhook GraphQL : responseBody=" + responseBody);
     } catch (ex) {
       gs.info("Webhook GraphQL : Échec : " + ex.message);
     }
     function stripJournalHeader(text) {
       text = text || '';
       if (text.indexOf('\n') > -1) {
         return text.split('\n').slice(1).join('\n').trim();
       }
       return text.trim();
     }
   })(current, previous);

5. Cliquez sur Soumettre.