Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Reutilize componentes do projeto no Jitterbit Integration Studio

Introdução

Esta página descreve como reutilizar componentes do projeto que são usados como etapas de operação ou em suporte a operações.

Esta página está organizada nas seguintes seções:

  • Terminologia de reutilização de componentes
    Esta seção define a terminologia usada para discutir a reutilização de componentes. O reconhecimento da diferença entre componentes independentes e referências a esses componentes forma a base necessária para a compreensão dos termos de IU relacionados:
    • Duplicar um componente para criar uma cópia
    • Referenciar um componente existente
    • Recortar ou copiar componentes para colocá-los na área de transferência
    • Colar como um novo componente ou como referência, dependendo do contexto
  • Recortar e copiar componentes
    Esta seção descreve os vários locais de onde você pode recortar e copiar componentes. Recortar um componente também o exclui do projeto, ou sua referência, dependendo de onde foi recortado.
  • Criar um novo componente a partir de um componente existente
    Esta seção descreve as várias maneiras de criar um novo componente a partir de um componente existente. Normalmente, isso é feito duplicando um componente existente ou recortando/copiando e colando em locais designados. Certos tipos de atividades (Salesforce, Salesforce Service Cloud e atividades do ServiceMax) sempre resultam em um novo componente quando colados, pois não é permitido reutilizar mais de uma instância igual desses tipos de atividade.
  • Criando uma instância de atividade ou ferramenta
    Esta seção descreve as várias maneiras de criar uma instância de uma atividade ou ferramenta como um novo componente independente. Isso é feito arrastando e soltando ou recortando/copiando e colando nos locais designados.
  • Criar uma referência de componente
    Esta seção descreve as várias maneiras de referenciar componentes. Certos componentes podem ser usados como etapas de operação, enquanto outros tipos de componentes podem ser usados para dar suporte a operações. A maioria desses tipos de componentes pode ser referenciada várias vezes.

Detalhes sobre como referenciar uma transformação que usa um esquema herdado de uma atividade são fornecidos como um suplemento a esta página em Reutilização de Transformação.

A reutilização de operações em si é abordada em Reutilização de operações.

Terminologia de reutilização de componentes

Os componentes do projeto, conforme aparecem na interface do usuário do Integration Studio, podem ser componentes independentes ou referências de componentes:

  • Componentes independentes são os blocos de construção discretos de um projeto e estão contidos na aba Componentes do painel do projeto.. Componentes independentes são os componentes do projeto.
  • Referências de componentes remetem aos componentes independentes. As referências de componentes nos workflows do projeto estão contidas na quadro de design e na guia aba de Workflows do painel do projeto. Os componentes também podem ser referenciados por componentes que não fazem parte de nenhum workflows.

Um componente independente pode ser reutilizado em um projeto de duas maneiras:

  • Duplicando está usando a configuração de um componente existente para criar um novo componente independente em um projeto. Após duplicar um componente, quaisquer alterações feitas no componente independente original não serão refletidas na cópia, e quaisquer alterações feitas na cópia não afetarão o componente independente original. Ao duplicar um componente, um novo componente aparece na aba Componentes do painel do projeto e é um componente independente no projeto. Um componente também pode ser colado entre projetos abertos na mesma sessão do navegador.
  • Referência está usando o mesmo componente mais de uma vez em um projeto e é a maneira como você cria workflows de projeto. Uma referência de componente em um workflow é uma operação, atividade, transformação, script ou notificação por email que é representada visualmente na quadro de design e aparece na aba Workflows do painel do projeto (exceto para notificações por email). As referências de componente também podem estar em outros componentes, que podem ou não estar em workflows do projeto. Por exemplo, uma variável de projeto pode ser referenciada na configuração de uma atividade usada como uma etapa de operação em um workflow de projeto e também pode ser referenciada em um script que não é referenciado por nenhum workflows de projeto. Quando você referencia um componente dentro ou fora dos workflows do projeto, a contagem de referência do componente na aba Componentes do painel do projeto é aumentada.

A palavra cópia, como substantivo, é usada para descrever um componente novo e independente que foi criado a partir de um componente existente.

