Operaciones de reutilización 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 explica 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 analizar la reutilización de componentes. Reconocer la diferencia entre componentes independientes y las referencias a estos constituye la base para comprender 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 etapa de operación o copias de etapa de operación
- Referenciar una operación existente
- Operaciones de corte o copia para colocarlas en el portapapeles
- Pegar como nueva operación o como referencia según el contexto
- Operaciones de cortar y copiar
Esta sección describe los distintos lugares desde donde se pueden cortar y copiar operaciones. Cortar una operación también la elimina del proyecto, o su referencia, según su origen. - Crear una nueva operación a partir de una operación existente
Esta sección describe las distintas maneras de crear una nueva operación a partir de una operación. Esto se hace duplicando una operación existente o cortando/copiando y pegando en las ubicaciones designadas. Puede crear una copia de una operación con referencias de pasos (excepto para ciertos tipos de actividad) o con copias de pasos. Copias de operaciones con Salesforce, Salesforce Service Cloud y actividades de ServiceMax siempre crea esas actividades como nuevas actividades en lugar de referencias, ya que no se permite reutilizar más de una instancia de la misma actividad. - Crear una referencia de componente
Esta sección describe las distintas maneras de referenciar operaciones. Se puede hacer referencia a las operaciones varias veces mediante cualquier combinación de otros componentes. Sin embargo, solo se puede hacer referencia a ellas una 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 están contenidos en la pestaña Componentes del panel del proyecto). Los componentes independientes son los componentes del proyecto. Las referencias a componentes remiten a los componentes independientes. Las referencias a componentes en los flujos de trabajo del proyecto se encuentran en el tela de diseño y en la pestaña pestaña de Flujos de trabajo del panel del proyecto.. Los componentes que no forman parte de ningún flujos de trabajo también pueden hacer referencia a ellos.
Una operación como componente independiente se puede reutilizar en un proyecto de dos maneras:
-
Duplicando utiliza la configuración de una operación existente para crear un nuevo componente independiente en un proyecto. Tras duplicar una operación, los cambios realizados en el componente independiente original no se reflejarán en la copia, y los cambios realizados en la copia no afectarán al componente independiente original. Al duplicar una operación, la nueva operación aparece en la pestaña Componentes del panel del proyecto y se convierte en un componente independiente del proyecto.
Puede duplicar una operación 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 referenciarse.)
- Una operación duplicada con copias de pasos crea copias de cada etapa de operación original como nuevos componentes.
También se puede pegar una operación entre proyectos abiertos en la misma sesión del navegador.
-
Referencia utiliza la misma operación más de una vez en un proyecto y es la forma de crear flujos de trabajo de proyectos. Una referencia a un componente en un flujo de trabajo es una operación, actividad, transformación, secuencia de comandos o notificación correo que se representa visualmente en el tela de diseño y aparece en la pestaña Flujos de trabajo del panel del proyecto (excepto las notificaciones por correo). Las referencias a componentes también pueden estar en otros componentes, que pueden estar o no en flujos de trabajo de proyectos. Por ejemplo, se puede hacer referencia a una operación en una acción de operación configurada en otra operación, y también en una función de secuencia de comandos, y también en un solo flujo de trabajo de proyectos. Cuando se hace referencia a un componente dentro o fuera de los flujos de trabajo de proyectos, aumenta el recuento de referencias del componente en la pestaña Componentes del panel del proyecto.
La palabra copia, como sustantivo, se utiliza para describir un componente nuevo e independiente que se ha creado a partir de una operación existente.
Las palabras cortar y copiar, como acciones, copian una operación en el portapapeles, la cual se utiliza para crear un componente independiente o una referencia de componente. Cuál de estos dos se crea depende del contexto al pegar:
- Corte coloca una copia de una operación en el portapapeles y elimina el componente independiente original o la referencia del componente, dependiendo de dónde se cortó la operación:
- Si se corta una operación desde la pestaña Componentes del panel del proyecto, se elimina el componente independiente original.
- Si se corta una operación desde el tela de diseño o desde 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 permanece sin cambios.
- Copiando copia una operación en el portapapeles. El componente independiente original permanece intacto. Copiar y pegar una operación puede generar un nuevo componente independiente o una referencia a un componente, según el contexto al pegar. Al pegar, se crea un componente independiente o una referencia de componente, según el contexto. 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 tela de diseño crea un nuevo componente independiente con referencias de pasos (excepto Salesforce, Salesforce Service Cloud y actividades de ServiceMax, que se duplican) y se agrega una referencia a esa operación al 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.
Operaciones de cortar y copiar
Puede 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 (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
- Referencias de componentes en el tela de diseño (vea menú de acciones de componentes en Lienzo de diseño).
- Referencias de componentes en la pestaña Flujos de trabajo del panel del proyecto (consulte menú de acciones de componentes en la pestaña Flujos de trabajo del panel 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).
Tanto las operaciones de cortar como de copiar colocan una copia de una operación en el portapapeles.
Nota
Cuando se activa la política de la organización Agregar las credenciales requeridas al portapapeles al copiar está deshabilitado, los componentes con credenciales de extremo no se pueden cortar ni copiar entre organizaciones.
Al eliminar una operación del proyecto (desde la pestaña Componentes del panel del proyecto), se elimina el componente independiente original. Dado que la eliminación es obligatoria, solo se pueden eliminar operación sin referencia. Los diálogos estándar para la eliminación se muestran como se describe en Dependencias de operaciones, eliminación y remoción.
Al eliminar una operación de un flujo de trabajo de proyecto (desde el tela de diseño o la pestaña Flujos de trabajo del panel del proyecto), se elimina únicamente la referencia del componente. El componente independiente original permanece sin cambios.
Crear una nueva operación a partir de una operación existente
Puede crear una nueva operación como 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 utilizar 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 todos los horarios asignados.
- Se eliminan todas las operaciones configuradas.
Al utilizar la acción de menú Duplicar, se crea una nueva operación utilizando la misma configuración que la operación original, incluidos todos los programas 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 añaden 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 usando la aplicación del navegador actual o el modo del navegador desde donde la copió.
Nota
Cuando se activa la política de la organización Agregar las credenciales requeridas al portapapeles al copiar está deshabilitado, las operaciones con credenciales de extremo no se pueden pegar entre organizaciones.
Una operación (excepto las que se indican 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 extremo la primera vez que se pegue la operación con una actividad. Las operaciones posteriores se conectarán al extremo existente.
Nota
Una operación con un paso como actividad, que solo se puede usar en agentes privados, no se puede pegar en un proyecto en un ambiente asociado a un agente en la nube. Tampoco se pueden pegar operaciones con pasos como actividades creadas desde un conector personalizado se pueden pegar en un proyecto donde no existe el conector personalizado. Además, las operaciones con pasos como actividades asociadas a una conexiones globales no se puede pegar entre proyectos.
Importante
Problema conocido: La función de pegar entre proyectos no funciona actualmente con Firefox. Solo se puede usar Chrome o Safari (solo macOS ) para pegar entre proyectos.
Cortar o copiar una operación y luego pegue la operación en la pestaña Componentes del panel del proyecto o en el tela de diseño:
- Pestaña Componentes del Panel Proyecto: Utilice la acción de menú Operación Pegar del menú de acciones de una categoría de componente (consulte menú de acciones de la pestaña Componentes en la pestaña Componentes del panel Proyecto). Esta acción solo está habilitada cuando tienes una operación en tu portapapeles.
- Tela de diseño: Seleccione la área de inserción de una operación en el tela de diseño y luego utilice su acción de menú Pegar (consulte menú de acciones de la zona de colocación en Lienzo de diseño). Si un componente de operación se pega una sola vez en el tela de diseño, se crea un componente nuevo e independiente y se agrega una referencia a ese componente al flujo de trabajo del proyecto.
Al crear una nueva operación, el cursor se posiciona en el nombre de la operación para cambiarle el nombre.
Duplicado
Puede 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 (consulte menú de acciones de componentes en la pestaña Componentes del panel Proyecto) o el tela de diseño.
La acción de menú Duplicar ofrece la posibilidad de elegir entre dos métodos de duplicación:
Con referencias de pasos: Crea únicamente una nueva operación independiente. La operación duplicada contiene referencias a cada uno de los pasos de la operación original, excepto a Salesforce, Salesforce Service Cloud y actividades de ServiceMax, que están duplicados. Con copias de pasos: Crea una nueva operación independiente y nuevos componentes independientes, referenciados como pasos de la operación. Se crean nuevos componentes para cada etapa de operación y son referenciados por la nueva operación.
Si la operación se crea desde el tela de diseño, también se referencia en el flujo de trabajo del proyecto. La operación operación muestra justo debajo de la operación y el cursor se posiciona sobre 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 durante todo el proyecto.
Una operación puede ser referenciada varias veces por cualquier combinación de otros componentes. Sin embargo, solo se puede referenciar una vez en un único flujo de trabajo. Una operación no puede ser referenciada varias veces en el mismo flujo de trabajo ni en varios flujos de trabajo.
Hacer referencia a una operación
Puede hacer referencia a la misma operación varias veces en varios lugares a lo largo de un proyecto como se describe a continuación.
Configurar una acción de operación
Seleccione una operación al configurar una acción de operación en otra operación. La misma operación puede ser objeto de acciones configuradas para ejecutarse en caso de éxito, fallo o error SOAP de cualquier otra operación en el mismo proyecto.
Llamar a una operación
Una operación se puede llamar cualquier cantidad de veces utilizando uno de estos métodos:
-
La Operación de invocación herramienta como paso en una operación.
-
Una operación con un Jitterbit Script Función general que toma una ruta de referencia de operación como parámetro, como por ejemplo
RunOperation
oGetLastOperationRunStartTime
.
Arrastrar y soltar
Arrastre una operación que no esté actualmente en un flujo de trabajo desde la pestañaComponentes del panel del proyecto a un flujo de trabajo abierto en el tela de diseño:
Consejo
Mientras arrastra una operación por el tela de diseño, puede realizar estas acciones:
- Use la tecla de escape ESC en su teclado para cancelar el movimiento.
- Cambie de flujos de trabajo colocando el cursor sobre la pestaña de un flujo de trabajo abierto.
Si bien las operaciones no pueden ser referenciadas por más de un flujo de trabajo, una sola operación puede estar en un solo flujo de trabajo y ser referenciada por una o más acciones y/o funciones de operación (independientemente de cualquier asociación con operaciones que puedan o no estar en el mismo flujos de trabajo o en diferentes).
Una operación solo puede aparecer una vez en el tela de diseño de un proyecto.
Pegar
Una vez que tenga una copia de una operación en el portapapeles, puede pegarla en el mismo proyecto usando la aplicación o el modo de navegador actual desde el que la copió. No se permite pegar operaciones como referencias entre proyectos y modos de navegador.
Cortar o copiar una operación y luego pegue la operación en el tela de diseño utilizando la acción de menú Pegar del menú de acciones de la zona de colocación de una operación (consulte menú de acciones de la zona de colocación en Lienzo de diseño). Si se pega un componente de operación una sola vez en el tela de diseño, se crea un nuevo componente independiente y se añade una referencia a dicho componente al flujo de trabajo del proyecto. Si se pega la misma operación varias veces, se añade una referencia adicional a la operación recién creada en el flujo de trabajo del proyecto.
Ver la cantidad de referencias de componentes y flujo de trabajo
Las referencias de componentes y flujo de trabajo se cuentan y se muestran dentro de la pestañaComponentes del panel del proyecto. El recuento depende de cuántas veces se hace referencia al componente en los flujos de trabajo de un proyecto.
Nota
La cantidad de referencias se basa en el proyecto tal como existe actualmente en el diseñador de proyectos de Integration Studio y no tiene en cuenta si los componentes se han implementado en Harmony.
-
Sin referencias
Si una operación no está referenciada por (o no se utiliza en) 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 una operación sin referencia. icono junto al nombre del componente.
Por ejemplo, después de duplicar una operación desde el panel del proyecto, no aparece en un flujo de trabajo en el tela de diseño:
-
Una sola referencia
Si se hace referencia a una operación solo una vez en el tela de diseño, se muestra sin ningún indicador visual junto al nombre del componente.
Por ejemplo, estas operaciones están contenidas cada una en un flujo de trabajo:
-
Múltiples referencias
Si se hace referencia a una operación varias veces en el tela de diseño, la cantidad de componentes del flujo de trabajo del proyecto o flujos de trabajo que la hacen referencia se muestra en una insignia junto al nombre del componente.
En este ejemplo, Operación de ejemplo y Operación de segundo ejemplo están cada una en un flujo de trabajo y cada una tiene una acción de operación configurada para llamar a Operación de ejemplo - Copiar, que es parte del flujo de trabajo por referencia, lo que da como resultado dos recuentos de referencia:
El recuento no representa necesariamente el número de veces que se hace referencia a la operación; si otro componente hace referencia a una operación varias veces, esto puede contabilizarse como una o varias referencias, según cómo se haya hecho referencia a la operación. Cada acción de operación configurada cuenta como una referencia, pero las referencias múltiples de componentes no operativos no se suman en el recuento total.
Por ejemplo:
- Un secuencia de comandos que hace referencia a una operación dos veces por su ruta de referencia en un secuencia de comandos, quizás usando ambos `GetLastOperationRunStartTime` y `RunOperation` funciones: cuenta la referencia de operación solo una vez.
- Una operación configurada para ejecutar una operación tanto en caso de éxito como de error de la operación cuenta la referencia de la operación dos veces.
Aunque no hay ninguna indicación visual en el panel del proyecto de que las acciones de operación están configuradas, puede determinar cómo están vinculadas las operaciones al ver las dependencias o iniciar el cuadro de diálogo de eliminación de operación, como se describe en Dependencias de operación, eliminación y remoción.
Por ejemplo, al consultar las dependencias de Example Operation y Second Example Operation, verá que Example Operation - Copy depende de las dos primeras. Al intentar eliminar Example Operation - Copy, verá que Example Operation y Second Example Operation aparecen como componentes, lo que impide eliminar Example Operation - Copy.