Guía de inicio rápido para Jitterbit Integration Studio

Introducción

Esta guía está destinada a nuevos usuarios de Integration Studio, la aplicación de diseño de proyectos basada en la web de Jitterbit. Esta guía cubre lo básico para comenzar creando un nuevo proyecto desde cero y proporciona una visión general de los conceptos de diseño de proyectos.

Para una guía completa y un recorrido paso a paso, toma el curso de Introducción a Jitterbit Integration Studio en Jitterbit University. Como parte de este curso, también puedes consultar los tutoriales suplementarios que cubren una variedad de casos de uso para ayudarte a comenzar.

Jitterbit Marketplace también ofrece cientos de proyectos preconstruidos al proporcionar recetas de integración de Integration Studio y plantillas de procesos de Integration Studio. Para comenzar con una receta o plantilla existente, consulta Iniciando un proyecto de receta o plantilla.

Acceder a Integration Studio

Integration Studio se accede directamente a través del portal Harmony.

Desde la página de inicio del portal Harmony, haz clic en el mosaico de la aplicación Integration Studio:

Integration Studio se abre en la página de Proyectos, donde puedes crear tu primer proyecto, a continuación.

Crear un proyecto

La página de Proyectos muestra un repositorio de proyectos de Integration Studio accesibles. La primera vez que accedes a Integration Studio, esta pantalla está en blanco. Haz clic en Nuevo Proyecto para comenzar:

Completa la información básica del proyecto en la pestaña General y luego haz clic en Iniciar diseño para abrir el diseñador de proyectos.

Diseñar un proyecto

El diseñador de proyectos es la interfaz donde se diseña un proyecto. El diseñador de proyectos incluye la barra de herramientas del proyecto, el panel del proyecto, el lienzo de diseño y una paleta de componentes, así como las pantallas de configuración para cada componente, como las de transformaciones, scripts, puntos finales y actividades.

Al abrir un proyecto, se muestran estas partes del diseñador de proyectos, como se muestra en el ejemplo a continuación para un proyecto que ya ha sido diseñado:

Generalmente, se diseñan flujos de trabajo — o colecciones de operaciones agrupadas para la conveniencia del usuario — dentro del lienzo de diseño utilizando las herramientas proporcionadas en la paleta de componentes, el panel del proyecto y en el propio lienzo de diseño.

Las siguientes secciones describen el proceso básico de diseño:

1. Establecer conectividad
2. Crear pasos de operación
3. Encadenar operaciones utilizando acciones de operación
4. Desplegar y ejecutar operaciones

Establecer conectividad

La paleta de componentes de diseño proporciona acceso a recursos de conectividad. Aquí, conectores ofrecen la interfaz para ingresar datos proporcionados por el usuario, como credenciales, para crear una conexión. Dentro de la pestaña Puntos finales y conectores del proyecto de la paleta de componentes, la categoría Conectores muestra los tipos de conectores que se pueden configurar. Cada conector está representado por un ícono de carpeta de conector y el nombre del conector. Haz clic en un conector para abrir una pantalla de configuración y crear una nueva conexión para acceder a un recurso de datos particular:

Para instrucciones detalladas sobre cómo configurar un punto final, consulta la conexión específica en Conectores. Cada vez que crees un nuevo punto final, debes hacerlo desde los íconos de carpeta de conector accesibles en la categoría Conectores.

Una vez que hayas creado una conexión, se mostrará en la categoría Puntos finales. Haz clic en un punto final para abrir la carpeta del conector y revelar los tipos de actividades —interacciones con un recurso de datos— que se pueden configurar para ese punto final.

Un punto final en la interfaz de usuario de Integration Studio se refiere a un recurso de datos configurado (conector) y sus actividades. (Consulta Uso de Puntos Finales (Beta) para la definición de un punto final con licencia.)

Crear pasos de operación

Las operaciones que definen lo que la integración debe hacer se crean añadiendo y configurando pasos de operación —compuestos de actividades, transformaciones y/o scripts— en el lienzo de diseño.

La sección Establecer conectividad anterior mostró cómo crear un punto final y ver sus tipos de actividad.

Para crear una instancia de una actividad, coloca un tipo de actividad en el lienzo de diseño arrastrándolo o copiándolo a una zona de caída de operación o componente:

Una vez que se crea una actividad, puedes hacer doble clic en ella para configurarla como se describe para cada actividad específica en Conectores.

Para agregar actividades adicionales, colócalas en otra zona de caída. Las zonas de caída de operación adicionales se muestran al pasar el cursor sobre una operación existente. Las zonas de caída de componente en operaciones existentes se muestran al pasar el cursor a la izquierda o derecha de los pasos de operación existentes. Una configuración común es configurar una actividad como la fuente de datos y una segunda actividad a su derecha como el destino de datos.

