Consulte los conectores compatibles para la integración de aplicaciones.

Desencadenador de ServiceNow

El disparador de ServiceNow es un disparador de evento de conector que le permite invocar una integración basada en los eventos de ServiceNow personalizados que haya definido en su regla de negocio de instancia de ServiceNow.

Antes de empezar

Si planea crear o configurar una nueva conexión para el activador ServiceNow , asegúrese de tener el siguiente rol de IAM en el proyecto:

• Administrador del conector ( roles/connectors.admin )

Para obtener información sobre cómo otorgar roles, consulte Administrar acceso .

Otorgue los siguientes roles de IAM a la cuenta de servicio que desea utilizar para el activador ServiceNow :

• Invocador de integración de aplicaciones ( roles/integrations.integrationInvoker )

Para obtener información sobre cómo otorgar roles a una cuenta de servicio, consulte Administrar el acceso a cuentas de servicio .

Agregar el disparador ServiceNow

Para agregar un activador de ServiceNow a su integración, realice los siguientes pasos:

1. En el Google Cloud consola, vaya a la página Integración de aplicaciones .

   Ir a Integración de aplicaciones

2. En el menú de navegación, haga clic en Integraciones

   Aparece la página Lista de integraciones que enumera todas las integraciones disponibles en el proyecto de Google Cloud.

3. Seleccione una integración existente o haga clic en Crear integración para crear una nueva.

   Si está creando una nueva integración:

   1. Introduzca un nombre y una descripción en el panel Crear integración .
   2. Seleccione una región para la integración.
   3. Seleccione una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel info Resumen de la integración" en la barra de herramientas de integración.
   4. Haga clic en Crear .

   La integración recién creada se abre en el editor de integraciones .

4. En la barra de navegación del editor de integración , haga clic en Desencadenadores para ver la lista de desencadenadores disponibles.
5. Haga clic y coloque el elemento activador de ServiceNow en el editor de integración.

Para configurar el disparador de ServiceNow , puede utilizar una conexión de ServiceNow existente disponible en Conectores de integración o crear una nueva conexión de ServiceNow utilizando la opción de creación de conexión en línea.

Configurar el disparador de ServiceNow usando una conexión existente

Puede configurar el disparador de ServiceNow usando una conexión de ServiceNow existente en los Conectores de Integración. Tenga en cuenta que el disparador de ServiceNow es un disparador de evento del conector ; por lo tanto, solo puede usar una conexión de ServiceNow con la suscripción a eventos habilitada para configurarlo.

Para obtener información sobre cómo configurar un disparador de ServiceNow usando una nueva conexión de ServiceNow, consulte Configurar un disparador de ServiceNow usando una nueva conexión.

Para configurar un activador de ServiceNow utilizando una conexión de ServiceNow existente, realice los siguientes pasos:

1. Haga clic en el elemento activador de ServiceNow en el editor de integración para abrir el panel de configuración del activador.
2. Haga clic en Configurar disparador .
3. Proporcione los siguientes detalles de configuración en la página Editor de activadores de eventos del conector :
   1. Región: seleccione la región de su conexión ServiceNow.
   2. Conexión: seleccione la conexión de ServiceNow que desea utilizar.

      La integración de aplicaciones solo muestra aquellas conexiones de ServiceNow que están activas y tienen una suscripción a eventos habilitada.

   3. Tipo de suscripción a eventos: Introduzca el tipo de evento que desea usar para activar la integración. Estos tipos de eventos deben estar definidos en la regla de negocio de su instancia de ServiceNow.
   4. Cuenta de servicio : seleccione una cuenta de servicio con los roles de IAM necesarios para el activador de ServiceNow.
4. Haga clic en Listo para completar la configuración del disparador y cerrar la página.

Configurar el disparador de ServiceNow usando una nueva conexión

Para configurar el activador de ServiceNow mediante una nueva conexión de ServiceNow, realice los siguientes pasos:

