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 do 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 referências a esses componentes forma a base necessária para entender os termos de interface relacionados:
  • Duplicar uma operação para criar uma cópia da operação, seja com referências de etapas da operação ou cópias de etapas da operação
  • Referenciar uma operação existente
  • Cortar ou copiar operações para colocá-las na área de transferência
  • Colar como uma nova operação ou como uma referência, dependendo do contexto
• Cortar e copiar operações
  Esta seção descreve os vários locais de onde você pode cortar e copiar operações. Cortar uma operação também exclui a operação ou sua referência do projeto, dependendo de onde foi cortada.
• 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 cortando/copando e colando em locais designados. Você pode criar uma cópia de uma operação seja com referências de etapas (exceto para certos tipos de atividade) ou com cópias de etapas. Cópias de operações com Salesforce, Salesforce Service Cloud e atividades ServiceMax sempre criam essas atividades como novas atividades em vez de referências, pois reutilizar mais de uma instância do mesmo tipo de atividade não é permitido.
• 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 podem ser referenciadas apenas uma única vez em um único fluxo de trabalho.

Terminologia de reutilização de componentes

Os componentes do projeto, conforme aparecem na interface 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 no projeto.
• Referências de componentes referem-se de volta aos componentes independentes. As referências de componentes nos fluxos de trabalho do projeto estão contidas na tela de design e na aba Fluxos de Trabalho do painel do projeto. Os componentes também podem ser referenciados por componentes que não fazem parte de nenhum fluxo de trabalho.

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

• Duplicar é usar a configuração de uma operação existente para criar um novo componente independente em um projeto. Depois de 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. Quando você duplica 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 tanto com referências de etapas quanto 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: quaisquer Salesforce, Salesforce Service Cloud e atividades do ServiceMax são duplicadas em vez de referenciadas.)
  • Uma operação duplicada com cópias de etapas cria cópias de cada etapa da operação original como novos componentes.

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

• Referenciamento é o uso da mesma operação mais de uma vez em um projeto e é a maneira como você constrói fluxos de trabalho do projeto. Uma referência de componente em um fluxo de trabalho é uma operação, atividade, transformação, script ou notificação por email que é representada visualmente na tela de design e aparece na aba Fluxos de Trabalho do painel do projeto (exceto para notificações por email). Referências de componentes também podem estar em outros componentes, que podem ou não estar nos fluxos de trabalho 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 fluxo de trabalho do projeto. Quando você referencia um componente dentro ou fora dos fluxos de trabalho do projeto, a contagem de referências do componente na aba Componentes do painel do projeto é aumentada.

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

As palavras cortar 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. Qual desses dois é criado depende do contexto ao colar:

• Cortar coloca uma cópia de uma operação na sua área de transferência e exclui o componente independente original ou a referência de 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 é excluído.
  • Se uma operação for cortada da tela de design ou da aba Fluxos de Trabalho do painel do projeto, como o componente é uma referência a um componente independente original, apenas a referência é excluída e o componente independente original permanece inalterado.
• Copiar coloca uma cópia de uma operação na sua área de transferência. O componente independente original permanece inalterado. Copiar e, em seguida, colar uma operação pode resultar em um novo componente independente ou uma referência de componente, dependendo do contexto ao colar.
• Colar cria um componente independente ou uma referência de componente, dependendo do contexto ao colar. Por exemplo:
  • Colar uma operação na aba Componentes do painel do projeto cria um novo componente independente.
  • Colar uma operação uma única vez na tela 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 fluxo de trabalho do projeto. Colar a mesma operação mais vezes adiciona uma referência adicional à operação recém-criada no fluxo de trabalho do projeto.

Operações de cortar e copiar

Você pode acessar as ações de menu Cortar e Copiar no menu de ações de uma operação em qualquer um destes locais:

