Conexión ServiceNow v2 en Jitterbit Studio
Introducción
Una conexión ServiceNow v2, creada mediante el conector ServiceNow v2, establece acceso a ServiceNow. Una vez que se configura una conexión, se pueden crear instancias de actividades ServiceNow v2 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).
Importante
Antes de configurar una conexión ServiceNow v2, revisa los requisitos previos de ServiceNow v2 para asegurar que la instancia de ServiceNow se ha configurado correctamente y que tienes las credenciales necesarias para tu tipo de autenticación requerido.
Este conector también admite la política de organización Enable Re-authentication on Change. Si está habilitada, un cambio en el Nombre de usuario, ID de cliente o Instancia de ServiceNow en esta conexión requiere que los usuarios vuelvan a ingresar la Contraseña y Secreto de cliente (OAuth2.0) para la conexión.
Crear o editar una conexión ServiceNow v2
Se crea una nueva conexión ServiceNow v2 usando el conector ServiceNow v2 desde una de estas ubicaciones:
- La pestaña Project endpoints and connectors de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
- La página Global Endpoints (consulta Crear un endpoint global en Global Endpoints).
Se puede editar una conexión ServiceNow v2 existente desde estas ubicaciones:
- La pestaña Project endpoints and connectors de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
- La pestaña Components del panel del proyecto (consulta Menú de acciones de componentes en Pestaña Components del panel del proyecto).
- La página Global Endpoints (consulta Editar un endpoint global en Global Endpoints).
Configurar una conexión ServiceNow v2
A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión ServiceNow v2.
Consejo
Los campos con un icono de variable admiten el uso de variables globales, variables del proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar una lista de las variables existentes entre las que elegir.
-
Nombre de conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión ServiceNow v2 y no debe contener barras diagonales
/ni dos puntos:. Este nombre también se usa para identificar el endpoint ServiceNow v2, que se refiere tanto a una conexión específica como a sus actividades. -
Instancia de ServiceNow: Ingresa el nombre de la instancia de ServiceNow o la URL completa de la instancia. El nombre de la instancia se usa como subdominio de la URL de tu instancia (
instance_name.service-now.com) y también se encuentra en la propiedad del sistemainstance_name. Por ejemplo,dev123es el nombre de la instancia endev123.service-now.com. Si en su lugar ingresas la URL completa de la instancia, se aceptan tantohttp://comohttps://, pero la conexión siempre se realiza usandohttps. -
Autenticación: Selecciona el tipo de autenticación a usar para la instancia de ServiceNow con el usuario autenticado configurado en los requisitos previos de ServiceNow v2, ya sea OAuth2.0 (predeterminado) o Autenticación básica. Al seleccionar OAuth2.0 se habilita la configuración de ID de cliente y Secreto de cliente.
-
OAuth2.0 requiere estos campos:
-
Nombre de usuario: Ingresa el nombre de usuario asociado al usuario que se autentica.
-
Contraseña: Ingresa la contraseña asociada al usuario que se autentica.
-
ID de cliente (OAuth2.0): Ingresa el ID de cliente asociado al usuario que se autentica.
-
Secreto de cliente (OAuth2.0): Ingresa el secreto de cliente asociado al usuario que se autentica.
-
-
Autenticación básica requiere estos campos:
-
Nombre de usuario: Ingresa el nombre de usuario asociado al usuario que se autentica.
-
Contraseña: Ingresa la contraseña asociada al usuario que se autentica.
-
-
Configuración opcional: Haz clic para expandir la configuración opcional adicional:
-
Versión de API: Selecciona la versión de API de ServiceNow, una de Última (predeterminada), V1 o V2. Última siempre se enruta a la versión de API más reciente compatible con ServiceNow. Seleccionar una versión específica fuerza el uso de la versión de punto de conexión de API seleccionada, eliminando la ambigüedad de versión. Por ejemplo, si se selecciona V1, las llamadas de API harán referencia explícita a
/api/now/v1/. -
Usar configuración de proxy (solo agente privado): Al usar un agente privado, se puede seleccionar esta configuración para usar la configuración de proxy del agente privado.
-
Desactivar filtro de acceso: Selecciona esta configuración para desactivar el filtrado de lista de control de acceso y enumerar todas las tablas independientemente de los permisos del usuario que se autentica para la operación de la actividad.
-
-
Prueba: Haz clic para verificar la conexión usando la configuración especificada. Cuando se prueba la conexión, el agente o los agentes en el grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector admite suspender la descarga de la versión más reciente del conector mediante la política de organización Desactivar actualización automática de conector.
-
Guardar: Haz clic para guardar y cerrar la configuración de 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 (consulta Dependencias de componentes, eliminación y extracción). Un mensaje te pide que confirmes que deseas eliminar la conexión.
Pasos siguientes
Después de crear una conexión de ServiceNow v2, colocas 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).
Se puede acceder a las acciones de menú de una conexión y sus tipos de actividad 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 de conectores.
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 registros nuevos 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.