Reutilizar operações no Jitterbit Integration Studio

Introdução

Esta página descreve como reutilizar operações em um projeto. A reutilização de outros tipos de componentes de projeto é abordada em Reutilização de componentes.

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 as referências a esses componentes formam a base necessária para a compreensão dos termos de IU relacionados:
  • Duplicar uma operação para criar uma cópia da operação, seja com referências de etapa de operação ou cópias de etapa de operação
  • Referenciando uma operação existente
  • Operações de corte ou cópia para colocá-los na sua área de transferência
  • Colar como uma nova operação ou como referência dependendo do contexto
• Operações de corte e cópia
  Esta seção descreve os vários locais de onde você pode recortar e copiar operações. Recortar uma operação também a exclui do projeto, ou sua referência, dependendo de onde foi recortada.
• Criar uma nova operação a partir de uma operação existente
  Esta seção descreve as várias maneiras de criar uma nova operação a partir de uma operação existente. Isso é feito duplicando uma operação existente ou recortando/copiando e colando em locais designados. Você pode criar uma cópia de uma operação com referências de etapas (exceto para determinados tipos de atividade) ou com cópias de etapas. Cópias de operações com Salesforce, Salesforce Service Cloud e atividades do ServiceMax sempre crie essas atividades como novas atividades em vez de referências, pois não é permitido reutilizar mais de uma instância igual desses tipos de atividade.
• Criar uma referência de componente
  Esta seção descreve as várias maneiras de referenciar operações. As operações podem ser referenciadas várias vezes por qualquer combinação de outros componentes. No entanto, elas só podem ser referenciadas uma única vez em um único workflow.

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.

Uma operação como um componente independente pode ser reutilizada em um projeto de duas maneiras:

• Duplicando está usando a configuração de uma operação existente para criar um novo componente independente em um projeto. Após duplicar uma operação, 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 uma operação, uma nova operação aparece na aba Componentes do painel do projeto e é um componente independente no projeto.

  Você pode duplicar uma operação com referências de etapas ou com cópias de etapas:

  • Uma operação duplicada com referências de etapas tem referências às etapas da operação original. (Uma exceção: Qualquer Salesforce, Salesforce Service Cloud e atividades do ServiceMax são duplicados em vez de referenciados.)
  • Uma operação duplicada com cópias de etapas cria cópias de cada etapa de operação original como novos componentes.

  Uma operação também pode ser colada entre projetos abertos na mesma sessão do navegador.

• Referência está usando a mesma operação 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 operação pode ser referenciada em uma ação de operação configurada em outra operação e também referenciada em uma função de script e também referenciada em um único workflow de projeto. Quando você referencia um componente dentro ou fora dos workflows do projeto, a contagem de referências do componente na aba Componentes do painel do projeto é aumentada.

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

As palavras recortar e copiar, como ações, colocam uma cópia de uma operação 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 uma operação na sua área de transferência e exclui o componente independente original ou a referência ao componente, dependendo de onde a operação foi cortada:
  • Se uma operação for cortada da aba Componentes do painel do projeto, o componente independente original será excluído.
  • Se uma operação for cortada 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 uma operação na sua área de transferência. O componente independente original permanece inalterado. Copiar e colar uma operação 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:
  • Colando uma operação na aba Componentes do painel do projeto cria um novo componente independente.
  • Colando uma operação uma única vez na quadro de design cria um novo componente independente com referências de etapas (exceto para Salesforce, Salesforce Service Cloud e atividades do ServiceMax, que são duplicadas) e uma referência a essa operação é adicionada ao workflow do projeto. Colando a mesma operação mais vezes adiciona uma referência adicional à operação recém-criada no workflow do projeto.

Operações de corte e cópia

Você pode acessar as ações de menu Recortar e Copiar a partir do menu de ações de uma operação em qualquer um destes lugares:

• Componentes independentes na aba Componentes do painel do projeto (veja menu de ações do componente na aba Componentes do painel Projeto).
• Referências de componentes na quadro de design (consulte menu de ações do componente em Tela de design).
• Referências de componentes na aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).

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