También puedes querer agregar herramientas a una operación. Las herramientas proporcionan la interfaz para aplicar lógica o condiciones específicas a los datos dentro de una operación.

Para agregar herramientas de transformación o script directamente a una operación, haz clic derecho o haz clic en el menú de acciones en una zona de caída y selecciona Nuevo Script o Nueva Transformación:

Cuando agregas un script o transformación, su pantalla de configuración se abre automáticamente. Para obtener detalles sobre la configuración, consulta Transformaciones y Scripts, respectivamente.

Encadenar operaciones utilizando acciones de operación

Después de que se crea más de una operación, puedes configurar acciones de operación para activar otras operaciones, enviar correos electrónicos o escribir mensajes en el registro después de que una operación tenga éxito o falle.

Para configurar estas acciones, haz clic en el ícono del menú de acciones en la barra de acciones de operación, luego haz clic en Configuración.

En la pestaña Acciones de la configuración, selecciona la condición que debe activar la acción, qué acción debe llevarse a cabo y cualquier parámetro adicional, como qué otra operación debe configurarse para ejecutarse. Para más detalles, consulta Acciones de operación.

Una vez que estas acciones están configuradas, aparecen líneas en el lienzo de diseño para indicar visualmente cualquier acción que esté configurada para ejecutarse en caso de éxito (líneas verdes) o en caso de fallo (líneas rojas) de la operación. Se dice que una operación que se inicia en función de las acciones de operación está "downstream" de una operación "upstream" anterior.

Desplegar y ejecutar operaciones

Después de haber desarrollado una cadena de operaciones, la despliegas a un agente de Jitterbit y la ejecutas. Para desplegar y ejecutar una operación, haz clic en el ícono de desplegar y ejecutar en la barra de acciones de operación.

Cualquier operación que esté "downstream" de la operación que se está desplegando y ejecutando también se incluye.

En lugar de la ejecución manual, también puedes configurar operaciones para que se ejecuten en un horario, o mediante un desencadenador de API o un desencadenador de evento. Para más información, consulta Despliegue y ejecución de operaciones.

Después de que las operaciones se ejecuten, puedes validar el comportamiento adecuado viendo los registros. Para ver los registros de una operación particular y de las operaciones "downstream", haz clic en el ícono de menú de acciones en la parte superior derecha de una operación y selecciona Ver registros. Para más información, consulta Registros de operación.

Recursos adicionales

Mientras diseñas un proyecto, consulta la información detallada organizada por tema en Integration Studio:

• Proyectos: Aprende lo básico sobre permisos de proyectos, colaboración y guardado, así como sobre cómo crear, configurar, desplegar, transferir, exportar, importar y eliminar proyectos.
• Componentes del proyecto: Navega por la información sobre qué componentes del proyecto existen y qué acciones compartidas puedes realizar con cada componente.
• Flujos de trabajo: Encuentra información sobre cómo crear, desplegar y eliminar flujos de trabajo, dependencias y qué hace que un flujo de trabajo sea válido.
• Operaciones: Consulta detalles sobre la creación de operaciones; configuración de ajustes de operación como acciones, opciones y horarios; visualización de registros de operación; despliegue y ejecución de operaciones; visualización de dependencias y eliminación de operaciones; y qué hace que una operación sea válida.
• Conectores: Consulta la documentación específica de los puntos finales sobre cómo configurar conexiones y actividades para conectarte e interactuar con un punto final específico.
• Transformaciones: Infórmate sobre lo básico y aprende las complejidades de mapear entradas de datos a la salida de destino deseada.
• Esquemas: Familiarízate con los diversos tipos de esquemas y aprende a identificar cuándo usarlos.
• Scripts: Descubre la flexibilidad y el poder de los scripts para transformar datos, realizar cálculos o validar lógica dentro de operaciones o transformaciones.
• Funciones: Consulta descripciones y ejemplos de funciones que se pueden usar en scripts para mejorar y refinar los procesos de datos.
• Variables: Revisa los diferentes tipos de variables y cómo pueden ayudarte a ser más eficiente en el diseño de un proyecto.
• Notificaciones: Aprende a personalizar mensajes de correo electrónico que pueden ser activados en caso de éxito o fallo de una operación o llamados desde un script.
• Plugins: Infórmate sobre cómo puedes extender las capacidades nativas de Harmony utilizando plugins proporcionados por Jitterbit o por el usuario.

Los usuarios avanzados también pueden estar interesados en crear sus propios conectores para Integration Studio utilizando el Constructor de Conectores o el SDK de Conectores.