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

Introducción

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

Acceda a un conector personalizado

En un Integration Studio proyecto, se accede a los conectores personalizados desde la paleta de componentes de diseño y tienen el mismo aspecto que cualquier otro conector.

Podrás acceder a todos los conectores de Connector Builder que hayas creado tú mismo, tanto los publicados como los no publicados. Podrás acceder a aquellos creados por otros miembros de la organización solo si están publicados, a menos que seas un administrador de la organización de 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 extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (vea Crear un extremo global en Conexiones globales).

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

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
• La página Conexiones globales (vea Editar una conexión global en Conexiones globales).

Los campos provistos para la configuración son diferentes para cada conector personalizado y dependen de cómo el creador del conector lo haya configurado. A continuación, se describen los elementos comunes de la configuración de la 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 (/) o dos puntos (:) Este nombre también se utiliza para identificar el extremo, que hace referencia tanto a la conexión como a sus actividades.

• URL de autenticación: Este campo está presente si el conector personalizado se configuró para usar autenticación básica y el creador del conector no ocultó este campo. Si está presente, puede editar la URL con la que se realizará la prueba 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 está 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 el creador del conector no lo ocultó. Si está presente, puede editar la URL base que se utiliza para todas las actividades configuradas por el usuario final. No incluya ningún parámetro de consultar ni ruta a menos que se vayan a utilizar para todas las actividades (puede 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 se configuró para usar autenticación básica. Estos incluyen campos de nombre de usuario y contraseña, cuyas etiquetas de campo corresponden a las configuradas como Nombres para mostrar durante la creación del conector.

• Encabezados de solicitud: Si el conector personalizado se creó con encabezados de solicitud globales, se incluyen campos adicionales definidos durante la creación del conector. Ingrese un valor o edite el valor predeterminado (si se proporciona) para el encabezado.

• Prueba: Este campo está presente si el conector personalizado se configuró para utilizar autenticación básica. Haga clic en este botón para verificar la conexión utilizando la configuración proporcionada.

• Guardar cambios: Haga 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, haga clic para cerrar la configuración sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

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

Actividades de conectores personalizados

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

El uso de la actividad como origen o destino depende del servicio web específico y de las estructuras de solicitud y respuesta, si están presentes. Para obtener más información sobre qué determina si una actividad se puede utilizar como origen o destino, consulte Partes de una operación en Creación y configuración de operaciones.

Crear una actividad de conector personalizada

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, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).

• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

Configurar una actividad de conector personalizada

La pantalla de configuración de actividad proporciona una serie de pasos para que un usuario configure, que 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 definidos durante la creación del conector:

• Nombre: Ingrese 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 diagonales (/) o dos puntos (:).

• Parámetros de ruta, Parámetros de cadena de consulta y Encabezados de solicitud: Si el conector personalizado se creó con parámetros de ruta, parámetros de cadena de consultar o encabezados de solicitud para la actividad, se incluyen campos adicionales definidos durante la creación del conector. Ingrese un valor, edite el valor predeterminado (si se proporciona) o realice las selecciones correspondientes según sea necesario para el conector específico.

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

• Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guarda hasta que haga clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea 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 la solicitud o la respuesta. Si la operación utiliza una transformación, los esquemas de datos se vuelven a mostrar más adelante durante la asignación de la transformación proceso, donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

  Nota

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

• Actualizar: Haga clic en el icono de actualización o la palabra Actualizar para regenerar esquemas desde el diseño del conector de Connector Builder. 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.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

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

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar la actividad de un conector personalizado, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Una vez que se ha creado una actividad, se puede acceder a las acciones del menú para esa actividad desde el panel del proyecto, ya sea en la pestaña Flujos de trabajo o en la pestaña Componentes, y desde el tela de diseño. Consulte menú de acciones de la actividad para más detalles.

Los patrones de operación con las que se pueden usar actividades personalizadas de Connector Builder, dependiendo 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 objetivo.

Cuando esté listo, desplegar y ejecute la operación y valide el comportamiento verificando los registros de operación.

Utilizado como fuente

Las actividades de Custom Connector Builder que se utilizan como fuente se pueden utilizar con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primera fuente)
• Patrón de dos transformaciones (solo como primera fuente)

No son válidos otros patrones si se utilizan actividades de Connector Builder que se utilizan como fuente.

Utilizado como objetivo

Las actividades de Custom Connector Builder que se utilizan como destino se pueden utilizar con estos patrones de operación:

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

No son válidos otros patrones si se utilizan actividades de Connector Builder que se utilizan como objetivo.

Utilice fragmentación de datos

Muchas APIs de servicios web tienen limitaciones de tamaño. Si se encuentra con límites de registros impuestos por la API, puede utilizar la fragmentación de datos para dividir los datos de origen en varios fragmentos. Luego, la transformación se realiza en cada fragmento por separado, y cada fragmento de origen produce un fragmento de destino. Los fragmentos de destino resultantes se combinan para producir el destino final.

Para obtener instrucciones y prácticas recomendadas sobre el uso de la fragmentación de datos, consulte Opciones de operación.