Conexión a ServiceNow

Introducción

Una conexión a ServiceNow, creada utilizando el conector de ServiceNow, establece acceso a ServiceNow. Una vez que se configura una conexión, se pueden crear instancias de actividades de ServiceNow asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión a ServiceNow

Se crea una nueva conexión a ServiceNow utilizando el conector de ServiceNow desde una de estas ubicaciones:

• La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La página de Puntos finales Globales (ver Crear un punto final global en Puntos finales Globales).

Una conexión a ServiceNow existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones de componentes en Pestaña de Componentes del panel del proyecto).
• La página de Puntos finales Globales (ver Editar un punto final global en Puntos finales Globales).

Configurar una conexión de ServiceNow

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de ServiceNow se describe a continuación.

• Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de ServiceNow y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de ServiceNow, que se refiere tanto a una conexión específica como a sus actividades.

• ID de cliente: Ingrese el ID de cliente para la instancia de ServiceNow. Consulte prerrequisitos de ServiceNow para más detalles.

• Secreto de cliente: Ingrese el secreto de cliente para la instancia de ServiceNow. Consulte prerrequisitos de ServiceNow para más detalles.

• Nombre de usuario: Ingrese el nombre de usuario para la instancia de ServiceNow. Consulte prerrequisitos de ServiceNow para más detalles.

• Contraseña: Ingrese la contraseña para la instancia de ServiceNow. Consulte prerrequisitos de ServiceNow para más detalles.

• Instancia: Ingrese la URL de la instancia de ServiceNow, como https://example.service-now.com/.

• Configuraciones avanzadas: Al seleccionarlo, se muestra la tabla de Propiedades de configuraciones avanzadas, que se utiliza para agregar propiedades de configuración adicionales como pares clave-valor. Haga clic en el ícono de agregar para añadir una fila a la tabla a continuación e ingrese un par clave-valor para cada propiedad.

  Para guardar la fila, haz clic en el ícono de enviar en la columna más a la derecha.

  Para editar o eliminar una sola fila, pasa el cursor sobre la columna más a la derecha y utiliza el ícono de editar o el ícono de eliminar .

  Para eliminar todas las filas, haz clic en Limpiar Todo.

  Importante

  Los campos en la tabla de Propiedades de Configuraciones Avanzadas muestran el ícono de variable solo en modo de edición. Para que los valores de variable de estos campos se llenen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

  Los campos en la tabla de Propiedades de Configuraciones Avanzadas no admiten el uso de variables para pasar JSON sin procesar. Si tu caso de uso no admite definir JSON sin procesar en los campos directamente, escapa el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

• Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de Deshabilitar Actualización Automática del Conector.

• Guardar Cambios: Haz clic para guardar y cerrar la configuración de la conexión.

• Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Configurar conexiones OAuth

Este conector admite una conexión utilizando OAuth mediante propiedades de configuración específicas. Después de especificar la propiedad de configuración avanzada InitiateOAuth, se pueden especificar las configuraciones requeridas utilizando propiedades adicionales, como se describe a continuación.

Para este conector, se admiten dos escenarios. En cualquiera de los escenarios, necesitarás utilizar una herramienta de terceros (como Postman o una herramienta similar) para obtener el token de acceso requerido o los tokens del endpoint involucrado. Ambos escenarios funcionan solo para grupos de un solo agente. Estos son grupos de agentes que consisten en un solo agente.

• Escenario 1: Usar un token de acceso OAuth que expira después de un período de tiempo determinado.

  Con esta configuración, proporcionas un token de acceso OAuth que dura un período de tiempo establecido, según lo determinado por el endpoint particular. El conector utilizará el token para realizar la conexión. Sin embargo, la conexión ya no funcionará una vez que el token de acceso expire. Debes configurar el conector para usar el token estableciendo estas propiedades:

  Propiedad de Configuración	Valor
  InitiateOAuth	OFF
  OAuthAccessToken	Establecer al valor del token de acceso OAuth obtenido del endpoint

• Escenario 2: Usar un token de acceso OAuth combinado con un token de actualización OAuth para habilitar la actualización automática del acceso.

  Con esta configuración, el conector utilizará un token de actualización para obtener un nuevo token de acceso una vez que el token de acceso actual haya expirado. Este es generalmente el mejor método para configurar OAuth.

  Debe proporcionar un token de acceso OAuth y un token de actualización OAuth, según lo determinado por el endpoint particular. Debe configurar el conector para usar estos tokens estableciendo estas propiedades:

  Propiedad de Configuración	Valor
  InitiateOAuth	REFRESH
  OAuthAccessToken	Establecer al valor del token de acceso OAuth obtenido del endpoint
  OAuthRefreshToken	Establecer al valor del token de actualización OAuth obtenido del endpoint

Próximos pasos

Después de que se ha creado una conexión de ServiceNow, debe colocar un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Consulta: Recupera registros de ServiceNow y está destinado a ser utilizado como fuente en una operación.

• Crear: Crea nuevos registros en ServiceNow y está destinado a ser utilizado como destino en una operación.

• Actualizar: Actualiza registros existentes en ServiceNow y está destinado a ser utilizado como destino en una operación.

• Eliminar: Elimina registros existentes de ServiceNow y está destinado a ser utilizado como destino en una operación.