Reutilizar operaciones en Jitterbit Integration Studio

Introducción

Esta página describe cómo reutilizar operaciones en un proyecto. La reutilización de otros tipos de componentes del proyecto se cubre en Reutilización de componentes.

Esta página está organizada en las siguientes secciones:

• Terminología de reutilización de componentes
  Esta sección define la terminología utilizada para discutir la reutilización de componentes. Un reconocimiento de la diferencia entre componentes independientes y referencias a esos componentes forma la base necesaria para entender los términos de la interfaz de usuario relacionados:
  • Duplicar una operación para crear una copia de la operación, ya sea con referencias de pasos de operación o copias de pasos de operación
  • Referenciar una operación existente
  • Cortar o copiar operaciones para colocarlas en su portapapeles
  • Pegar como una nueva operación o como una referencia dependiendo del contexto
• Cortar y copiar operaciones
  Esta sección describe los diversos lugares desde los cuales se pueden cortar y copiar operaciones. Cortar una operación también elimina la operación o su referencia del proyecto, dependiendo de dónde se cortó.
• Crear una nueva operación a partir de una operación existente
  Esta sección describe las diversas formas en que se puede crear una nueva operación a partir de una operación existente. Esto se hace duplicando una operación existente o cortando/copiando y pegando en ubicaciones designadas. Se puede crear una copia de una operación ya sea con referencias de pasos (excepto para ciertos tipos de actividad) o con copias de pasos. Las copias de operaciones con Salesforce, Salesforce Service Cloud y actividades de ServiceMax siempre crean esas actividades como nuevas actividades en lugar de referencias, ya que no se permite reutilizar más de una instancia de estos tipos de actividad.
• Crear una referencia de componente
  Esta sección describe las diversas formas en que se pueden referenciar operaciones. Las operaciones pueden ser referenciadas múltiples veces por cualquier combinación de otros componentes. Sin embargo, solo pueden ser referenciadas una sola vez en un flujo de trabajo.

Terminología de reutilización de componentes

Los componentes del proyecto, tal como aparecen en la interfaz de usuario de Integration Studio, pueden ser componentes independientes o referencias de componentes:

• Los componentes independientes son los bloques de construcción discretos de un proyecto y se encuentran en la pestaña Componentes del panel del proyecto. Los componentes independientes son los componentes en el proyecto.
• Las referencias de componentes hacen referencia a los componentes independientes. Las referencias de componentes en los flujos de trabajo del proyecto se encuentran en el lienzo de diseño y en la pestaña Flujos de trabajo del panel del proyecto. Los componentes también pueden ser referenciados por componentes que no forman parte de ningún flujo de trabajo.

Una operación como componente independiente puede ser reutilizada en un proyecto de dos maneras:

• Duplicar es utilizar la configuración de una operación existente para crear un nuevo componente independiente en un proyecto. Después de duplicar una operación, cualquier cambio que realices en el componente independiente original no se reflejará en la copia, y cualquier cambio que realices en la copia no afectará al componente independiente original. Cuando duplicas una operación, aparece una nueva operación en la pestaña Componentes del panel del proyecto y es un componente independiente en el proyecto.

  Puedes duplicar una operación ya sea con referencias de pasos o con copias de pasos:

  • Una operación duplicada con referencias de pasos tiene referencias a los pasos de la operación original. (Una excepción: Cualquier Salesforce, Salesforce Service Cloud y actividades de ServiceMax se duplican en lugar de ser referenciadas.)
  • Una operación duplicada con copias de pasos crea copias de cada paso de la operación original como nuevos componentes.

Una operación también se puede pegar entre proyectos abiertos en la misma sesión del navegador.

• Referenciar es usar la misma operación más de una vez en un proyecto y es la forma en que se construyen los flujos de trabajo del proyecto. Una referencia de componente en un flujo de trabajo es una operación, actividad, transformación, script o notificación por correo electrónico que se representa visualmente en el lienzo de diseño y aparece en la pestaña Flujos de trabajo del panel del proyecto (excepto por las notificaciones por correo electrónico). Las referencias de componente también pueden estar en otros componentes, que pueden o no estar en los flujos de trabajo del proyecto. Por ejemplo, una operación puede ser referenciada en una acción de operación configurada en otra operación, y también referenciada en una función de script, y también referenciada en un solo flujo de trabajo del proyecto. Cuando se referencia un componente dentro o fuera de los flujos de trabajo del proyecto, el conteo de referencias del componente en la pestaña Componentes del panel del proyecto se incrementa.

