ServiceNow: Configurando Integración con Historias de XOps

Para crear campos personalizados:

1. Inicie sesión en la plataforma de ServiceNow.
2. Abra cualquier Incidente.
3. Desde el banner superior, haga clic derecho y navegue a Configurar > Constructor de Formularios.
4. Si es necesario, acepte probar el Constructor de Formularios y seleccione la vista Predeterminada.
5. Haga clic en Agregar un nuevo campo en la Tabla de Incidentes.

6. Agregue estos campos:

   • ID de Cuenta CMA

     • Tipo: Entero
     • Propiedades: Solo Lectura, Obligatorio, Activo

   • ID de la Historia CMA

     • Tipo: Cadena
     • Propiedades: Solo Lectura, Obligatorio, Activo

Para crear una propiedad de sistema segura:

1. Navegue a https://<su instancia>.service-now.com/sys_properties_list.do
2. Haga clic en Nuevo.

3. En el formulario Nuevo Registro de Propiedades del Sistema, agregue estos detalles:

   
   • Nombre: cma_prod_api_key
   • Tipo: Password2
   • Valor: La clave API de servicio que creó en el paso 2
4. Haga clic en Enviar.

Para crear un mensaje REST:

1. En su plataforma de ServiceNow, navegue a Todo > Servicios Web del Sistema > Saliente > Mensaje REST.
2. Haga clic en Nuevo.

3. En el formulario Mensaje REST, agregue estos detalles:

   • Nombre: Agregue un nombre para el mensaje REST
   • Punto final: https://<nombre de su cuenta Cato>.cc.catonetworks.com/api/v1/graphql2
   • Tipo de autenticación: Sin autenticación

   • Métodos HTTP: Haga clic en Nuevo y agregue estos detalles:

     • Nombre: Agregue un nombre
     • Método HTTP: POST
     • Punto final: https://<nombre de su cuenta Cato>.cc.catonetworks.com/api/v1/graphql2
4. Haga clic en Enviar.

Para crear una regla de negocio:

1. En su plataforma de ServiceNow, navegue a Todo > Definiciones del Sistema > Regla de Negocio.
2. Haga clic en Nuevo.

3. En el formulario Nuevo Registro de Regla de Negocio, agregue estos detalles:

   
   • Nombre: Agregue un nombre para la Regla de Negocio
   • Tabla: Incidente
   • Cuando: Después
   • Actualizar: Verdadero (marque la casilla)
   • Condición de Filtro: Cambios en comentarios

4. En la pestaña Avanzado, agregue este script:

   (function executeRule(current, previous) {
     try {
       var lastComment = current.comments.getJournalEntry(1) || '';
       lastComment = stripJournalHeader(lastComment);
       if (!lastComment) {
         gs.info("GraphQL webhook: Comentario vacío, omitiendo " + current.number);
         return;
       }
       var accountId = current.u_cma_account_id;
       var storyId = current.u_cma_story_id;
           gs.info("GraphQL webhook: accountId " + accountId + " historia " + storyId);
       if (!accountId || !storyId) {
         gs.error("GraphQL webhook: Falta accountId/storyId para " + current.number);
         return;
       }
       var gqlQuery =
         "mutación CreateStoryComment($accountId: ID!, $input: AddStoryCommentInput!) {" +
         "  xdr(accountId: $accountId) {" +
         "    addStoryComment(input: $input) {" +
         "      comentario { id tipo __typename }" +
         "      __typename" +
         "    }" +
         "    __typename" +
         "  }" +
         "}";
       var body = {
         consulta: gqlQuery,
         variables: {
           accountId: accountId.toString(),
           input: {
             tipo: "USER",
             storyId: storyId.toString(),
             texto: lastComment
           }
         }
       };
           var apiKey = gs.getProperty('cma_prod_api_key');
       var r = new sn_ws.RESTMessageV2('Actualizar comentarios de historia de 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(); // puede cambiarse a Async - solo para propósitos de depuración
           var eccSysId = r.executeAsync();
       gs.info("GraphQL webhook en cola, ECC sys_id=" + eccSysId);
       var status = response.getStatusCode();
       var responseBody = response.getBody();
     // Registro seguro (ver siguiente sección para enmascaramiento)
        gs.info("GraphQL webhook: estado=" + status);
        gs.info("GraphQL webhook: cuerpo de respuesta=" + responseBody);
     } catch (ex) {
       gs.info("GraphQL webhook: Fallido: " + 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. Haga clic en Enviar.