Lienzo de diseño en Jitterbit Integration Studio

Introducción

El lienzo de diseño es el área central cuando se abre un proyecto, que sirve como el espacio de trabajo principal donde se diseñan visualmente las integraciones. Esta página cubre los elementos de la interfaz de usuario que están presentes en el lienzo de diseño, así como conceptos clave para entender mientras se trabaja en el lienzo de diseño.

Para acceder al lienzo de diseño, primero abre un proyecto. En un proyecto abierto, el lienzo de diseño es el área central ubicada a la derecha del panel del proyecto y a la izquierda de la paleta de componentes de diseño, debajo de la barra de herramientas del proyecto:

Encabezado del lienzo de diseño

Estos elementos están presentes en la parte superior del lienzo de diseño:

• Pestañas de flujo de trabajo: Los flujos de trabajo se acceden desde las pestañas en la parte superior del lienzo de diseño. Se pueden crear flujos de trabajo adicionales haciendo clic en el ícono de nuevo flujo de trabajo. El nuevo flujo de trabajo se abre en una nueva pestaña dentro del lienzo de diseño. Los flujos de trabajo se numeran secuencialmente en el orden en que se crean, como 1.0, 2.0, 3.0, etc. Si se reordenan los flujos de trabajo, esta secuencia numérica se ajusta en consecuencia (ver Reordenar flujos de trabajo en Creación y diseño de flujos de trabajo).

• Estado de guardado: El estado de auto-guardado se muestra en la parte superior izquierda del lienzo de diseño. Estos estados están disponibles:

  • Guardado: Todos los elementos del proyecto están guardados según la configuración actual.
  • Guardando: El proyecto se está guardando actualmente. Este estado ocurre solo después de que se han realizado cambios.

• Última implementación: Se muestra la fecha y hora en que se implementó por última vez cualquier parte del proyecto. Si aún no se ha implementado ninguna parte del proyecto, no se muestra nada aquí.

• Colapsar todas las operaciones o Expandir todas las operaciones: Alterna la visualización de todas las operaciones dentro del flujo de trabajo actual a una vista condensada o expandida (ver Expandir o colapsar operaciones en Creación y configuración de operaciones).

• Resaltar elementos inválidos: Alterna la visualización de elementos inválidos (ver Validez del flujo de trabajo, Validez de la operación o Validez del componente, respectivamente).

• Acciones: Haga clic en el ícono del menú de acciones para abrir el menú de acciones del lienzo de diseño (ver Menú de acciones del lienzo de diseño más adelante en esta página).

Elementos del lienzo de diseño

La función principal del lienzo de diseño es tener un espacio de trabajo donde se diseñen visualmente los flujos de trabajo. Cada flujo de trabajo está compuesto por una colección de operaciones que se utiliza como herramienta para su conveniencia y ayuda a segregar diferentes partes del proyecto.

Los flujos de trabajo se diseñan colocando y configurando operaciones en el lienzo de diseño. Los elementos del lienzo de diseño son los elementos que aparecen visualmente en el lienzo de diseño para ayudar a diseñar un flujo de trabajo, incluyendo estos:

• Zonas de caída para operaciones y para otros componentes utilizados como pasos de operación
• Operaciones y los componentes utilizados como pasos de operación dentro de ellas
• Notificaciones que están encadenadas desde operaciones
• Referencias de operación que están fuera del flujo de trabajo actual y encadenadas desde una operación en el flujo de trabajo actual
• Líneas entre operaciones encadenadas, scripts y notificaciones

Cada uno de esos elementos del lienzo de diseño se describe a continuación. Para obtener información adicional sobre el diseño de flujos de trabajo, consulte Creación y diseño de flujos de trabajo.

Zonas de caída

Una zona de caída es una representación visual de dónde se puede colocar una operación u otro componente en el lienzo de diseño. Hay dos tipos de zonas de caída, zonas de caída de operaciones y zonas de caída de componentes:

