Conexión ServiceNow (Deprecada) en Jitterbit Studio

Introducción

Una conexión de ServiceNow, creada usando el conector de ServiceNow, establece acceso a ServiceNow. Una vez que configures una conexión, puedes crear instancias de actividades de ServiceNow asociadas a esa conexión para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de ServiceNow

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

• La pestaña Endpoints del proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
• La página Endpoints globales (consulta Crear un endpoint global en Endpoints globales).

Se puede editar una conexión de ServiceNow existente desde estas ubicaciones:

• La pestaña Endpoints del proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña Componentes del panel del proyecto).
• La página Endpoints globales (consulta Editar un endpoint global en Endpoints globales).

Configurar una conexión de ServiceNow

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de ServiceNow.

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de ServiceNow y no debe contener barras / o dos puntos :. Este nombre también se usa para identificar el endpoint de ServiceNow, que se refiere a una conexión específica y sus actividades.

• ID de cliente: Ingresa el ID de cliente para la instancia de ServiceNow. Consulta Requisitos previos de ServiceNow para más detalles.

• Secreto del cliente: Ingresa el secreto del cliente para la instancia de ServiceNow. Consulta Requisitos previos de ServiceNow para más detalles.

• Nombre de usuario: Ingresa el nombre de usuario para la instancia de ServiceNow. Consulta Requisitos previos de ServiceNow para más detalles.

• Contraseña: Ingresa la contraseña para la instancia de ServiceNow. Consulta Requisitos previos de ServiceNow para más detalles.

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

• Configuraciones Avanzadas: Al seleccionar, muestra la tabla de Propiedades de Configuraciones Avanzadas, que se usa para agregar propiedades de configuración adicionales como pares clave-valor. Haz clic en el icono de agregar para añadir una fila a la tabla siguiente e ingresa un par clave-valor para cada propiedad.

  Para guardar la fila, haz clic en el icono de envío 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 usa el icono de editar o el icono de eliminar .

  Para eliminar todas las filas, haz clic en Borrar todo.

  Importante

  Los campos en la tabla de Propiedades de Configuraciones Avanzadas muestran el icono de variable solo en modo de edición. Para que los valores de variables de estos campos se completen 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 permiten usar variables para pasar JSON sin procesar. Si tu caso de uso no permite definir JSON sin procesar directamente en los campos, escapa el contenido de JSON antes de pasarlo con una variable. Por ejemplo, al escapar {"success": "true"}; se obtiene {\"success\": \"true\"};.

• Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, el agente o los agentes del grupo de agentes asociado al ambiente actual descargan la versión más reciente del conector. Este conector permite suspender la descarga de la versión más reciente del conector usando la política de organización Deshabilitar Actualización Automática del Conector.

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

• Descartar cambios: Después de hacer cambios a 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 (consulta 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 usando OAuth mediante propiedades de configuración específicas. Después de especificar la propiedad de configuración avanzada InitiateOAuth, puedes especificar la configuración requerida usando propiedades adicionales, como se describe a continuación.

Para este conector, se admiten dos escenarios. En cualquiera de los escenarios, necesitarás usar una herramienta de terceros (como Postman o una herramienta similar) para obtener el token o los tokens de acceso requeridos del endpoint involucrado. Ambos escenarios funcionan solo para grupos de agentes únicos. 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 establecido.

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

  Propiedad de Configuración	Valor
  InitiateOAuth	OFF
  OAuthAccessToken	Establece el 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.

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

  Propiedad de configuración	Valor
  InitiateOAuth	REFRESH
  OAuthAccessToken	Se establece en el valor del token de acceso OAuth obtenido del endpoint
  OAuthRefreshToken	Se establece en el valor del token de actualización OAuth obtenido del endpoint

Próximos pasos

Después de crear una conexión de ServiceNow, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se usen como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

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

Estos tipos de actividad están disponibles:

• Consulta: Recupera registros de ServiceNow y está diseñada para usarse como origen en una operación.

• Crear: Crea nuevos registros en ServiceNow y está diseñada para usarse como destino en una operación.

• Actualizar: Actualiza registros existentes en ServiceNow y está diseñada para usarse como destino en una operación.

• Eliminar: Elimina registros existentes de ServiceNow y está diseñada para usarse como destino en una operación.