Reutilización de Componentes¶

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. El reconocimiento de la diferencia entre componentes independientes y referencias a esos componentes constituye la base necesaria para comprender los términos de la interfaz de usuario relacionados:
  • Duplicar un componente para crear una copia
  • Hacer referencia a 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 puede cortar y copiar componentes. Cortar un componente también elimina el componente o su referencia del proyecto, según el lugar desde el que se haya cortado.
• Crear un nuevo componente a partir de un componente existente
  En esta sección se describen las distintas formas en las que se puede crear un nuevo componente a partir de un componente existente. Normalmente, esto se hace duplicando un componente existente o cortando/copiando y pegando en ubicaciones designadas. Ciertos tipos de actividades (Salesforce, Salesforce Service Cloud y actividades de ServiceMax) siempre da como resultado un nuevo componente cuando se pega, ya que no se permite reutilizar más de una instancia de la misma actividad de estos tipos.
• Creación de una instancia de actividad
  Esta sección describe las distintas formas en las que puede crear una instancia de actividad como un componente nuevo e independiente. Esto se hace arrastrando y soltando o cortando/copiando y pegando en las ubicaciones designadas.
• Crear una referencia de componente
  En esta sección se describen las distintas formas en las que se pueden hacer referencias a componentes. Algunos componentes se pueden utilizar como pasos de operación, mientras que otros tipos de componentes se pueden utilizar como soporte de operaciones. Se puede hacer referencia a la mayoría de estos tipos de componentes 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.

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 Cloud 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 de componentes hacen referencia a los componentes independientes. Las referencias de componentes en los flujos de trabajo del proyecto se encuentran en el tela de diseño y en la pestaña 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 componente nuevo e independiente en un proyecto. Después de duplicar un componente, los cambios que realice en el componente independiente original no se reflejarán en la copia y los cambios que realice en la copia no afectarán al componente independiente original. Cuando duplica un componente, aparece un nuevo componente en la pestaña Componentes del panel del proyecto y es un componente independiente en el 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 en que se crean 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 un etapa de operación en un flujo de trabajo de proyecto, y también se puede hacer referencia a ella en una secuencia de comandos que no esté referenciada 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 no se modifica.
• Copiando coloca una copia de un componente o tipo de actividad en el portapapeles. El componente independiente original no se modifica. Copiar y pegar un componente puede generar un nuevo componente independiente o una referencia de componente, según el contexto en el que se pegue.
• Pegar crea un componente independiente o una referencia de componente, según el contexto en el que se pegue. 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 (vea 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 del tipo de actividad en paleta de componentes de diseño).

También puedes utilizar 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 coloca una copia de un 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 utilizará para crear un nuevo componente en el proyecto (una instancia de actividad).

Al cortar un componente independiente del proyecto (desde la pestaña Componentes del panel del proyecto), se elimina el componente independiente original del proyecto. Como la eliminación es obligatoria, solo es posible cortar un componente en componentes sin referencia. Los cuadros de diálogo estándar para la eliminación se muestran como se documenta en Dependencias, eliminación y remoción de componentes.

Al cortar 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 de 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, secuencias de comandos, transformaciones, 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 formas adicionales de crear nuevos 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 utiliza el nombre del componente independiente original con el texto - Copia como anexo. Las copias posteriores se añaden con un número incrementado entre paréntesis. Como los nombres de las variables de proyecto no pueden tener espacios, guiones ni paréntesis, el nombre predeterminado de una variable de proyecto duplicada no utiliza paréntesis y utiliza un guión bajo en lugar de espacios y guiones.

Pegar¶

Una vez que tenga una copia de un componente en su portapapeles, puede pegarlo en el mismo proyecto usando la aplicación del navegador actual o el modo del navegador desde donde lo copió.

También se puede pegar un componente (excepto los que se indican a continuación) 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 operaciones posteriores de pegado en el mismo proyecto se conectarán al extremo existente.

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 de proyecto (vea 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 de 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.

Duplicar¶

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, utilizando 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 use su acción de menú Pegar (vea 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 use 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ña Componentes 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¶

Puede crear una instancia de actividad como un componente nuevo e independiente arrastrándola y soltándola (consulte Arrastrar y soltar a continuación) o utilizando una combinación de Copiar (vea Cortar y cortar componentes arriba) y las acciones del menú Pegar (vea Pegar a continuación) o sus atajos de teclado.

Arrastrar y Soltar¶

Arrastre un tipo de actividad desde la paleta de componentes de diseño Extremos y conectores del proyecto o extremos globales pestañas a una operación en el tela de diseño:

Pegar¶

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

Una vez que haya copiado el tipo de actividad, puede pegarlo en el mismo proyecto utilizando la aplicación o el modo de navegador actual desde el que lo copió. No se admite 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 use su acción de menú Pegar (vea 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 use 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 se pueden utilizar como pasos de operación, incluidas las actividades, los secuencias de comandos y las transformaciones. Se pueden utilizar otros tipos de componentes como apoyo a las operaciones. Se puede hacer referencia a la mayoría de estos tipos de componentes varias veces, como se explica a continuación.

Componentes Utilizados Como Pasos de Operación¶

Se puede hacer referencia a ciertos tipos de actividades, transformaciones y secuencias de comandos varias veces como pasos en una operación:

• Actividades: La mayoría de las actividades pueden ser referenciadas varias veces como pasos de la 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 hacer una copia de una actividad de Salesforce, Salesforce Service Cloud o ServiceMax para usarla en otro lugar.
• Transformaciones: Se puede hacer referencia a todas las transformaciones varias veces como pasos de una operación. Al hacer referencia a una transformación mediante 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.
• Secuencias de Comandos: Todos los secuencias de comandos de componentes del proyecto pueden ser referenciados varias veces como pasos de operació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ña Componentes del panel del proyecto a una operación en el tela de diseño:

Pegar¶

Una vez que tenga una copia de un componente en el portapapeles, puede pegarlo en el mismo proyecto utilizando la aplicación del navegador actual o el modo del navegador desde el que lo copió. No se permite pegar referencias de componentes entre proyectos y modos del 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).
• Utilice 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 se pueden utilizar como pasos en una operación se pueden reutilizar o referenciar de otras maneras. La reutilización de componentes en apoyo de 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 se pueden leer cualquier cantidad de veces

Ver el Número de Referencias de Componentes¶

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

Si ninguna de las operaciones dentro de los flujos de trabajo de un proyecto hace referencia a un componente, se lo 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 están 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, se hace referencia al primer secuencia de comandos tanto dentro de una operación de flujo de trabajo como mediante otro secuencia de comandos dentro de una operación de flujo de trabajo, y se hace referencia al segundo secuencia de comandos mediante un secuencia de comandos adicional dentro de una operación de flujo de trabajo:

Este recuento no es necesariamente la cantidad de veces que se hace referencia al componente; si un componente hace referencia a un componente varias veces, esto cuenta 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 considera 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 considera como si hubiera sido referenciada solo una vez.