Reutilizar componentes del proyecto en Jitterbit Integration Studio

Introducción

Esta página describe cómo reutilizar los componentes del proyecto que se utilizan como pasos de operación o en apoyo de las operaciones.

Esta página está organizada en estas 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 referencias a estos constituye la base necesaria para comprender los términos de interfaz de usuario relacionados:
  • Duplicar un componente para crear una copia
  • Referenciar un componente existente
  • Cortar o copiar componentes para colocarlos en el portapapeles
  • Pegar como un nuevo componente o como una referencia según el contexto
• Cortar y copiar componentes
  Esta sección describe los distintos lugares desde los que se pueden cortar y copiar componentes. Cortar un componente también elimina el componente o su referencia del proyecto, dependiendo de dónde se haya cortado.
• Crear un nuevo componente a partir de uno existente
  Esta sección describe las distintas maneras de crear un nuevo componente a partir de uno existente. Normalmente, esto se hace duplicando un componente existente o copiando y pegando en ubicaciones designadas. Ciertos tipos de actividades (Salesforce, Salesforce Service Cloud y actividades de ServiceMax) siempre genera un nuevo componente al pegarlo, ya que no se permite reutilizar más de una instancia de la misma actividad.
• Creación de una instancia de actividad o herramienta
  Esta sección describe las distintas maneras de crear una instancia de una actividad o herramienta como un nuevo componente independiente. Esto se hace arrastrando y soltando o cortando/copiando y pegando en las ubicaciones designadas.
• Crear una referencia de componente
  Esta sección describe las distintas maneras de referenciar componentes. Algunos componentes pueden utilizarse como pasos de operación, mientras que otros pueden utilizarse como apoyo a las operaciones. La mayoría de estos tipos de componentes pueden referenciarse varias veces.