• Componentes independentes na aba Componentes do painel do projeto (veja Menu de ações do componente na Aba Componentes do painel do projeto).
• Referências de componentes na tela de design (veja Menu de ações do componente na Tela de design).
• Referências de componentes na aba Workflows do painel do projeto (veja Menu de ações do componente na Aba Workflows do painel do 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 copiar (Control+C no Windows ou Linux e Command+C no macOS).

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

Cortar uma operação do projeto (da aba Componentes do painel do projeto) exclui o componente independente original do projeto. Como a exclusão é necessária, cortar uma operação é possível apenas 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 fluxo de trabalho do projeto (da tela de design ou da aba Workflows do painel do projeto) exclui apenas a referência do componente. O componente independente original permanece inalterado.

Criar 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 as seguintes exceções:

• Qualquer cronograma atribuído é removido.
• Quaisquer 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 cronogramas atribuídos e ações de operação configuradas.

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

Colar

Uma vez que você tenha 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.

Uma operação (exceto aquelas mencionadas 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. Colagens subsequentes estarão conectadas ao endpoint existente.

Cortar ou copiar uma operação e, em seguida, colar a operação na aba Componentes do painel do projeto ou na tela de design:

• Aba Componentes do Painel do Projeto: Use a ação de menu Colar Operação no menu de ações de uma categoria de componente (veja menu de ações da aba Componentes na aba Componentes do painel do projeto). Esta ação está habilitada apenas quando você tem uma operação na área de transferência.
• Tela de Design: Selecione a zona de descarte de uma operação na tela de design e, em seguida, use a ação de menu Colar (veja menu de ações da zona de descarte na tela de design). Se um componente de operação for colado uma única vez na tela de design, um novo componente independente é criado e uma referência a esse componente é adicionada ao fluxo de trabalho do projeto.

Ao criar a nova operação, o cursor é posicionado no nome da operação para renomeação.

Duplicar

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 (veja menu de ações do componente na aba Componentes do painel do projeto) ou na tela 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 duplicadas.
• 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 da operação e são referenciados pela nova operação.

Se a operação for criada a partir do canvas de design, a nova operação também será referenciada no fluxo de trabalho do projeto. A nova operação é exibida imediatamente abaixo da operação original e o cursor é posicionado no nome da operação para renomeação.

Criar uma referência de componente

Uma operação pode ser referenciada por outros componentes ou fluxos de trabalho 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 pode ser referenciada apenas uma única vez em um único fluxo de trabalho. Uma operação não pode ser referenciada várias vezes no mesmo fluxo de trabalho, nem pode ser referenciada em múltiplos fluxos de trabalho.

Referenciar uma operação

Você pode referenciar a mesma operação várias vezes em vários locais 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 o sujeito de ações que são configuradas para serem executadas em caso de sucesso, falha ou erro 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 ferramenta Invocar Operação como um passo em uma operação.

2. Uma operação com um Jitterbit Script Função Geral que aceita 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 está atualmente em um fluxo de trabalho da aba Componentes do painel do projeto para um fluxo de trabalho aberto no canvas de design:

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

Uma operação pode aparecer apenas uma vez no canvas de design de um projeto.

Paste

Uma vez que você tenha 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. Colar operações como referências entre projetos e modos de navegador não é suportado.

Corte ou copie uma operação e, em seguida, cole a operação no canvas de design usando a ação de menu Colar do menu de ações da zona de queda de uma operação (veja Menu de ações da zona de queda em Canvas de design). Se um componente de operação for colado uma única vez no canvas de design, um novo componente independente é criado e uma referência a esse componente é adicionada ao fluxo de trabalho do projeto. Colar a mesma operação mais vezes adiciona uma referência adicional à operação recém-criada no fluxo de trabalho do projeto.

Exibir o número de referências de componentes e fluxos de trabalho

Referências de componentes e fluxos de trabalho são contadas e exibidas dentro da aba Componentes do painel do projeto. A contagem depende de quantas vezes o componente é referenciado nos fluxos de trabalho de um projeto.

• Sem Referências

  Se uma operação não é referenciada (usada) em nenhum dos fluxos de trabalho do projeto, ela é conhecida como uma operação não utilizada. Componentes não utilizados, incluindo operações, são exibidos no painel do projeto com um ícone não referenciado ao lado do nome do componente.

  Por exemplo, após duplicar uma operação do painel do projeto, ela não aparece em um fluxo de trabalho no canvas de design:

  

• Uma Única Referência

  Se uma operação é referenciada apenas uma vez no canvas de design, ela é exibida sem nenhum indicador visual ao lado do nome do componente.

  Por exemplo, essas operações estão contidas em um fluxo de trabalho:

  

• Múltiplas Referências

  Se uma operação é referenciada várias vezes no canvas de design, o número de componentes de fluxo de trabalho do projeto e/ou fluxos de trabalho que a referenciam é exibido em um distintivo ao lado do nome do componente.

  Neste exemplo, Exemplo de Operação e Segunda Operação de Exemplo estão cada uma em um fluxo de trabalho e cada uma tem uma ação de operação configurada para chamar Exemplo de Operação - Copiar, que faz parte do fluxo de trabalho 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 é referenciada várias vezes por outro componente, isso pode contar como uma ou várias referências, dependendo de como a operação foi referenciada. Ações de operação configuradas contam cada uma como uma referência, mas referências múltiplas por componentes que não são operações não são agregadas na contagem total.

  Por exemplo:

  • Um script que referencia uma operação duas vezes pelo seu caminho de referência em um script — talvez usando tanto as funções GetLastOperationRunStartTime quanto RunOperation — conta a referência da operação apenas uma vez.

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

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

Por exemplo, ao visualizar as dependências de Exemplo de Operação e Segunda Operação de Exemplo, você verá que Exemplo de Operação - Cópia depende das duas primeiras operações. Quando você tenta excluir Exemplo de Operação - Cópia, verá Exemplo de Operação e Segunda Operação de Exemplo listados como componentes que impedem que Exemplo de Operação - Cópia possa ser excluído.