As operações de corte e cópia colocam uma cópia de uma operação na sua área de transferência.

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 uma operação do projeto (na aba Componentes do painel do projeto) exclui o componente independente original do projeto. Como a exclusão é necessária, cortar uma operação só é possível em operações não referenciadas. As caixas de diálogo padrão para exclusão são exibidas conforme documentado em Dependências de operação, exclusão e remoção.

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

Crie uma nova operação a partir de uma operação existente

Você pode criar uma nova operação como um componente independente usando uma combinação das ações de menu Recortar, Copiar e Colar (ou seus atalhos de teclado) ou usando a ação de menu Duplicar.

Ao usar uma combinação das ações de menu Recortar, Copiar e Colar (ou seus atalhos de teclado), uma nova operação é criada usando a configuração da operação original com estas exceções:

• Todos os horários atribuídos são removidos.
• Todas as operações configuradas são removidas.

Ao usar a ação de menu Duplicar, uma nova operação é criada usando a mesma configuração da operação original, incluindo quaisquer programações atribuídas e ações de operação configuradas.

O nome padrão da nova operação usa o nome do componente independente original, acrescido de - Copy. Cópias subsequentes são acrescidas de um número incrementado entre parênteses.

Colar

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

Observação

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

Uma operação (exceto as indicadas abaixo) também pode ser colada entre projetos abertos na mesma sessão do navegador. Ao colar operações com etapas de atividade entre projetos, um novo endpoint será criado na primeira vez que a operação com uma atividade for colada. As colagens subsequentes serão conectadas ao endpoint existente.

Nota

Uma operação com uma etapa como 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. Operações com etapas como atividades criadas a partir de um conector personalizado ser colado em um projeto onde o conector personalizado não existe. Além disso, operações com etapas como atividades associadas a conexões globais não podem ser colados 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 uma operação e cole a operação na aba Componentes do painel do projeto ou na quadro de design:

• Guia Componentes do Painel do Projeto: Use a ação de menu Operação de Colar do menu de ações de uma categoria de componente (consulte menu de ações da aba Componentes na aba Componentes do painel Projeto). Esta ação é habilitada somente quando você tem uma operação na sua área de transferência.
• Quadro de design: Selecione a área de inserção de uma operaçã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). Se um componente de operação for colado uma única vez na quadro de design, um novo componente independente será criado e uma referência a esse componente será adicionada ao workflow do projeto.

Ao criar a nova operação, o cursor é posicionado no nome da operação para renomeá-la.

Duplicado

Você pode acessar a ação de menu Duplicar no menu de ações de uma operação na aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto) ou a quadro de design.

A ação de menu Duplicar oferece uma escolha entre dois métodos de duplicação:

• Com referências de etapas: Cria apenas uma nova operação independente. A operação duplicada contém referências a cada uma das etapas da operação original, com exceção de Salesforce, Salesforce Service Cloud e atividades do ServiceMax, que são duplicados.
• Com Cópias de Etapas: Cria uma nova operação independente e novos componentes independentes referenciados como etapas da operação. Novos componentes são criados para cada etapa de operação e são referenciados pela nova operação.

Se a operação for criada a partir da quadro de design, a nova operação também será referenciada no workflow do projeto. A nova operação será exibida imediatamente abaixo da operação original e o cursor será posicionado sobre o nome da operação para renomeá-la.

Criar uma referência de componente

Uma operação pode ser referenciada por outros componentes ou workflows do projeto em todo o projeto.

Uma operação pode ser referenciada várias vezes por qualquer combinação de outros componentes. No entanto, ela só pode ser referenciada uma vez em um único workflow. Uma operação não pode ser referenciada várias vezes no mesmo workflow, nem em vários workflows.

Referenciar uma operação

Você pode referenciar a mesma operação várias vezes em vários lugares ao longo de um projeto, conforme descrito abaixo.

Configurar uma ação de operação

Selecione uma operação ao configurar uma ação de operação em outra operação. A mesma operação pode ser objeto de ações configuradas para serem executadas em caso de sucesso, falha ou falha de SOAP de qualquer número de outras operações no mesmo projeto.

Chamar uma operação

Uma operação pode ser chamada qualquer número de vezes usando um destes métodos:

1. A Operação de Invocação ferramenta como uma etapa de uma operação.

2. Uma operação com um Jitterbit Script função geral que recebe um caminho de referência de operação como parâmetro, como RunOperation ou GetLastOperationRunStartTime.

Arrastar e soltar

Arraste uma operação que não esteja atualmente em um workflow da aba Componentes do painel do projeto para um workflow aberto na quadro de design:

Dica

Ao arrastar uma operação 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 entre workflows passando o mouse sobre a aba de um fluxo de trabalho aberto.

Embora as operações não possam ser referenciadas por mais de um workflow, uma única operação pode estar em um único workflow e ser referenciada por uma ou várias ações e/ou funções de operação (independentemente de quaisquer associações com operações que podem ou não estar no mesmo ou em workflows diferentes).

Uma operação pode aparecer apenas uma vez na quadro de design de um projeto.

Colar

Depois de ter uma cópia de uma operação 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 operações como referências entre projetos e modos de navegador.

Cortar ou copiar uma operação e, em seguida, cole a operação na quadro de design usando a ação de menu Colar do menu de ações da zona de soltar operação (consulte menu de ações da zona de soltar em Tela de design). Se um componente de operação for colado uma única vez na quadro de design, um novo componente independente será criado e uma referência a esse componente será adicionada ao workflow do projeto. Colar a mesma operação mais vezes adiciona uma referência adicional à operação recém-criada no workflow do projeto.

Ver o número de referências de componentes e workflow

As referências de componentes e workflow são contadas e exibidas na aba Componentes do painel do projeto. A contagem depende de quantas vezes o componente é referenciado nos workflows de um projeto.

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.

• Sem referências

  Se uma operação não for referenciada por (usada em) nenhum dos workflows do projeto, ela será chamada de operação não utilizada. Componentes não utilizados, incluindo operações, são exibidos no painel do projeto com um símbolo não referenciado. ícone ao lado do nome do componente.

  Por exemplo, após duplicar uma operação do painel do projeto, ela não aparece em um workflow na quadro de design:

  

• Uma única referência

  Se uma operação for referenciada apenas uma vez na quadro de design, ela será exibida sem nenhum indicador visual ao lado do nome do componente.

  Por exemplo, cada uma dessas operações está contida em um workflow:

  

• Múltiplas referências

  Se uma operação for referenciada várias vezes na quadro de design, o número de componentes do workflow do projeto e/ou workflows aos quais ela é referenciada será exibido em um emblema ao lado do nome do componente.

  Neste exemplo, Operação de Exemplo e Segunda Operação de Exemplo estão em um workflow e cada uma tem uma ação de operação configurada para chamar Operação de Exemplo - Copiar, que faz parte do workflow por referência, resultando em duas contagens de referência:

  

  A contagem não é necessariamente o número de vezes que a operação é referenciada; se uma operação for referenciada várias vezes por outro componente, isso pode ser contabilizado como uma ou várias referências, dependendo de como a operação foi referenciada. As ações de operação configuradas contam como uma referência, mas múltiplas referências por componentes que não são operações não são agregadas na contagem total.

  Por exemplo:

  • Um script que faz referência a uma operação duas vezes por seu caminho de referência em um script — talvez usando ambos GetLastOperationRunStartTime e RunOperation funções — conta a referência de operação apenas uma vez.

  • Uma operação configurada para executar uma operação tanto em caso de sucesso quanto em caso de falha conta a referência de operação operação vezes.

Embora não haja nenhuma indicação visual no painel do projeto de que as ações da operação estão configuradas, você pode determinar como as operações estão vinculadas visualizando dependências ou iniciando a caixa de diálogo de exclusão da operação, conforme descrito em Dependências, exclusão e remoção da operação.

Por exemplo, ao visualizar as dependências de Operação de Exemplo e Segunda Operação de Exemplo, você verá que Operação de Exemplo - Cópia depende das duas primeiras operações. Ao tentar excluir Operação de Exemplo - Cópia, você verá Operação de Exemplo e Segunda Operação de Exemplo listadas como componentes que impedem a exclusão de Operação de Exemplo - Cópia.