La palabra copia, como sustantivo, se utiliza para describir un nuevo componente independiente que se ha creado a partir de una operación existente.

Las palabras cortar y copiar, como acciones, colocan una copia de una operación en su portapapeles que luego se utiliza para crear ya sea un componente independiente o una referencia de componente. Cuál de estos dos se crea depende del contexto al pegar:

• Cortar coloca una copia de una operación en su portapapeles y elimina ya sea el componente independiente original o la referencia de componente, dependiendo de dónde se cortó la operación:
  • Si una operación se corta de la pestaña Componentes del panel del proyecto, se elimina el componente independiente original.
  • Si una operación se corta del lienzo de diseño o de la pestaña Flujos de trabajo del panel del proyecto, como el componente es una referencia a un componente independiente original, solo se elimina la referencia y el componente independiente original queda sin cambios.
• Copiar coloca una copia de una operación en su portapapeles. El componente independiente original queda sin cambios. Copiar y luego pegar una operación puede resultar en un nuevo componente independiente o una referencia de componente, dependiendo del contexto al pegar.
• Pegar crea ya sea un componente independiente o una referencia de componente, dependiendo del contexto al pegar. Por ejemplo:
  • Pegar una operación en la pestaña Componentes del panel del proyecto crea un nuevo componente independiente.
  • Pegar una operación una sola vez en el lienzo de diseño crea un nuevo componente independiente con referencias de paso (excepto por Salesforce, Salesforce Service Cloud y actividades de ServiceMax, que se duplican) y se agrega una referencia a esa operación en el flujo de trabajo del proyecto. Pegar la misma operación más veces agrega una referencia adicional a la operación recién creada en el flujo de trabajo del proyecto.

Operaciones de cortar y copiar

Puedes acceder a las acciones del menú Cortar y Copiar desde el menú de acciones de una operación en cualquiera de estos lugares:

• Componentes independientes en la pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña Componentes del panel del proyecto).
• Referencias de componentes en el lienzo de diseño (ver Menú de acciones del componente en Lienzo de diseño).
• Referencias de componentes en la pestaña Flujos de trabajo del panel del proyecto (ver Menú de acciones del componente en Pestaña Flujos de trabajo del panel del proyecto).

También puedes usar los atajos de teclado estándar para cortar (Control+X en Windows o Linux y Command+X en macOS) y copiar (Control+C en Windows o Linux y Command+C en macOS).

Las operaciones de cortar y copiar colocan una copia de una operación en tu portapapeles.

Cortar una operación del proyecto (desde la pestaña Componentes del panel del proyecto) elimina el componente independiente original del proyecto. Como se requiere la eliminación, cortar una operación solo es posible en operaciones no referenciadas. Se muestran los cuadros de diálogo estándar para la eliminación como se documenta en Dependencias de operaciones, eliminación y remoción.

Cortar una operación de un flujo de trabajo del proyecto (desde el lienzo de diseño o la pestaña Flujos de trabajo del panel del proyecto) elimina solo la referencia del componente. El componente independiente original queda sin cambios.

Crear una nueva operación a partir de una operación existente

Se puede crear una nueva operación como un componente independiente utilizando una combinación de las acciones de menú Cortar, Copiar y Pegar (o sus atajos de teclado) o utilizando la acción de menú Duplicar.

Al usar una combinación de las acciones de menú Cortar, Copiar y Pegar (o sus atajos de teclado), se crea una nueva operación utilizando la configuración de la operación original con estas excepciones:

• Se eliminan los horarios asignados.
• Se eliminan las operaciones configuradas.

Al usar la acción de menú Duplicar, se crea una nueva operación utilizando la misma configuración que la operación original, incluidos los horarios asignados y las acciones de operación configuradas.

