Creación y configuración de operaciones¶

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 que Harmony 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 una o más actividades, secuencias de comandos o transformaciones:

La combinación y el orden específicos de estos componentes deben seguir el conjunto de patrones válidos. Para obtener más información 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, secuencias de comandos y transformaciones dentro de una operación en el tela de diseño. La operación puede constar de un solo secuencia de comandos o la disposición puede formar una secuencia de pasos que conste de una o más actividades, secuencias de comandos o transformaciones. Las combinaciones específicas que se permiten 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 se puede configurar para interactuar con un extremo. Las actividades se pueden utilizar en una operación como origen o destino y se pueden configurar 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 se pueden referenciar en secuencias de comandos (consulte Extremos en Jitterbit Script).

Para obtener 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 se puede definir al configurar la actividad o transformación. Si el tipo de destino proporciona una respuesta, no se requiere una operación para escribir la respuesta 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

Secuencias de comandos¶

Un secuencia de comandos que se crea como un componente de proyecto se puede utilizar como un paso en una operación para transformar datos, realizar cálculos o realizar una validación lógica. Por ejemplo, puede utilizar 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 moviendo datos, limpiando datos o aplicando lógica empresarial. Después de crear una transformación, debe configurarla asignando varias entradas, como objetos de origen, variables o secuencias de comandos, a la salida de destino resultante, generalmente una estructura de datos de destino. Para obtener más información, consulte Transformaciones.

Agregar pasos a una operación¶

Las operaciones están formadas por componentes de proyecto que consisten en actividades, secuencias de comandos o transformaciones. Para crear operaciones, coloque 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 crea recientemente o ya existe:

• Nueva operación: Se muestra una área de inserción de operaciones en el tela de diseño donde sea que pueda agregar un componente para crear una nueva operación. En un flujo de trabajo que aún no tiene ninguna operación, la área de inserción se muestra en la parte superior del tela de diseño por sí sola. En un flujo de trabajo que tiene al menos una operación, se muestra una área de inserción en la parte inferior del tela de diseño por sí sola, debajo de la última operación. Para mostrar zonas de colocación de operación adicionales, pase el cursor sobre una operación existente.

  

• Operación existente: Las operaciones existentes se muestran en el tela de diseño con un fondo gris claro. Al pasar el cursor hacia la izquierda o la derecha de un componente en una operación existente, se muestra una área de inserción de componentes donde puede agregar un componente a una operación existente.

  

Una vez que haya decidido la ubicación, los pasos para agregar el componente son diferentes según si el componente es una actividad o un secuencia de comandos o transformación, que se tratará 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 datos proporcionados por el usuario, como credenciales, para crear una conexión. Dentro de la paleta de componentes, el filtro Conectores muestra los tipos de conectores que se pueden configurar:

Cada conector está representado por un icono de carpeta de conectores etiquetado con el nombre del conector. Haga clic en un conector para abrir una pantalla de configuración y crear un nuevo extremo para acceder a un recurso de datos en particular:

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 que haya creado 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 área de inserción de componentes de operación o componente:

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 transformaciones o secuencias de comandos¶

También puede agregar transformaciones o secuencias de comandos a una operación. Las Transformaciones se utilizan cuando se desea transformar datos antes de alcanzar su destino. Las Secuencias de comandos se pueden utilizar dentro de las transformaciones en los campos y nodos de destino para aplicar una lógica o condiciones específicas a los datos. Las Secuencias de comandos también se pueden utilizar como pasos opcionales dentro de una operación para diversos fines, como el manejo de errores o la repetición de registros de datos.

Para agregar una nueva transformación o secuencia de comandos directamente a una operación, haga clic derecho o haga clic en el menú de acciones en una área de inserción y seleccione Nueva Secuencia de comandos o Nueva Transformación:

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

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 del componente 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ñaComponentes 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¶

Cuando crea una nueva operación, su nombre predeterminado es Nueva operación. Las operaciones nuevas posteriores con nombres predeterminados se agregan con 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á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 del componente 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ñaComponentes del panel Proyecto).

• El tela de diseño (vea Cambiar el 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¶

Cuando se crea una operación, se expande de forma predeterminada. 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 botón 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 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 expandir todo el icono 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 (vea Reordenar operaciones en Lienzo de diseño).