1. Haga clic en el elemento activador de ServiceNow en el editor de integración para abrir el panel de configuración del activador.
2. Haga clic en Configurar disparador .
3. Omitir el campo Región .
4. Haga clic en Conexión y seleccione la opción Crear conexión en el menú desplegable.
5. Complete los siguientes pasos en el panel Crear conexión :
   1. En el paso Ubicación , elija la ubicación para la nueva conexión de ServiceNow:
      1. Región: seleccione una región de la lista desplegable.
      2. Haga clic en Siguiente .
   2. En el paso Detalles de conexión , proporcione detalles sobre la nueva conexión de ServiceNow:
      1. Versión del conector: elija una versión disponible del conector ServiceNow de la lista desplegable.
      2. Nombre de la conexión: ingrese un nombre para la conexión de ServiceNow.
      3. (Opcional) Descripción: Ingrese una descripción para la conexión.
      4. (Opcional) Habilitar registro en la nube: seleccione esta casilla de verificación para almacenar todos los datos de registro de la conexión.
      5. Cuenta de servicio : seleccione una cuenta de servicio con los roles de IAM necesarios para la conexión de ServiceNow.
      6. Habilitar suscripción a eventos: Seleccione esta opción para crear y habilitar una nueva suscripción a eventos para la conexión de ServiceNow. Puede habilitar solo suscripciones a eventos o también incluir entidades de conexión, operaciones y acciones .
      7. Incluir tablas del sistema: seleccione para informar o incluir tablas del sistema en la conexión.
      8. (Opcional) Filtrar tablas: Ingrese la lista de tablas del sistema (que comienzan con " sys_ ", separadas por comas) que desea incluir.
      9. (Opcional) Expanda Configuración avanzada para configurar los ajustes del nodo de conexión.

         Para obtener más información sobre la configuración del nodo de conexión para ServiceNow, consulte la documentación de conexión de ServiceNow .

      10. (Opcional) Haga clic en + Agregar etiqueta para agregar una etiqueta a la conexión en forma de par clave-valor.
      11. Haga clic en Siguiente .
   3. En el paso Destinos , proporcione los detalles de la instancia de ServiceNow:
      1. Tipo de destino: seleccione la dirección de host .
      2. Host: ingrese el nombre de host o la dirección IP de su instancia de ServiceNow.
      3. Haga clic en Siguiente .
   4. En el paso de Autenticación , proporcione los detalles de autenticación para la instancia de ServiceNow:
      1. Nombre de usuario: Ingrese el nombre de usuario para acceder a la dirección de destino proporcionada.
      2. Contraseña: seleccione el secreto de Secret Manager que contiene la contraseña asociada con el nombre de usuario de ServiceNow.
      3. Versión secreta: seleccione una versión secreta.

      Para saber más sobre cómo configurar la autenticación, consulte Configurar la autenticación .

      4. Haga clic en Siguiente .
   5. En el paso Detalles de suscripción al evento , proporcione los detalles de autenticación que se utilizarán para validar la carga útil del token de ServiceNow:
      1. Token de autenticación: (opcional) Seleccione el secreto de Secret Manager de su token de autenticación y la versión secreta correspondiente en el menú desplegable Versión secreta .
      2. Algoritmo HMAC: (opcional) Seleccione el algoritmo HMAC para cifrar la carga útil de respuesta.
      3. Clave secreta HMAC: si ha seleccionado un algoritmo HMAC , seleccione el secreto del administrador de secretos de la clave HMAC y la versión secreta correspondiente en el menú desplegable Versión secreta .
      4. Haga clic en Siguiente .
   6. Revisar : revise los detalles de conexión de ServiceNow proporcionados.
   7. Haga clic en Crear para completar la creación de una nueva conexión de ServiceNow.
6. Una vez creada la conexión de ServiceNow, debe ir a su instancia de ServiceNow y crear manualmente una regla de negocio.
7. Tipo de suscripción a eventos: Introduzca el tipo de evento que desea usar para activar la integración. Estos tipos de eventos deben estar definidos en la regla de negocio de su instancia de ServiceNow.
8. Haga clic en Listo y cierre la página.

Crear una regla de negocio

Una regla de negocio de ServiceNow es una lógica del lado del servidor que se ejecuta cuando se consulta, actualiza, inserta o elimina un registro de base de datos en su instancia de ServiceNow. La integración de aplicaciones utiliza estas reglas de negocio para identificar y escuchar los eventos que activan una integración.

Para obtener información sobre cómo crear una regla de negocio, consulte la documentación de ServiceNow .

La siguiente imagen muestra un ejemplo de regla de negocio de ServiceNow con el tipo de evento update_ticket :

Salida del disparador

El disparador de ServiceNow tarda un par de minutos en completar la configuración de la suscripción a eventos. Puede ver el estado de su suscripción a eventos en el panel de configuración del disparador, en "Detalles de la suscripción a eventos" .

El disparador ServiceNow indica el estado de una suscripción a eventos mediante los siguientes estados:

• restart_alt Creating : Indica que el disparador se está suscribiendo a la suscripción de eventos.
• check_circle Active : indica que el disparador se suscribió correctamente a una suscripción de evento.
• error Error : Indica que hay un problema con la suscripción al evento configurada.

Además del estado de suscripción al evento, la sección Detalles de suscripción al evento también muestra otros detalles como la región de conexión, el nombre de la conexión, el nombre de la suscripción al evento y más.

La siguiente imagen muestra un ejemplo de diseño del panel de configuración del activador de ServiceNow:

Variable de salida del disparador

Para cada evento, el disparador de ServiceNow genera una variable de salida ConnectorEventPayload que puede usar en las tareas posteriores. Esta variable de salida está en formato JSON y contiene el esquema de carga útil de salida de ServiceNow.

Ver suscripciones a eventos

Para ver y administrar todas las suscripciones a eventos asociadas con una conexión en Conectores de integración, haga lo siguiente:

1. Vaya a la página Conectores de integración > Conexiones .

   Ir a la página de Conexiones

2. Haga clic en la conexión cuyas suscripciones desea ver.
3. Haga clic en la pestaña Suscripciones a eventos .

   Aquí se muestran todas las suscripciones a eventos para la conexión.

Editar el disparador de ServiceNow

Puede editar un activador de ServiceNow para cambiar o actualizar la configuración de la conexión y los detalles de suscripción a eventos.

Para editar un disparador de ServiceNow, realice los siguientes pasos:

1. Haga clic en el elemento activador de ServiceNow en el editor de integración para abrir el panel de configuración del activador.
2. Haga clic en Configurar el disparador de ServiceNow .
3. Haga lo siguiente en la página Editor de activadores de eventos del conector :
   1. Para conservar la suscripción al evento configurada previamente, haga clic en Conservar ; de lo contrario, haga clic en Eliminar .
   2. Actualice la configuración de la conexión y los detalles de suscripción a eventos según lo desee.
   3. Haga clic en Listo .

Puede ver los detalles actualizados de la conexión y la suscripción a eventos en el panel de configuración del disparador en Detalles de suscripción a eventos .

Cuotas y límites

Para obtener información sobre cuotas y límites, consulte Cuotas y límites .

¿Qué sigue?

• Obtenga más información sobre todas las tareas y desencadenantes .
• Aprenda a probar y publicar una integración .
• Obtenga información sobre el manejo de errores .
• Obtenga información sobre los registros de ejecución de integración .