• Zona de caída de operaciones: Las zonas de caída de operaciones indican dónde se puede colocar una operación. Una zona de caída de operaciones se muestra permanentemente en la parte inferior del lienzo de diseño después de la última operación. Para mostrar zonas de caída de operaciones adicionales, pase el cursor sobre las operaciones existentes. Cuando hace clic para seleccionar una zona de caída de operaciones, se muestra con un borde azul que contorna la zona de caída y está seleccionada hasta que cambie el enfoque:

  

• Zona de caída de componentes: Las zonas de caída de componentes indican dónde se pueden colocar otros componentes que se pueden usar como pasos de operación en una operación existente. Para mostrar una zona de caída de componentes, pase el cursor a la izquierda o a la derecha de un paso de operación en una operación existente en el lienzo de diseño. Cuando hace clic para seleccionar una zona de caída de componentes, se muestra con un borde azul que contorna la zona de caída y está seleccionada hasta que cambie el enfoque:

  

Un menú de acciones está disponible en cada zona de caída. Tanto las zonas de caída de operaciones como las zonas de caída de otros componentes muestran los mismos elementos del menú, como se describe en Menú de acciones de la zona de caída más adelante en esta página.

Operaciones

Las operaciones se representan visualmente en el lienzo de diseño mediante un área rectangular dinámica con un fondo gris.

Una operación consta de estos elementos:

Nombre de la operación

El nombre de la operación proporcionado por el usuario se encuentra en la parte superior izquierda de la operación. Cuando se crea una nueva operación, su nombre predeterminado es Nueva Operación. Las operaciones nuevas subsiguientes con nombres predeterminados se les añade un número incrementado entre paréntesis. Los nombres de las operaciones deben ser únicos y no deben contener barras diagonales (/) o dos puntos (:) para ser válidos. Para renombrar una operación, consulta Renombrar flujos de trabajo, operaciones y pasos de operación más adelante en esta página.

Validez de la operación

Cuando se selecciona Resaltar elementos inválidos, cualquier componente inválido y las operaciones en las que residen se delinean en color rojo y tienen un ícono inválido junto a su nombre en el lienzo de diseño:

Haz clic en el ícono inválido para ver los errores de validación de la operación.

Barra de acciones de la operación

La barra de acciones de la operación aparece en la parte superior derecha de una operación al pasar el cursor sobre la operación y consiste en este conjunto de íconos:

Pasos de operación

Cada operación que ya ha sido configurada con pasos de operación incluye una representación visual de esos pasos. Cada paso está representado por un rectángulo que muestra un ícono que representa el componente, junto al nombre del componente:

• Barra de acciones: Cada paso de operación tiene una barra de acciones que es accesible al pasar el cursor sobre el paso de operación. Cada elemento del menú se describe en Barra de acciones del componente más adelante en esta página.

• Ícono de plugin: Las actividades que han sido configuradas con un plugin que se ejecuta al realizar la operación muestran un ícono de plugin en la parte superior derecha del paso de operación. Para más información, consulta Plugins añadidos a una actividad.

• Ícono de oyente: Las actividades de oyente se muestran con un ícono que indica el estado del oyente. Para más información, consulta la página del Servicio de escucha.

  • Un ícono de oyente azul indica que la escucha está habilitada para esta actividad.

  • Un ícono de oyente gris indica que la escucha no está habilitada para esta actividad.

• Eventos habilitados / eventos deshabilitados: Después de que una operación que contiene una actividad de oyente es desplegada, aparece un interruptor. El interruptor se puede usar para habilitar o deshabilitar la escucha de eventos para esa operación. Para más información, consulta la página del Servicio de escucha.

Barra de estado de operación

La barra de estado de operación se encuentra en la parte inferior de la operación y muestra un indicador visual para operaciones con cambios no desplegados, y bajo ciertas circunstancias, se muestran los estados de ejecución y registro de depuración:

Estado no desplegado

Cuando una operación tiene cambios no desplegados, se muestra un ícono No desplegado en la barra de estado de operación y se puede hacer clic para desplegar cualquier cambio.

Estado de ejecución

Cuando se ejecuta una operación, su estado de ejecución se muestra con la opción de cancelar la ejecución. Para más detalles, consulta Estado de la operación en Despliegue y ejecución de operaciones:

La opción Cancelar es visible solo cuando el estado de la operación es Enviado, Recibido, Pendiente o En ejecución. Al hacer clic en Cancelar, se envía una solicitud al agente para detener la operación y se muestra un estado de Cancelación solicitada junto al estado de operación en tiempo real:

Estado de registro de depuración

Un ícono de depuración verde se muestra para las operaciones que tienen registro de depuración habilitado.

Cuando está presente, haz clic en el ícono de depuración en la operación para abrir el panel lateral de registro de depuración. Desde el panel puedes deshabilitar el registro de depuración o editar la fecha en que el registro de depuración se deshabilitará automáticamente:

Seleccionar operaciones y pasos de operación

Para seleccionar una operación, haz clic en el fondo de la operación. Una operación seleccionada se muestra con un borde azul que contorna la operación. En este ejemplo, se ha seleccionado toda la operación Obtener pedidos aprobados de NetSuite:

Para seleccionar un paso de operación, haz clic en la representación visual del paso. Un paso de operación seleccionado se muestra con un borde azul que contorna el componente. En este ejemplo, se ha seleccionado la transformación Mapear pedidos de ventas de NS:

Notificaciones

Una representación visual de una notificación aparece automáticamente en el lienzo de diseño cuando se vincula una notificación por correo electrónico utilizando la acción de operación Enviar Notificación por Correo Electrónico operation action. Se proporciona información adicional sobre la visualización de enlaces a continuación en Líneas.

La notificación por correo electrónico se muestra con un fondo gris. Dentro del área de fondo, la notificación por correo electrónico está representada por un rectángulo que muestra un ícono, debajo del cual se encuentra el nombre de la notificación por correo electrónico. Para seleccionar una notificación por correo electrónico, haga clic en la representación visual de la misma. Una notificación por correo electrónico seleccionada se muestra con un borde azul que contorna el componente:

Para las acciones de menú disponibles en una notificación por correo electrónico, consulte Menú de acciones del componente más adelante en esta página.

Referencias de operación

Las operaciones que existen fuera del flujo de trabajo actual pueden ser referenciadas desde una operación en el flujo de trabajo actual. Cuando tal operación está encadenada, una representación visual de la operación externa aparece automáticamente en el lienzo de diseño en el flujo de trabajo actual. Se proporciona información adicional sobre la visualización de enlaces a continuación en Líneas.

La referencia de operación contiene íconos de forma que sirven como una representación general de los pasos de operación.

Una operación que existe en el proyecto actual, pero no existe en otro flujo de trabajo, se muestra con un ícono de operación con el nombre de la operación solamente:

Una operación que existe en otro flujo de trabajo se muestra con un ícono de flujo de trabajo y el nombre del flujo de trabajo, seguido de un ícono de operación y el nombre de la operación. Haga clic en la referencia de operación para abrir el flujo de trabajo en el que existe la operación:

Líneas

Las líneas entre operaciones, scripts y notificaciones aparecen automáticamente en el lienzo de diseño, representando una cadena de operación.

Al utilizar acciones de operación o la función RunOperation, esta relación se indica visualmente con líneas.

En condición de éxito

Se muestra una línea verde para una condición de En Éxito y aparece a la izquierda de las operaciones encadenadas o correos electrónicos:

En condición de fallo

Se muestra una línea roja para una condición de En Fallo y aparece a la derecha de las operaciones encadenadas o correos electrónicos:

En condición de fallo SOAP

Se muestra una línea naranja para una condición de En Fallo SOAP y aparece a la derecha de las operaciones encadenadas o correos electrónicos:

función RunOperation

Se muestra una línea gris para una operación llamada desde un script utilizando la función RunOperation y comienza en el paso de operación que utiliza la función. Una línea gris aparece a la izquierda de las operaciones encadenadas o correos electrónicos:

Un círculo abierto se muestra en una operación colapsada para indicar visualmente que el script que llama a la operación encadenada proviene de un componente colapsado:

Menús de acciones