As palavras recortar e copiar, como ações, colocam uma cópia de um componente na sua área de transferência, que é então usada para criar um componente independente ou uma referência de componente. A criação de um dos dois depende do contexto ao colar:

  • Corte coloca uma cópia de um componente na sua área de transferência e exclui o componente independente original ou a referência do componente, dependendo de onde o componente foi cortado:
    • Se um componente for cortado da aba Componentes do painel do projeto, o componente independente original será excluído.
    • Se um componente for recortado da quadro de design ou da aba Workflows do painel do projeto, como o componente é uma referência a um componente independente original, somente a referência será excluída e o componente independente original permanecerá inalterado.
  • Copiando coloca uma cópia de um componente ou tipo de atividade na sua área de transferência. O componente independente original permanece inalterado. Copiar e colar um componente pode resultar em um novo componente independente ou em uma referência a um componente, dependendo do contexto da colagem.
  • Colar cria um componente independente ou uma referência a um componente, dependendo do contexto da colagem. Por exemplo:

Cortar e copiar componentes

Você pode acessar as ações de menu Recortar e Copiar a partir do menu de ações de um componente ou tipo de atividade em qualquer um destes lugares:

Você também pode usar os atalhos de teclado padrão para cortar (Control+X no Windows ou Linux e Command+X no macOS) e copie (Control+C no Windows ou Linux e Command+C no macOS).

Cortar e copiar componentes coloca uma cópia de um componente na sua área de transferência. Os tipos de atividade também podem ser copiados da paleta de componentes de design; a cópia na área de transferência será usada para criar um novo componente no projeto (uma instância de atividade).

Observação

Quando a opção Adicionar credenciais necessárias à área de transferência ao copiar política da organização estiver desabilitado, componentes com credenciais de endpoint não poderão ser cortados ou copiados entre organizações.

Cortar um componente independente do projeto (na aba Componentes do painel do projeto) exclui o componente independente original do projeto. Como a exclusão é necessária, cortar um componente só é possível em componentes não referenciados. As caixas de diálogo padrão para exclusão são exibidas conforme documentado em Dependências, exclusão e remoção de componentes.

Cortar uma referência de componente de um workflow do projeto (da quadro de design ou da aba Workflows do painel do projeto) exclui apenas a referência do componente. O componente independente original permanece inalterado.

Crie um novo componente a partir de um componente existente

A criação de um novo componente independente a partir de um componente independente existente está disponível para esquemas, atividades, ferramentas, variáveis de projeto, notificações por email e cronogramas.

Você pode criar um novo componente a partir desses componentes existentes usando uma combinação das ações de menu Cortar ou Copiar (consulte Copiando e cortando componentes acima) e Colar (veja Colar abaixo) (ou seus atalhos de teclado) ou usando a ação de menu Duplicar (consulte Duplicar abaixo). Existem maneiras adicionais de criar novos Salesforce, Salesforce Service Cloud e atividades do ServiceMax (consulte Atividades do Salesforce, Salesforce Service Cloud e ServiceMax abaixo).

O nome padrão do novo componente usa o nome do componente independente original, acrescido de - Copy. Cópias subsequentes são adicionadas com um número incrementado entre parênteses. Como os nomes de variáveis de projeto não podem ter espaços, hífens ou parênteses, o nome padrão de uma variável de projeto duplicada não usa parênteses e usa um sublinhado em vez de espaços e hífens.

Colar

Depois de ter uma cópia de um componente na sua área de transferência, você pode colá-lo no mesmo projeto usando o aplicativo de navegador atual ou o modo de navegador de onde o copiou.

Observação

Quando a opção Adicionar credenciais necessárias à área de transferência ao copiar política da organização estiver desabilitado, componentes com credenciais de endpoint não poderão ser colados entre organizações.

Um componente (exceto os indicados abaixo) também pode ser colado entre projetos abertos na mesma sessão do navegador. Ao colar atividades entre projetos, um novo endpoint será criado na primeira vez que a atividade for colada. Colagens subsequentes no mesmo projeto serão conectadas ao endpoint existente.

Nota

Uma conexão ou atividade que pode ser usada apenas em agentes privados não pode ser colada em um projeto em um ambiente associado a um agente de nuvem. Conexões ou atividades criadas a partir de um conector personalizado ser colado em um projeto onde o conector personalizado não existe. Além disso, conexões globais e as atividades associadas a elas não podem ser coladas entre projetos.