El nombre predeterminado de la nueva operación utiliza el nombre del componente independiente original seguido de - Copia. Las copias posteriores se complementan con un número incrementado entre paréntesis.

Pegar

Una vez que tenga una copia de una operación en su portapapeles, puede pegarla en el mismo proyecto utilizando la aplicación de navegador actual o el modo de navegador desde el cual la copió.

Una operación (excepto las mencionadas a continuación) también se puede pegar entre proyectos abiertos en la misma sesión del navegador. Al pegar operaciones con pasos de actividad entre proyectos, se creará un nuevo punto final la primera vez que se pegue la operación con una actividad. Las pegatinas posteriores estarán conectadas al punto final existente.

Recortar o copiar una operación y luego pegar la operación en la pestaña Componentes del panel del proyecto o en el lienzo de diseño:

• Pestaña Componentes del Panel del Proyecto: Utiliza la acción de menú Pegar Operación desde el menú de acciones de una categoría de componentes (ver menú de acciones de la pestaña Componentes en Pestaña Componentes del Panel del Proyecto). Esta acción está habilitada solo cuando tienes una operación en tu portapapeles.
• Lienzo de Diseño: Selecciona una zona de caída de operación en el lienzo de diseño y luego utiliza su acción de menú Pegar (ver menú de acciones de la zona de caída en Lienzo de Diseño). Si se pega un componente de operación una sola vez en el lienzo de diseño, se crea un nuevo componente independiente y se agrega una referencia a ese componente al flujo de trabajo del proyecto.

Al crear la nueva operación, el cursor se posiciona en el nombre de la operación para renombrarla.

Duplicar

Puedes acceder a la acción de menú Duplicar desde el menú de acciones de una operación en la pestaña Componentes del panel del proyecto (ver menú de acciones de componentes en Pestaña Componentes del Panel del Proyecto) o en el lienzo de diseño.

La acción de menú Duplicar ofrece una elección entre dos métodos de duplicación:

• Con Referencias de Paso: Crea una nueva operación independiente solamente. La operación duplicada contiene referencias a cada uno de los pasos de la operación original, con la excepción de Salesforce, Salesforce Service Cloud y actividades de ServiceMax, que son duplicadas.
• Con Copias de Paso: Crea una nueva operación independiente y nuevos componentes independientes referenciados como pasos de operación. Se crean nuevos componentes para cada paso de operación y son referenciados por la nueva operación.

Si la operación se crea desde el lienzo de diseño, la nueva operación también se referencia en el flujo de trabajo del proyecto. La nueva operación se muestra inmediatamente debajo de la operación original y el cursor se posiciona en el nombre de la operación para renombrarla.

Crear una referencia de componente

Una operación puede ser referenciada por otros componentes o flujos de trabajo del proyecto en todo el proyecto.

Una operación puede ser referenciada múltiples veces por cualquier combinación de otros componentes. Sin embargo, solo puede ser referenciada una sola vez en un solo flujo de trabajo. Una operación no puede ser referenciada múltiples veces en el mismo flujo de trabajo, ni puede ser referenciada en múltiples flujos de trabajo.

Referenciar una operación

Puedes referenciar la misma operación múltiples veces en múltiples lugares a lo largo de un proyecto, como se describe a continuación.

Configurar una acción de operación

Selecciona una operación al configurar una acción de operación en otra operación. La misma operación puede ser el sujeto de acciones que están configuradas para ejecutarse en caso de éxito, fallo o error SOAP de cualquier número de otras operaciones en el mismo proyecto.

Llamar a una operación

Una operación puede ser llamada cualquier número de veces utilizando uno de estos métodos:

1. La herramienta Invocar Operación como un paso en una operación.

2. Una operación con un Script de Jitterbit Función General que toma una ruta de referencia de operación como parámetro, como RunOperation o GetLastOperationRunStartTime.

Arrastrar y soltar

Arrastra una operación que no está actualmente en un flujo de trabajo desde la pestaña Componentes del panel del proyecto a un flujo de trabajo abierto en el lienzo de diseño:

Aunque las operaciones no pueden ser referenciadas por más de un flujo de trabajo, una sola operación puede estar en un flujo de trabajo único y ser referenciada por una o múltiples acciones de operación y/o funciones (independientemente de cualquier asociación con operaciones que pueden o no estar en los mismos o diferentes flujos de trabajo).

Una operación puede aparecer solo una vez en el lienzo de diseño de un proyecto.

Paste

Una vez que tengas una copia de una operación en tu portapapeles, puedes pegarla en el mismo proyecto utilizando la aplicación de navegador actual o el modo de navegador desde donde la copiaste. No se admite pegar operaciones como referencias entre proyectos y modos de navegador.

Corta o copia una operación y luego pega la operación en el lienzo de diseño utilizando la acción de menú Pegar desde el menú de acciones de la zona de caída de la operación (ver Menú de acciones de la zona de caída en Lienzo de diseño). Si un componente de operación se pega una sola vez en el lienzo de diseño, se crea un nuevo componente independiente y se agrega una referencia a ese componente en el flujo de trabajo del proyecto. Pegar la misma operación varias veces agrega una referencia adicional a la operación recién creada en el flujo de trabajo del proyecto.

Ver el número de referencias de componentes y flujos de trabajo

Las referencias de componentes y flujos de trabajo se cuentan y se muestran dentro de la pestaña Componentes del panel del proyecto. El conteo depende de cuántas veces se referencia el componente en los flujos de trabajo de un proyecto.

• Sin Referencias

  Si una operación no es referenciada (utilizada) por ninguno de los flujos de trabajo del proyecto, se conoce como una operación no utilizada. Los componentes no utilizados, incluidas las operaciones, se muestran en el panel del proyecto con un ícono de no referenciado junto al nombre del componente.

  Por ejemplo, después de duplicar una operación del panel del proyecto, no aparece en un flujo de trabajo en el lienzo de diseño:

  

• Una Sola Referencia

  Si una operación es referenciada solo una vez en el lienzo de diseño, se muestra sin ningún indicador visual junto al nombre del componente.

  Por ejemplo, estas operaciones están contenidas en un flujo de trabajo:

  

• Múltiples Referencias

  Si una operación es referenciada múltiples veces en el lienzo de diseño, el número de componentes de flujo de trabajo del proyecto y/o flujos de trabajo por los que es referenciada se muestra en una insignia junto al nombre del componente.

  En este ejemplo, Example Operation y Second Example Operation están cada una en un flujo de trabajo y cada una tiene una acción de operación configurada para llamar a Example Operation - Copy, que es parte del flujo de trabajo por referencia, resultando en dos conteos de referencia:

  

  El conteo no es necesariamente el número de veces que la operación es referenciada; si una operación es referenciada múltiples veces por otro componente, esto puede contar como una o múltiples referencias, dependiendo de cómo se referenció la operación. Las acciones de operación configuradas cuentan cada una como una referencia, pero las múltiples referencias por componentes que no son operaciones no se agregan en el conteo total.

Por ejemplo:

• Un script que hace referencia a una operación dos veces por su ruta de referencia en un script — quizás utilizando tanto las funciones GetLastOperationRunStartTime como RunOperation — cuenta la referencia de la operación solo una vez.

• Una operación configurada para ejecutar una operación tanto en caso de éxito como en caso de falla de la operación cuenta la referencia de la operación dos veces.

Aunque no hay una indicación visual en el panel del proyecto de que las acciones de operación están configuradas, se puede determinar cómo están vinculadas las operaciones al ver las dependencias o iniciar el diálogo de eliminación de la operación, como se describe en Dependencias de operación, eliminación y remoción.

Por ejemplo, cuando se ven las dependencias de Ejemplo de Operación y Segunda Ejemplo de Operación, se verá que Ejemplo de Operación - Copia depende de las dos primeras operaciones. Cuando se intenta eliminar Ejemplo de Operación - Copia, se verá que Ejemplo de Operación y Segunda Ejemplo de Operación están listados como componentes que impiden que Ejemplo de Operación - Copia pueda ser eliminada.