Los menús de acciones accesibles desde el lienzo de diseño incluyen aquellos para el lienzo de diseño, componentes y zonas de caída.

Menú de acciones del lienzo de diseño

Haz clic en el ícono del menú de acciones en la parte superior derecha del lienzo de diseño para abrir un menú con estas acciones:

Elemento del menú	Descripción
	Deshacer revierte tu última acción (ver Deshacer y rehacer en Permisos, colaboración y guardado de Integration Studio).
	Rehacer revierte tu última acción de Deshacer (ver Deshacer y rehacer en Permisos, colaboración y guardado de Integration Studio).
	Desplegar muestra estas acciones del menú: Desplegar: Despliega todas las operaciones utilizadas por los flujos de trabajo de un proyecto (ver Despliegue de proyectos). Despliegue configurable: Abre la pantalla de despliegue del proyecto, donde puedes seleccionar flujos de trabajo y operaciones para desplegar (ver Despliegue de proyectos).
	Migrar abre la pantalla de transferencia del proyecto, donde puedes transferir todo el proyecto a un entorno (ver Transferir un proyecto).
	Historial del proyecto abre un panel en el lado derecho del diseñador de proyectos donde puedes ver eventos del historial del proyecto, eventos de etiquetas y restaurar proyectos (ver Historial del proyecto).

Acciones del componente

Para abrir el menú de acciones de una operación, realiza una de estas acciones:

• Haz clic derecho en cualquier parte de la barra de acciones de la operación.
• Haz clic en el ícono del menú de acciones en la parte superior derecha de una operación.

Pasa el cursor sobre un paso de operación (actividades, transformaciones o scripts) y notificaciones por correo electrónico para ver su barra de acciones.

Algunas acciones están disponibles solo en ciertos tipos de componentes, como se detalla en las subsecciones a continuación:

• Operaciones: El menú de acciones para operaciones (mostrado en la imagen de la izquierda) tiene elementos únicos como Configuración, Duplicar, Ejecutar, Ver registros, Renombrar, Ver dependencias, Agregar a grupo y Eliminar, y submenús únicos para Desplegar. También incluye acciones comunes como Cortar, Copiar y Eliminar.
• Actividades, herramientas y notificaciones por correo electrónico: El menú de acciones para estos componentes (mostrado en la imagen de la derecha) comparte las mismas acciones, incluyendo Ver/Editar, Cortar, Copiar, Renombrar y Eliminar.

Operaciones

Estos elementos están disponibles en el menú de acciones de una operación:

Elemento del menú	Descripción
	Configuración abre la configuración de la operación, que contiene tres pestañas: Programaciones: Crea y aplica programaciones para ejecutar operaciones automáticamente (ver Programaciones de operación). Acciones: Configura acciones a realizar en caso de éxito o fallo de la operación (ver Acciones de operación). Opciones: Establece opciones como cuándo se agotará el tiempo de la operación, qué registrar y el período de tiempo para el registro, cuándo se ejecutará la operación o si se utilizará fragmentación (ver Opciones de operación).
	Publicar como una API abre un diálogo para configurar y publicar una API personalizada en el Administrador de API para exponer la operación para su consumo (ver Publicar como una API). El número de APIs asignadas a la operación se muestra junto a este elemento del menú. Esta acción es visible solo cuando la operación no tiene cambios no desplegados.
	Publicar como una API usando IA abre el Asistente de IA de APIM, que te guía a través de la publicación de la operación como una API mediante indicaciones interactivas. Esta acción es visible solo cuando la operación no tiene cambios no desplegados y la organización tiene licencia para el Asistente de IA de APIM.
	Duplicar muestra estas acciones del menú (ver Reutilización de operación): Con Referencias de Paso: Duplica solo la operación. La operación duplicada contiene referencias a cada uno de los pasos de la operación original. Con Copias de Paso: Duplica la operación y los componentes referenciados como pasos de operación. Se crean nuevos componentes para cada paso de operación y son referenciados por la operación duplicada.
	Desplegar muestra estas acciones del menú: Desplegar: Despliega la operación y sus dependencias (ver Despliegue y ejecución de operación). Desplegar y Ejecutar: Despliega y ejecuta la operación y cualquier operación descendente (hija) (ver Despliegue y ejecución de operación). Despliegue Configurable: Abre la pantalla de despliegue, donde puedes seleccionar flujos de trabajo y operaciones para desplegar (ver Despliegue y ejecución de operación).
	Ejecutar ejecuta una operación ya desplegada y cualquier operación descendente (hija) (ver Despliegue y ejecución de operación).
	Ver Registros abre la pantalla de registros de la operación, que incluye registros para esta operación y cualquier operación hija que haya sido desplegada y ejecutada (ver Registros de operación).
	Renombrar posiciona el cursor en el nombre de la operación para que puedas realizar las ediciones necesarias.
	Ver Dependencias cambia la vista en el panel del proyecto para mostrar cualquier otra parte del proyecto de la que depende la operación específica (ver Dependencias, eliminación y remoción de operación).
	Agregar a Grupo abre un diálogo para crear un nuevo grupo personalizado o agregar el componente a un grupo existente (ver Grupos de componentes).
	Transferencia Selectiva (Beta) abre una pantalla de configuración donde puedes seleccionar componentes específicos para transferir a otro entorno. Para más información, ver Transferencia de proyecto.
	Eliminar elimina permanentemente el componente (ver Dependencias, eliminación y remoción de operación).
	Eliminar quita la operación del lienzo de diseño. Cualquier otra referencia a la operación, como dentro de scripts, transformaciones o configuraciones, no se ve afectada (ver Dependencias, eliminación y remoción de operación).

Actividades, herramientas y notificaciones por correo electrónico

La barra de acciones para actividades, herramientas y notificaciones por correo electrónico comparte las mismas acciones:

Menú de acciones de la zona de caída

Las zonas de caída de operaciones son siempre visibles en el lienzo de diseño. Para mostrar la zona de caída de un componente que se puede usar como un paso de operación, pasa el cursor a la izquierda o a la derecha de un paso de operación en una operación existente en el lienzo de diseño.

Haz clic en una zona de caída para abrir su menú de acciones. Tanto las zonas de caída de operaciones como las zonas de caída de otros componentes muestran los mismos elementos de menú:

Elemento del menú	Descripción
	Nuevo Script crea un nuevo script como un paso en una operación nueva o existente (ver Tipos de script y creación). Cuando se usa en una zona de caída de operaciones, también se crea una nueva operación.
	Nueva Transformación crea una nueva transformación como un paso en una operación nueva o existente (ver Creación y configuración de transformaciones). Cuando se usa en una zona de caída de operaciones, también se crea una nueva operación.
	Pegar crea un duplicado de una actividad, script, operación o notificación por correo electrónico que está en tu portapapeles como un nuevo componente referenciado por una operación nueva o existente (ver Reutilización de componentes). Cuando se usa en una zona de caída de operaciones, también se crea una nueva operación. El nombre predeterminado del nuevo componente utiliza el nombre del componente original seguido de - Copia. Los duplicados posteriores se les añade un número incrementado entre paréntesis.

Renombrar flujos de trabajo, operaciones y pasos de operación

Para renombrar un flujo de trabajo desde el lienzo de diseño, haz doble clic en el nombre en la pestaña de flujo de trabajo en la parte superior del lienzo de diseño:

Puedes renombrar operaciones, actividades y herramientas de tres maneras: desde sus pantallas de configuración individuales, utilizando la acción Renombrar desde sus respectivos menús de acciones, o seleccionando el componente y haciendo clic en su nombre.

Reordenar operaciones

Las operaciones en el mismo flujo de trabajo se pueden reordenar arrastrándolas y soltándolas en el lienzo de diseño.

Haz clic y mantén presionado en cualquier parte de una operación para recogerla y arrastrarla por encima o por debajo de otras operaciones dentro del flujo de trabajo:

Esta acción tiene un efecto en cascada de renumerar las operaciones por encima o por debajo de ella en el árbol del proyecto.