Importante

Problema conhecido: A colagem entre projetos não está funcionando no momento usando o navegador Firefox. Somente o Chrome ou o Safari (somente macOS ) podem ser usados para colar entre projetos.

Cortar ou copiar um componente e, em seguida, use a ação de menu Colar no menu de ações da paleta de componentes na aba Componentes do painel do projeto (consulte menu de ações da aba Componentes na aba Componentes do painel Projeto). Esta ação está disponível nas categorias Arquivos, Endpoints, Scripts, Transformações, Variáveis de projeto, Emails e Agendamentos e é habilitada somente quando você tem um componente do tipo correspondente na sua área de transferência.

Ao criar o novo componente, o cursor é posicionado no nome do componente para renomeá-lo.

Duplicado

Você pode acessar a ação de menu Duplicar para um componente no projeto a partir do menu de ações de um componente na aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

Ao clicar em Duplicar, um novo componente independente, sem referência, é criado usando a mesma configuração do componente independente original.

Atividades do Salesforce, Salesforce Service Cloud e ServiceMax

Para Salesforce, Salesforce Service Cloud e atividades do ServiceMax, você também pode colar a atividade na quadro de design para criar um novo componente independente de uma destas maneiras:

  • Selecione uma área de inserção na quadro de design e, em seguida, use a ação de menu Colar (consulte menu de ações da zona de lançamento em Tela de design) para criar uma instância de atividade no projeto e adicionar uma referência a essa instância de atividade no workflow do projeto.
  • Selecione uma área de inserção na quadro de design e use o atalho do teclado Control+V (Windows ou Linux) ou Command+V (macOS) para criar uma instância de atividade no projeto e adicionar uma referência a essa instância de atividade no workflow do projeto.

Você também pode arrastar uma atividade existente do Salesforce, Salesforce Service Cloud ou ServiceMax da aba Componentes do painel do projeto para uma área de inserção de componentes na quadro de design.

Ao colocar a atividade na quadro de design, uma caixa de diálogo indica que um novo componente independente será criado:

criando cópia do componente

Criar uma atividade ou instância de ferramenta

Você pode criar uma instância de uma atividade ou ferramenta como um novo componente independente arrastando e soltando (consulte Arrastar e soltar abaixo) ou usando uma combinação de Copiar (consulte Cortando e cortando componentes acima) e ações do menu Colar (veja Colar abaixo) ou seus atalhos de teclado.

Arrastar e soltar

Arraste uma atividade ou tipo de ferramenta da paleta de componentes de design Endpoints e conectores do projeto, endpoints globais ou Ferramentas guias para uma área de inserção dentro de um workflow:

criar instância de atividade

Dica

Ao arrastar um componente pela quadro de design, você pode executar estas ações:

  • Use a tecla de escape ESC no seu teclado para cancelar a movimentação.
  • Alterne os workflows passando o mouse sobre a aba de um fluxo de trabalho aberto.

Colar

Ao copiar um tipo de atividade, a cópia é usada para criar um novo componente independente no projeto (uma instância de atividade).

Após copiar o tipo de atividade, você pode colá-lo no mesmo projeto usando o aplicativo de navegador atual ou o modo de navegador de onde o copiou. Não há suporte para colar tipos de atividade entre projetos e modos de navegador.

Copiar um tipo de atividade e então cole-o — criando uma instância de atividade como um componente independente — de uma destas maneiras:

  • Use a ação de menu Colar atividade acessível no menu de ações da aba Componentes na guia Componentes do aba do projeto (consulte menu de ações da aba Componentes na aba Componentes do painel Projeto) para criar uma instância de atividade no projeto.
  • Selecione uma área de inserção na quadro de design e, em seguida, use a ação de menu Colar (consulte menu de ações da zona de lançamento em Tela de design) para criar uma instância de atividade no projeto e adicionar uma referência a essa instância de atividade no workflow do projeto.
  • Selecione uma área de inserção na quadro de design e use o atalho do teclado Control+V (Windows ou Linux) ou Command+V (macOS) para criar uma instância de atividade no projeto e adicionar uma referência a essa instância de atividade no workflow do projeto.

Criar uma referência de componente

