Configuración del usuario final de un conector de Connector Builder personalizado en Jitterbit Integration Studio

Introducción

Después de que se publica un conector personalizado, los miembros de la organización Harmony donde se publica tienen acceso para configurar y usar el conector en proyectos de Integration Studio. Esta página describe dónde puede encontrar los conectores personalizados un usuario final y cómo usarlos.

Acceder a un conector personalizado

En un proyecto de Integration Studio, los conectores personalizados se acceden desde la paleta de componentes de diseño y aparecen igual que cualquier otro conector.

Cualquier conector de Connector Builder que hayas creado tú mismo, tanto no publicado como publicado, será accesible para ti. Aquellos creados por otros en la organización solo serán accesibles para ti si están publicados, a menos que seas un administrador de la organización Harmony.

Configurar la conexión de un conector personalizado

Un conector proporciona una interfaz para crear conexiones autenticadas, la base utilizada para generar instancias de actividades. Estas actividades, una vez configuradas, interactúan con un servicio específico a través de la conexión.

Se crea una nueva conexión personalizada utilizando el conector personalizado 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 personalizada existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño 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 del componente 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).

Los campos proporcionados para la configuración son diferentes para cada conector personalizado y dependen de cómo el creador del conector configuró el conector. A continuación se cubren los elementos comunes de la configuración de conexión.

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

• URL de autenticación: Este campo está presente si el conector personalizado fue configurado para usar autenticación básica y este campo no fue ocultado por el creador del conector. Si está presente, puede editar la URL que se probará con las credenciales ingresadas a continuación.

  Precaución

  Si edita la URL de autenticación, tenga en cuenta que el método de prueba de autenticación no es visible. Consulte con el creador del conector para asegurarse de que la nueva URL de prueba coincida con el método configurado por el creador del conector.

• URL base: Este campo está presente si no fue oculto por el creador del conector. Si está presente, puedes editar la URL base que se utiliza para todas las actividades configuradas por el usuario final. No incluyas ningún parámetro de consulta o rutas a menos que se vayan a utilizar para todas las actividades (Puedes especificar rutas y parámetros únicos durante la configuración de la actividad.).

• Credenciales: Los campos para ingresar credenciales están presentes si el conector personalizado fue configurado para usar autenticación básica. Estos incluyen campos de nombre de usuario y contraseña, cuyos etiquetas de campo corresponden a las configuradas como Nombres para mostrar durante la creación del conector.

• Encabezados de solicitud: Si el conector personalizado fue creado con encabezados de solicitud globales, están presentes campos adicionales según lo definido durante la creación del conector. Ingresa un valor o edita el valor predeterminado (si se proporciona) para el encabezado.

• Probar: Este campo está presente si el conector personalizado fue configurado para usar autenticación básica. Haz clic en este botón para verificar la conexión utilizando la configuración proporcionada.

• 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.

Actividades del conector personalizado

Después de configurar una conexión personalizada, puedes configurar una o más actividades asociadas con esa conexión para usar como fuente o destino dentro de una operación. Las actividades que están disponibles se definen durante la creación del conector.

Si la actividad puede ser utilizada como fuente o destino depende del servicio web específico y de las estructuras de solicitud y respuesta, si están presentes. Para más información sobre lo que determina si una actividad puede ser utilizada como fuente o destino, consulta Partes de una operación en Creación y configuración de operaciones.

Crear una actividad de conector personalizado

Se crea una instancia de una actividad a partir de la conexión configurada utilizando un tipo de actividad.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad existente se puede editar desde estas ubicaciones:

• El lienzo de diseño (consulta Menú de acciones de componentes en Lienzo de diseño).

• La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).

Configurar una actividad de conector personalizado

La pantalla de configuración de la actividad proporciona una serie de pasos para que un usuario configure, los cuales son diferentes para cada actividad y dependen de cómo el creador del conector configuró el conector.

El primer paso generalmente requiere que el usuario ingrese información básica como un nombre y configure los campos según lo definido durante la creación del conector:

• Nombre: Ingresa un nombre para identificar la actividad del conector personalizado. El nombre debe ser único para cada tipo de actividad asociada con la conexión y no debe contener barras inclinadas (/) ni dos puntos (:).

• Parámetros de Ruta, Parámetros de Cadena de Consulta y Encabezados de Solicitud: Si el conector personalizado fue creado con parámetros de ruta, parámetros de cadena de consulta o encabezados de solicitud para la actividad, están presentes campos adicionales según lo definido durante la creación del conector. Ingresa un valor, edita el valor predeterminado (si se proporciona) o realiza las selecciones apropiadas según lo requiera el conector específico.

• Guardar y Salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guarda hasta que hagas clic en el botón Finalizado en el último paso.

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

El segundo paso muestra cualquier esquema de datos de solicitud o respuesta que se proporcionó durante la creación del conector para la actividad específica:

• Esquema de Datos: Se muestran los esquemas de datos de solicitud y/o respuesta. Si la operación utiliza una transformación, los esquemas de datos se muestran nuevamente más adelante durante el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más.

  Nota

  Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

• Actualizar: Haz clic en el ícono de actualización o en la palabra Actualizar para regenerar esquemas desde el diseño del conector del Constructor de Conectores. Esta acción también regenera el esquema en otras ubicaciones a lo largo del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Regresar: Haz clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

• Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

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

Próximos pasos

Después de configurar la actividad de un conector personalizado, completa la configuración de la operación añadiendo y configurando otras actividades o herramientas como pasos de operación. También puedes configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que están en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Una vez que se ha creado una actividad, las acciones del menú para esa actividad son accesibles desde el panel del proyecto en las pestañas de Flujos de trabajo o Componentes, y en el lienzo de diseño. Consulta el menú de acciones de actividad para más detalles.

Los patrones de operación con los que se pueden utilizar las actividades del Constructor de Conectores personalizados dependen de si la actividad proporciona datos (como fuente) o recibe datos (como destino) en una operación, como se describe a continuación en Usado como fuente y Usado como destino.

Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.

Usado como fuente

Las actividades del Constructor de Conectores personalizados que se utilizan como fuente se pueden usar con estos patrones de operación:

• Patrón de transformación
• Patrón de archivo de dos destinos (como la primera fuente únicamente)
• Patrón de dos transformaciones (como la primera fuente únicamente)

Otros patrones no son válidos utilizando actividades de Connector Builder que se usan como fuente.

Usado como un objetivo

Las actividades personalizadas de Connector Builder que se utilizan como un objetivo se pueden usar con estos patrones de operación:

• Patrón de transformación
• Patrón de dos transformaciones (solo como el segundo objetivo)

Otros patrones no son válidos utilizando actividades de Connector Builder que se usan como un objetivo.

Usar fragmentación

Muchas API de servicios web tienen limitaciones de tamaño. Si te enfrentas a límites de registros impuestos por la API, es posible que desees usar fragmentación para dividir los datos de origen en múltiples fragmentos. La transformación se realiza entonces en cada fragmento por separado, con cada fragmento de origen produciendo un fragmento de destino. Los fragmentos de destino resultantes se combinan para producir el destino final.

Para instrucciones y mejores prácticas sobre el uso de fragmentación, consulta Opciones de operación.