Crear y configurar una operación en Jitterbit Integration Studio
Introducción
Una operación es la unidad más pequeña dentro de un flujo de trabajo que se ejecuta de forma independiente en un agente y Harmony la registra. Las operaciones se utilizan para definir qué debe hacer un proceso de integración y cuándo debe realizarse.
Las operaciones se componen de una combinación de actividades y herramientas:
La combinación y el orden específicos de estos componentes deben seguir el conjunto de patrones válidos. Para más detalles sobre estos patrones, consulte Validez de la operación.
Esta página explica las partes de una operación, luego cubre cómo agregar pasos a las operaciones, acceder a las opciones del menú, cambiar el nombre de las operaciones, expandir/contraer operaciones, reordenar operaciones y reutilizar, eliminar o mover pasos de operación.
Partes de una operación
Las operaciones se forman organizando actividades y herramientas dentro de una operación en el tela de diseño la operación puede consistir en un solo secuencia de comandos, o la disposición puede formar una secuencia de pasos que conste de una o más actividades o herramientas. Las combinaciones específicas permitidas se describen en Validez de la operación.
Actividades
Una actividad es un componente que se crea a partir de una conexión y que puede configurarse para interactuar con un extremo. Las actividades pueden utilizarse en una operación como origen o destino y pueden configurarse con esquemas de datos que representan los esquemas de solicitud y respuesta para la interacción con el extremo. Además de utilizarse como un etapa de operación, algunas actividades también pueden referenciarse en secuencias de comandos (véase Extremos en Jitterbit Script).
Para más información sobre los conceptos básicos de conectores, así como recursos para configurar conexiones y actividades por cada tipo de conector, consulte las páginas en Conectores.
Fuentes
Una actividad de origen es cualquier actividad que proporciona datos dentro de una operación, que luego puede transferirse a un destino sin cambios o modificado mediante una transformación antes de alcanzar un objetivo.
Las actividades de origen requieren un esquema de datos solo si se utilizarán como entrada en una transformación:
- Si la actividad de origen proporciona datos que se transformarán, debe tener un esquema de datos de respuesta, que se proporciona automáticamente o se puede definir al configurar la actividad o la transformación.
- Si la actividad de origen proporciona datos que no se transformarán, no es necesario definir un esquema de respuesta, ya que esquema no se utiliza en la operación.
Las actividades que normalmente (pero no necesariamente) se utilizan como fuentes incluyen aquellas que tienen una de estas palabras en el nombre de la actividad:
- Descargar
- Conseguir
- Leer
- Pedido
- Consulta
Objetivos
Una actividad objetivo es cualquier actividad que recibe datos dentro de una operación. Estos datos pueden provenir de una actividad fuente, de una transformación, o de otra entrada como variables o secuencias de comandos.
Las actividades de destino requieren un esquema de datos solo si reciben datos que se han transformado o si proporcionan una respuesta que desea escribir en otro destino:
- Si la actividad de destino recibe datos que se han transformado, debe tener un esquema de datos de solicitud, que se proporciona automáticamente o se puede definir al configurar la actividad o la transformación.
- Si la actividad de destino recibe datos que no se han transformado, no es necesario definir un esquema de solicitud, ya que esquema no se utiliza en la operación. Si un tipo específico de actividad de destino proporciona una respuesta, también puede tener un esquema de datos de respuesta. Si desea escribir la respuesta en otro destino, el esquema de datos de respuesta se proporciona automáticamente o puede definirse al configurar la actividad o transformación. Si el tipo de destino proporciona una respuesta, no se requiere una operación para escribirla en otro destino; es decir, se puede proporcionar un esquema de respuesta, pero se puede ignorar dentro de la operación si no es necesario.
Las actividades que normalmente (pero no necesariamente) se utilizan como objetivos incluyen aquellas que tienen una de estas palabras en el nombre de la actividad:
- Agregar
- Crear
- Borrar
- Insertar
- Correo
- Poner
- Respuesta
- Subir
- Actualizar
- Inserción posterior
- Escribir
Herramientas
Una herramienta es un componente del proyecto que proporciona la interfaz para aplicar lógica o condiciones específicas a los datos dentro de una operación.
Secuencias de comandos
Un secuencia de comandos creado como componente de proyecto puede utilizarse como paso en una operación para transformar datos, realizar cálculos o validar la lógica. Por ejemplo, puede usar un secuencia de comandos antes o después de una actividad para recuperar datos y luego procesar la lógica del secuencia de comandos, o puede ejecutar un secuencia de comandos de validación antes de proceder a una transformación. Para obtener más información, consulte Tipos de Secuencia de comandos y creación.
Transformaciones
Una transformación es un componente de proyecto que se utiliza como paso en una operación para asignar o transformar entradas en una salida resultante mediante el movimiento y la limpieza de datos o la aplicación de lógica de negocio. Tras crear una transformación, debe configurarla asignando diversas entradas, como objetos de origen, variables o secuencias de comandos, a la salida de destino resultante, que suele ser una estructura de datos de destino. Para obtener más información, consulte Transformaciones.
Herramientas adicionales
Hay herramientas adicionales disponibles en la pestaña Herramientas de la paleta de componentes de diseño (consulte Herramientas en paleta de componentes de diseño). Estos componentes del proyecto implementan una función específica y están pensados para reemplazar la necesidad de usar scripts para ciertos secuencias de comandos usados como componentes del proyecto. Para obtener más información, consulte Tipos de herramientas y creación.
Agregar pasos a una operación
Las operaciones se componen de componentes del proyecto que consisten en actividades o herramientas. Para crear operaciones, se colocan esos componentes en un flujo de trabajo en el tela de diseño como pasos de una operación.
Seleccione la ubicación del componente dentro de una operación nueva o existente
El método para agregar un componente a una operación depende de si la operación se está creando recientemente o ya existe:
Nueva operación: Se muestra una área de inserción de operaciones en el tela de diseño donde se puede agregar un componente para crear una nueva operación. En un flujo de trabajo sin operaciones, la área de inserción se muestra en la parte superior del tela de diseño. En un flujo de trabajo con al menos una operación, la área de inserción se muestra en la parte inferior del tela de diseño, debajo de la última operación. Para mostrar más zonas de colocación de operación, pase el cursor sobre una operación existente.
{.z40}
Operación existente: Las operaciones existentes se muestran en el tela de diseño con un fondo gris claro. Al pasar el cursor a la izquierda o a la derecha de un componente en una operación existente, se muestra una área de inserción de componentes donde se puede agregar un componente a la operación.
{style="width: 911px"}
Una vez elegida la ubicación, los pasos para agregar el componente varían según si se trata de una actividad o un secuencia de comandos o transformación, que se abordará a continuación.
Cree conexiones y luego agregue y configure actividades
La paleta de componentes de diseño proporciona acceso a recursos de conectividad. Aquí, los conectores proporcionan la interfaz que permite introducir la información proporcionada por el usuario, como las credenciales, para crear una conexión. En la paleta de componentes, el filtro Conectores muestra los tipos de conectores que se pueden configurar:
Cada conector se representa mediante un icono de carpeta con su nombre. Haga clic en un conector para abrir una pantalla de configuración y crear un nuevo extremo de acceso a un recurso de datos específico.
Para obtener instrucciones detalladas sobre cómo configurar una conexión, consulte la conexión específica en Conectores. Cada vez que cree una nueva conexión, deberá hacerlo desde los íconos de la carpeta de conectores accesibles en el filtro Conectores.
Una vez creada una conexión, esta se mostrará en el filtro Extremos. Haga clic en un extremo para abrir su carpeta y ver los tipos de actividades (interacciones con un extremo ) que se pueden configurar para esa conexión.
Un extremo se refiere a una conexión específica y sus actividades, que se configuran como fuentes (para proporcionar datos) o destinos (para consumir datos) en un proyecto.
Para crear una instancia de una actividad, coloque un tipo de actividad en el tela de diseño arrastrándolo o copiándolo a una zona de colocación de operación o área de inserción de componentes:
Una vez creada una actividad, puede hacer doble clic en ella para configurarla como se describe para cada actividad específica en Conectores.
Agregar y configurar herramientas
También podrías añadir herramientas a una operación. Se puede crear una herramienta desde estas ubicaciones:
-
La pestaña Componentes del panel del proyecto usando el menú Crear nuevo (vea menú de acciones de la pestaña Componentes en la pestaña Componentes del panel Proyecto).
-
La pestaña Herramientas de la paleta de componentes de diseño (vea Herramientas en paleta de componentes de diseño).
Además de lo anterior, se pueden crear herramientas de secuencia de comandos y transformación desde el tela de diseño utilizando una área de inserción (consulte menú de acciones de la zona de colocación en Lienzo de diseño):
Al agregar un secuencia de comandos o una transformación, su pantalla de configuración se abre automáticamente. Para más detalles sobre la configuración, consulte Transformaciones y Secuencias de comandos, respectivamente.
Nota
Los pasos de la operación se pueden configurar en cualquier orden. Sin embargo, tenga en cuenta que un esquema proporcionado en una actividad adyacente tiene prioridad sobre un esquema definido en una transformación. La decisión de definir un esquema en una actividad o en una transformación depende de su caso de uso. Para obtener más información, consulte Uso del esquema.
Menú de acciones de operación
Después de crear una operación, las acciones del menú para esa operación son accesibles desde estas ubicaciones:
-
La pestaña Flujos de trabajo del panel del proyecto (vea menú de acciones de componentes en la pestaña Flujos de trabajo del panel Proyecto).
-
La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
-
El tela de diseño (vea menú de acciones del componente en Lienzo de diseño)
Cambiar el nombre de las operaciones y los pasos de la operación
Al crear una nueva operación, su nombre predeterminado es Nueva Operación. Las operaciones posteriores con nombres predeterminados se añaden con un número incremental entre paréntesis. Los nombres de las operaciones deben ser únicos y no deben contener barras diagonales (/) o dos puntos (:) para ser válido.
Las operaciones y los pasos de operación se pueden renombrar desde estas ubicaciones:
-
La pestaña Flujos de trabajo del panel del proyecto (vea menú de acciones de componentes en la pestaña Flujos de trabajo del panel Proyecto).
-
La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
-
El tela de diseño (vea Cambio de nombre de flujos de trabajo, operaciones y pasos de operación en Lienzo de diseño).
Los pasos de la operación también se pueden renombrar desde sus pantallas de configuración individuales.
Expandir o contraer operaciones
Al crear una operación, se expande por defecto. Las operaciones se pueden contraer o expandir individualmente o todas a la vez:
-
Contraer una operación individual: Para contraer una operación individual, haga clic en el icono icono de colapso en la barra de acción de la operación.
Al contraer una operación, solo se muestran el nombre de la operación y su estado de desplegar:
-
Expandir una operación individual: Para expandir una operación individual cuando está contraída, haga clic en el icono Expandir icono en la barra de acción de la operación.
-
Contraer todas las operaciones: Para contraer todas las operaciones en un flujo de trabajo, haga clic en Contraer todas las operaciones o en el Contraer todo el icono en la parte superior del tela de diseño.
-
Expandir todas las operaciones: Para expandir todas las operaciones en un flujo de trabajo cuando están contraídas, haga clic en Expandir todas las operaciones o en el Icono expandir todo en la parte superior del tela de diseño.
Operaciones de reordenamiento
Las operaciones se pueden reordenar dentro o entre flujos de trabajo desde la pestaña Flujos de trabajo del panel del proyecto (consulte Reordenar operaciones en la pestaña Flujos de trabajo del panel Proyecto).
Las operaciones se pueden reordenar dentro del mismo flujo de trabajo desde el tela de diseño (consulte Reordenar operaciones en Lienzo de diseño).