Certos tipos de componentes podem ser usados como etapas operação, incluindo atividades e ferramentas. Outros tipos de componentes podem ser usados em suporte às operações. A maioria desses tipos de componentes pode ser referenciada diversas vezes, conforme abordado abaixo.

Componentes usados como etapas de operação

Certos tipos de atividades e ferramentas podem ser referenciados várias vezes como etapas em uma operação:

  • Atividades: A maioria das atividades pode ser referenciada várias vezes como etapas da operação. As exceções incluem Salesforce, Salesforce Service Cloud e atividades do ServiceMax, que não pode ser referenciado por mais de um componente. Em vez disso, você pode fazer uma cópia de uma atividade do Salesforce, Salesforce Service Cloud ou ServiceMax para usar em outro lugar.

  • Ferramentas: Todas as ferramentas (transformações, scripts e ferramentas de Controle de Fluxo) podem ser referenciadas várias vezes como etapas de operação.

    Nota

    Ao referenciar uma transformação usando um esquema herdado de uma atividade, a ordem na qual as etapas de uma operação são configuradas controla como os esquemas são propagados entre as referências de transformação, conforme descrito em Reutilização de Transformação.

Você pode criar uma referência a um desses tipos de componentes como uma etapa de operação arrastando e soltando ou usando uma combinação das ações de menu Recortar ou Copiar e Colar ou seus atalhos de teclado.

Arrastar e soltar

Arraste o componente da aba Componentes do painel do projeto para uma área de inserção dentro de um workflow:

atividade de reutilização

Dica

Ao arrastar um componente pela quadro de design, você pode executar estas ações:

  • Use a tecla de escape ESC no seu teclado para cancelar a movimentação.
  • Alterne os workflows passando o mouse sobre a aba de um fluxo de trabalho aberto.

Colar

Depois de ter uma cópia de um componente na área de transferência, você pode colá-la no mesmo projeto usando o aplicativo de navegador atual ou o modo de navegador de onde a copiou. Não há suporte para colar referências de componentes entre projetos e modos de navegador.

Recortar ou copiar um componente, selecione uma área de inserção na quadro de design e cole o componente de uma destas maneiras:

  • Use a ação de menu Colar acessível no menu de ações da área de inserção na quadro de design (consulte menu de ações da zona de soltar em Tela de design).
  • Use o atalho do teclado Control+V (Windows ou Linux) ou Command+V (macOS).

Componentes usados em suporte a uma operação

A maioria dos componentes que não podem ser usados como etapas em uma operação podem ser reutilizados ou referenciados de outras maneiras. A reutilização de componentes em suporte a operações é abordada na documentação de cada componente:

Ver o número de referências de componentes

As referências de componentes são contadas e exibidas na aba Componentes do painel do projeto.

Se um componente não for referenciado por nenhuma das operações dentro dos workflows de um projeto, ele será considerado um componente não utilizado. Componentes não utilizados são exibidos com um ícone não referenciado ao lado do nome do componente.

Por exemplo, esses dois novos scripts não são referenciados por nenhuma operação de workflow:

scripts não referenciados

Se um componente for referenciado apenas uma vez na quadro de design, ele será exibido no painel do projeto sem nenhum indicador visual ao lado do nome do componente.

Por exemplo, cada um desses scripts é usado em uma única operação de workflow:

scripts referência única

Se um componente for referenciado várias vezes na quadro de design, inclusive em outros componentes usados na quadro de design, o número de vezes que ele é referenciado é exibido em um emblema ao lado do nome do componente.

Neste exemplo, o primeiro script é referenciado tanto em uma operação de workflow quanto por outro script dentro de uma operação de workflow, e o segundo script é referenciado por um script adicional dentro de uma operação de workflow:

scripts múltiplas referências

Essa contagem não é necessariamente o número de vezes que o componente é referenciado; se um componente for referenciado várias vezes por outro componente, isso conta como uma única referência. Por exemplo:

  • Uma variável de projeto que é referenciada diversas vezes dentro de um script conta como se tivesse sido referenciada apenas uma vez.
  • Uma variável de projeto que é referenciada diversas vezes dentro de uma configuração de atividade conta como tendo sido referenciada apenas uma vez.

Nota

O número de referências é baseado no projeto como ele existe atualmente no designer de projetos do Integration Studio e não leva em consideração se os componentes foram implantados no Harmony.