ServiceNow: Настройка интеграции с историями XOps

Чтобы создать пользовательские поля:

1. Войдите на платформу ServiceNow.
2. Откройте любое происшествие.
3. В верхнем баннере щелкните правой кнопкой мыши и перейдите в Настроить > Конструктор форм.
4. При необходимости согласитесь попробовать Конструктор форм и выберите вид по умолчанию.
5. Нажмите Добавить поле в таблицу происшествий.

6. Добавьте следующие поля:

   • ID аккаунта CMA

     • Тип: Integer
     • Свойства: Только для чтения, Обязательно, Активное

   • ID истории CMA

     • Тип: String
     • Свойства: Только для чтения, Обязательно, Активное

Чтобы создать защищенное системное свойство:

1. Перейдите по адресу https://<ваш экземпляр>.service-now.com/sys_properties_list.do
2. Нажмите Новый.

3. В форме Новая запись системных свойств добавьте следующие детали:

   
   • Имя: cma_prod_api_key
   • Тип: Password2
   • Значение: сервисный ключ API, который вы создали на шаге 2
4. Нажмите Отправить.

Чтобы создать REST-сообщение:

1. На платформе ServiceNow перейдите в Все>Системные веб-сервисы>Исходящие>REST-сообщения.
2. Нажмите Новый.

3. В форме REST-сообщение добавьте следующие детали:

   • Имя: добавьте имя для REST-сообщения
   • Конечная точка: https://<ваше имя аккаунта Cato>.cc.catonetworks.com/api/v1/graphql2
   • Тип аутентификации: без аутентификации

   • Методы HTTP: нажмите Новый и добавьте следующие детали:

     • Имя: добавьте имя
     • Метод HTTP: POST
     • Конечная точка: https://<ваше имя аккаунта Cato>.cc.catonetworks.com/api/v1/graphql2
4. Нажмите Отправить.

Чтобы создать бизнес-правило:

1. На платформе ServiceNow перейдите в Все>Системные определения>Бизнес-правило.
2. Нажмите Новый.

3. В форме Новая запись бизнес-правила добавьте следующие детали:

   
   • Имя: добавьте имя для бизнес-правила
   • Таблица: происшествие
   • Когда: После
   • Обновить: True (Установите флажок)
   • Условие фильтра: изменение комментариев

4. На вкладке Дополнительно добавьте этот скрипт:

   (function executeRule(current, previous) {
     try {
       var lastComment = current.comments.getJournalEntry(1) || '';
       lastComment = stripJournalHeader(lastComment);
       if (!lastComment) {
         gs.info("GraphQL webhook: Empty comment, skipping " + current.number);
         return;
       }
       var accountId = current.u_cma_account_id;
       var storyId = current.u_cma_story_id;
           gs.info("GraphQL webhook: accountId " + accountId + " story " + storyId);
       if (!accountId || !storyId) {
         gs.error("GraphQL webhook: Missing accountId/storyId for " + 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('Update XDR story comments 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(); // can be changed to Async - only for debug purposes
           var eccSysId = r.executeAsync();
       gs.info("GraphQL webhook queued, ECC sys_id=" + eccSysId);
       var status = response.getStatusCode();
       var responseBody = response.getBody();
     // Safe logging (see next section for masking)
        gs.info("GraphQL webhook: status=" + status);
        gs.info("GraphQL webhook: responseBody=" + responseBody);
     } catch (ex) {
       gs.info("GraphQL webhook: Failed: " + 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. Нажмите Отправить.