Los detalles sobre cómo hacer referencia a una transformación que utiliza un esquema heredado de una actividad se proporcionan como complemento a esta página en [Reutilización de Transformación](/es/integration-studio/design/transformations/basics/reuse`La reutilización de operaciones se trata en Reutilización de operaciones.

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.

Un componente independiente se puede reutilizar en un proyecto de dos maneras:

• Duplicando utiliza la configuración de un componente existente para crear un nuevo componente independiente en un proyecto. Tras duplicar un componente, 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 un componente, este aparece en la pestaña Componentes del panel del proyecto y se convierte en un componente independiente del proyecto. Un componente también se puede pegar entre proyectos abiertos en la misma sesión del navegador.
• Referencia utiliza el mismo componente más de una vez en un proyecto y es la forma de crear flujos de trabajo de proyectos. Una referencia de 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 correo). Las referencias de 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 variable de proyecto en la configuración de una actividad utilizada como etapa de operación en un flujo de trabajo de proyecto y también se puede hacer referencia a ella en un secuencia de comandos que no esté referenciado por ningún flujos de trabajo de proyecto. 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 un componente existente.

Las palabras cortar y copiar, como acciones, colocan una copia de un componente en el portapapeles, que luego 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 un componente en el portapapeles y elimina el componente independiente original o la referencia del componente, dependiendo de dónde se cortó el componente:
  • Si se corta un componente de la pestaña Componentes del panel del proyecto, se elimina el componente independiente original.
  • Si se corta un componente del tela 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 permanece sin cambios.
• Copiando copia un componente o tipo de actividad en el portapapeles. El componente independiente original permanece intacto. Copiar y pegar un componente puede generar un nuevo componente independiente o una referencia de componente, según el contexto al pegarlo. Al pegar, se crea un componente independiente o una referencia de componente, según el contexto. Por ejemplo:
  • Pegar un componente o tipo de actividad en la pestaña Componentes del panel del proyecto crea un nuevo componente independiente. Pegar un tipo de actividad crea una instancia de actividad como un componente nuevo e independiente.
  • Pegar un componente en el tela de diseño agrega una referencia al componente independiente original en el flujo de trabajo del proyecto. (Una excepción: pegar un Salesforce, Salesforce Service Cloud, o actividad de ServiceMax en el tela de diseño crea un componente nuevo e independiente en lugar de una referencia de componente).
  • Pegar un tipo de actividad en el tela de diseño o en la pestaña Flujos de trabajo del panel del proyecto crea una instancia de actividad como un componente nuevo e independiente y agrega una referencia a esa actividad en el flujo de trabajo del proyecto.

Cortar y copiar componentes

Puede acceder a las acciones del menú Cortar y Copiar desde el menú de acciones de un componente o tipo de actividad 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).
• Tipos de actividad en la pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte menú de acciones de conexión y menú de acciones de tipo de actividad en paleta de componentes de diseño).

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).

Al cortar y copiar componentes, se crea una copia del componente en el portapapeles. Los tipos de actividad también se pueden copiar desde la paleta de componentes de diseño; la copia en el portapapeles se usará para crear un nuevo componente en el proyecto (una instancia de actividad).

Al eliminar un componente independiente 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 componentes sin referencia. Los diálogos estándar para la eliminación se muestran como se describe en Dependencias, eliminación y remoción de componentes.

Al eliminar una referencia de componente 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 un nuevo componente a partir de un componente existente

La creación de un componente nuevo e independiente a partir de un componente independiente existente está disponible para esquemas, actividades, herramientas, variables de proyecto, notificaciones correo y programaciones.

Puede crear un nuevo componente a partir de estos componentes existentes utilizando una combinación de las acciones del menú Cortar o Copiar (consulte Copiar y cortar componentes arriba) y Pegar (vea Pegar a continuación) (o sus atajos de teclado) o utilizando la acción de menú Duplicar (vea Duplicar a continuación). Hay otras formas de crear nuevas Salesforce, Salesforce Service Cloud y actividades de ServiceMax (consulte Actividades de Salesforce, Salesforce Service Cloud y ServiceMax a continuación).

El nombre predeterminado del nuevo componente usa el nombre del componente independiente original, con - Copia como complemento. Las copias posteriores se añaden con un número incremental entre paréntesis. Dado que los nombres de las variables de proyecto no pueden contener espacios, guiones ni paréntesis, el nombre predeterminado de una variable de proyecto duplicada no usa paréntesis y usa un guion bajo en lugar de espacios y guiones.

Pegar

Una vez que tengas una copia de un componente en el portapapeles, puedes pegarla en el mismo proyecto usando la aplicación o el modo de navegador actual desde el que la copiaste.

Un componente (excepto los que se indican a continuación) también se puede pegar entre proyectos abiertos en la misma sesión del navegador. Al pegar actividades entre proyectos, se creará un nuevo extremo la primera vez que se pegue la actividad. Las posteriores operaciones de pegado en el mismo proyecto se conectarán al extremo existente.

Una conexión o 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 las conexiones o actividades creadas desde un conector personalizado se pueden pegar en un proyecto donde no existe el conector personalizado. Además, conexiones globales y las actividades asociadas a ellas no se pueden pegar entre proyectos.

Cortar o copiar un componente y luego use la acción de menú Pegar del menú de acciones de la paleta de componentes en la pestaña Componentes del panel del proyecto (consulte menú de acciones de la pestaña Componentes en la pestaña Componentes del panel Proyecto). Esta acción está disponible en las categorías Archivos, Extremos, Secuencias de comandos, Transformaciones, Variables del proyecto, Correos y Programaciones, y está habilitada solo cuando tiene un componente del tipo correspondiente en su portapapeles.

Al crear el nuevo componente, el cursor se posiciona en el nombre del componente para cambiarle el nombre.

Duplicado

Puede acceder a la acción de menú Duplicar de un componente en el proyecto desde el menú de acciones de un componente en la pestaña Componentes del panel del proyecto (consulte menú de acciones del componente en la pestaña Componentes del panel Proyecto).

Al hacer clic en Duplicar, se crea un nuevo componente independiente sin referencias, con la misma configuración que el componente independiente original.

Actividades de Salesforce, Salesforce Service Cloud y ServiceMax

Para Salesforce, Salesforce Service Cloud y actividades de ServiceMax, también puedes pegar la actividad en el tela de diseño para crear un componente nuevo e independiente de una de estas maneras:

• Seleccione una área de inserció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) para crear una instancia de actividad en el proyecto y agregar una referencia a esa instancia de actividad en el flujo de trabajo del proyecto.
• Seleccione una área de inserción en el tela de diseño y luego utilice el atajo de teclado Control+V (Windows o Linux) o Command+V (macOS) para crear una instancia de actividad en el proyecto y agregar una referencia a esa instancia de actividad en el flujo de trabajo del proyecto.

También puede arrastrar una actividad existente de Salesforce, Salesforce Service Cloud o ServiceMax desde la pestañaComponentes del panel del proyecto a una área de inserción de componentes en el tela de diseño.

Al colocar la actividad en el tela de diseño, un cuadro de diálogo indica que se creará un nuevo componente independiente:

Crear una instancia de actividad o herramienta

Puedes crear una instancia de una actividad o herramienta como un nuevo componente independiente arrastrando y soltando (consulta Arrastrar y soltar a continuación) o utilizando una combinación de Copiar (vea Corte y componentes de corte arriba) y las acciones del menú Pegar (vea Pegar a continuación) o sus atajos de teclado.

Arrastrar y soltar

Arrastre una actividad o tipo de herramienta desde la paleta de componentes de diseño Extremos y conectores del proyecto, extremos globales o Herramientas pestañas a una área de inserción dentro de un flujo de trabajo:

Pegar

Al copiar un tipo de actividad, esta copia se utiliza para crear un nuevo componente independiente en el proyecto (una instancia de actividad).

Una vez copiado el tipo de actividad, puede pegarlo en el mismo proyecto usando la aplicación o el modo de navegador actual desde el que lo copió. No se permite pegar tipos de actividad entre proyectos y modos de navegador.

Copiar un tipo de actividad y luego péguelo (creando una instancia de actividad como un componente independiente) de una de estas maneras:

• Utilice la acción de menú Pegar actividad a la que se puede acceder desde el menú de acciones de la pestaña Componentes en la pestaña Componentes del panel del proyecto (consulte menú de acciones de la pestaña Componentes en la pestaña Componentes del panel Proyecto) para crear una instancia de actividad en el proyecto.
• Seleccione una área de inserció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) para crear una instancia de actividad en el proyecto y agregar una referencia a esa instancia de actividad en el flujo de trabajo del proyecto.
• Seleccione una área de inserción en el tela de diseño y luego utilice el atajo de teclado Control+V (Windows o Linux) o Command+V (macOS) para crear una instancia de actividad en el proyecto y agregar una referencia a esa instancia de actividad en el flujo de trabajo del proyecto.

Crear una referencia de componente

Ciertos tipos de componentes, como actividades y herramientas, pueden utilizarse como pasos de operación. Otros tipos de componentes pueden utilizarse como apoyo a las operaciones. La mayoría de estos tipos de componentes pueden referenciarse varias veces, como se explica a continuación.

Componentes utilizados como pasos de operación

Ciertos tipos de actividades y herramientas se puede hacer referencia varias veces como pasos en una operación:

• Actividades: La mayoría de las actividades pueden referenciarse varias veces como pasos de una operación. Las excepciones incluyen Salesforce, Salesforce Service Cloud y actividades de ServiceMax, a la que no puede hacer referencia más de un componente. En su lugar, puede crear una copia de una actividad de Salesforce, Salesforce Service Cloud o ServiceMax para usarla en otro lugar.

• Herramientas: Todas las herramientas (transformaciones, secuencias de comandos y herramientas de Control de flujo) se pueden referenciar varias veces como pasos de operación.

  Nota

  Al hacer referencia a una transformación utilizando un esquema heredado de una actividad, el orden en el que se configuran los pasos de una operación controla cómo se propagan los esquemas a través de las referencias de transformación, como se describe en Reutilización de Transformación.

Puede crear una referencia a uno de estos tipos de componentes como un etapa de operación arrastrando y soltando o utilizando una combinación de las acciones de menú Cortar o Copiar y Pegar o sus atajos de teclado.

Arrastrar y soltar

Arrastre el componente desde la pestañaComponentes del panel del proyecto a una área de inserción dentro de un flujo de trabajo:

Pegar

Una vez que tenga una copia de un componente 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 referencias de componentes entre proyectos ni modos de navegador.

Cortar o copiar un componente, seleccione una área de inserción en el tela de diseño y luego pegue el componente de una de estas maneras:

• Utilice la acción de menú Pegar accesible desde el menú de acciones de la área de inserción en el tela de diseño (consulte menú de acciones de la zona de colocación en Lienzo de diseño).
• Usa el atajo de teclado Control+V (Windows o Linux) o Command+V (macOS).

Componentes utilizados en apoyo de una operación

La mayoría de los componentes que no pueden utilizarse como pasos en una operación pueden reutilizarse o referenciarse de otras maneras. La reutilización de componentes para facilitar las operaciones se describe en la documentación de cada componente:

• Extremos: Extremos en Jitterbit Script, para utilizar ciertos tipos de conexiones y actividades existentes como argumentos con funciones Jitterbit
• Notificaciones: Notificaciones Correo, para vincular un mensaje de correo existente en múltiples cadenas de operación
• Operaciones: Operaciones en Jitterbit Script, para usar operaciones existentes como argumentos con funciones Jitterbit
• Horarios: Horarios de operaciones, para aplicar los horarios existentes a múltiples operaciones
• Esquemas: esquema de archivo de muestra, para seleccionar un esquema guardado durante la definición del esquema
• Secuencias de comandos: Secuencias de comandos en Jitterbit Script, para usar secuencias de comandos existentes como argumentos con funciones Jitterbit
• Variables: Variables, para hacer referencia a variables que pueden leerse indefinidamente.

Ver el número de referencias de componentes

Las referencias de componentes se cuentan y se muestran dentro de la pestañaComponentes del panel del proyecto.

Si ninguna de las operaciones dentro de los flujos de trabajo de un proyecto hace referencia a un componente, se denomina componente no utilizado. Los componentes no utilizados se muestran con un Icono sin referencia junto al nombre del componente.

Por ejemplo, estas dos nuevas secuencias de comandos no son referenciadas por ninguna operación de flujo de trabajo:

Si se hace referencia a un componente solo una vez en el tela de diseño, se muestra en el panel del proyecto sin ningún indicador visual junto al nombre del componente.

Por ejemplo, estos secuencias de comandos se utilizan cada uno dentro de una única operación de flujo de trabajo:

Si se hace referencia a un componente varias veces en el tela de diseño, incluso dentro de otros componentes utilizados en el tela de diseño, la cantidad de veces que se hace referencia a él se muestra en una insignia junto al nombre del componente.

En este ejemplo, el primer secuencia de comandos es referenciado tanto dentro de una operación de flujo de trabajo como por otro secuencia de comandos dentro de una operación de flujo de trabajo, y el segundo secuencia de comandos es referenciado por un secuencia de comandos adicional dentro de una operación de flujo de trabajo:

Este recuento no es necesariamente el número de veces que se hace referencia al componente; si un componente hace referencia a otro varias veces, se contabiliza como una sola referencia. Por ejemplo:

• Una variable de proyecto a la que se hace referencia varias veces dentro de un secuencia de comandos se cuenta como si hubiera sido referenciada solo una vez.
• Una variable de proyecto a la que se hace referencia varias veces dentro de una configuración de actividad se cuenta como si hubiera sido referenciada solo una vez.