Guía de inicio rápido para Jitterbit Studio

Introducción

Esta guía está destinada a nuevos usuarios de 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 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 Studio y plantillas de procesos de Studio. Para comenzar con una receta o plantilla existente, consulta Iniciando un proyecto de receta o plantilla.

Acceder a Studio

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 Studio:

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 Studio accesibles. La primera vez que accedes a 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 Comenzar a Diseñar 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 proporcionan 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. Haga clic en un conector para abrir una pantalla de configuración para crear una nueva conexión para acceder a un recurso de datos particular:

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

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

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

Pasos de operación de creació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 endpoint 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 añadir 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.

Puede que también desee 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, haga clic derecho o haga clic en el menú de acciones en una zona de caída y seleccione Nuevo Script o Nueva Transformación:

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

Encadenar operaciones utilizando acciones de operación

Después de que se crea más de una operación, puede 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, haga clic en el ícono del menú de acciones en la barra de acciones de operación, luego haga clic en Configuración.

En la pestaña Acciones de la configuración, seleccione la condición que debe activar la acción, qué acción debe tomarse y cualquier parámetro adicional, como qué otra operación debe configurarse para ejecutarse. Para obtener detalles, consulte 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 falla (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á "aguas abajo" de una operación "aguas arriba" 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é aguas abajo 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 en un desencadenador de API o desencadenador de eventos. 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 al ver los registros. Para ver los registros de una operación particular y de las operaciones aguas abajo, haz clic en el ícono del menú de acciones en la parte superior derecha de una operación y selecciona Ver registros. Para más información, consulta Registros de operaciones.

Recursos adicionales

Mientras diseñas un proyecto, consulta la información detallada organizada por tema bajo Estudio:

• Proyectos: Aprende lo básico sobre permisos de proyectos, colaboración y guardado, y sobre cómo crear, configurar, desplegar, transferir, exportar, importar y eliminar proyectos.
• Componentes del proyecto: Navega por la información sobre qué componentes de 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 operaciones; 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 cada punto final 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 objetivo deseada.
• Esquemas: Familiarízate con los diversos tipos de esquemas y aprende a identificar cuándo utilizarlos.
• 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 utilizar 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 cómo personalizar mensajes de correo electrónico que pueden ser activados por el éxito o fracaso 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 Studio utilizando el Constructor de Conectores o el SDK de Conectores.