ServiceNow: Configurando Integração com Histórias de XOps

Para criar campos personalizados:

1. Inicie sessão na plataforma ServiceNow.
2. Abra qualquer Incidente.
3. Do banner superior, clique com o botão direito do mouse e navegue até Configurar > Construtor de Formulários.
4. Se necessário, concorde em testar o Construtor de Formulários e selecione a visualização Padrão.
5. Clique em Adicionar um novo campo na Tabela de Incidentes.

6. Adicione esses campos:

   • ID da Conta CMA

     • Tipo: Inteiro
     • Propriedades: Somente Leitura, Obrigatório, Ativo

   • ID da História CMA

     • Tipo: String
     • Propriedades: Somente Leitura, Obrigatório, Ativo

Para criar uma propriedade de sistema segura:

1. Navegue para https://<sua instância>.service-now.com/sys_properties_list.do
2. Clique em Novo.

3. No formulário Nova Propriedade do Sistema, adicione estes detalhes:

   
   • Nome: cma_prod_api_key
   • Tipo: Password2
   • Valor: A chave de API de serviço que você criou no passo 2
4. Clique em Enviar.

Para criar uma mensagem REST:

1. Na sua Plataforma ServiceNow, navegue até Todos > Serviços Web do Sistema > Saídas > Mensagem REST.
2. Clique em Novo.

3. No formulário Mensagem REST, adicione estes detalhes:

   • Nome: Adicione um nome para a Mensagem REST
   • Endpoint: https://<seu nome de conta Cato>.cc.catonetworks.com/api/v1/graphql2
   • Tipo de autenticação: Sem autenticação

   • Métodos HTTP: Clique em Novo e adicione estes detalhes:

     • Nome: Adicione um nome
     • Método HTTP: POST
     • Endpoint: https://<seu nome de conta Cato>.cc.catonetworks.com/api/v1/graphql2
4. Clique em Enviar.

Para criar uma regra de negócio:

1. Na sua Plataforma ServiceNow, navegue até Todos > Definições do Sistema > Regra de Negócio.
2. Clique em Novo.

3. No formulário Nova Regra de Negócio, adicione estes detalhes:

   
   • Nome: Adicione um nome para a Regra de Negócio
   • Tabela: Incidente
   • Quando: Após
   • Atualizar: Verdadeiro (marque a caixa de seleção)
   • Condição de Filtro: Mudanças nos comentários

4. Na aba Avançado, adicione este script:

   (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. Clique em Enviar.