Reutilização de Operação¶

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 nestas seções:

• Terminologia de reutilização de componentes
  Esta seção define a terminologia usada para discutir a reutilização de componentes. Um reconhecimento da diferença entre componentes independentes e referências a esses componentes constitui a base necessária para a compreensão dos termos da UI 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 á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 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 ela foi cortada.
• Criar uma nova operação a partir de uma operação existente
  Esta seção descreve as diversas maneiras pelas quais você pode criar uma nova operação a partir de uma operação existente. Isso é feito duplicando uma operação existente ou cortando/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 atividades) 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 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 diversas maneiras pelas quais você pode fazer referência a operações. As operações podem ser referenciadas diversas vezes por qualquer combinação de outros componentes. No entanto, eles podem ser referenciados apenas uma vez em um único workflow.

Terminologia de Reutilização de Componentes¶

Os componentes do projeto conforme aparecem na IU do Cloud 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 guia Componentes do aba do projeto. Componentes independentes são os componentes do projeto.
• Referências de componentes referem-se aos componentes independentes. As referências de componentes nos workflows do projeto estão contidas na quadro de design e na guia Workflows do aba do projeto. Os componentes também podem ser referenciados por componentes que não fazem parte de nenhum workflows.

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

• Duplicando está usando uma configuração de operação existente para criar um componente novo e 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 guia Componentes do aba do projeto e é um componente independente do 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 possui referências às etapas da operação original. (Uma exceção: qualquer Salesforce, Salesforce Service Cloud e atividades 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 forma como você cria workflows do projeto. Uma referência de componente em um workflow é uma operação, atividade, transformação, script ou notificação email que é representada visualmente na quadro de design e aparece na aba Workflows do painel do projeto (exceto para notificações email). As referências de componentes 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 do projeto. Quando você faz referência a um componente dentro ou fora dos workflows do projeto, a contagem de referências do componente na guia Componentes do aba do projeto aumenta.

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

As palavras cortando e copiando, como ações, colocam uma cópia de uma operação em sua área de transferência que é então usada para criar um componente independente ou uma referência de componente. Qual destes dois é criado depende do contexto ao colar:

• Cortando coloca uma cópia de uma operação na área de transferência e exclui o componente independente original ou a referência do componente, dependendo de onde a operação foi cortada:
  • Se uma operação for cortada da guia Componentes do aba do projeto, o componente independente original será excluído.
  • Se uma operação for cortada da quadro de design ou da guia Workflows do aba do projeto, como o componente é uma referência a um componente independente original, apenas 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 de componente, dependendo do contexto durante a colagem.
• Colar cria um componente independente ou uma referência de componente, dependendo do contexto ao colar. Por exemplo:
  • Colando uma operação na guia Componentes do aba do projeto cria um componente novo e independente.
  • Colando uma operação uma única vez na quadro de design cria um componente novo e independente com referências de etapas (exceto para Salesforce, Salesforce Service Cloud e atividades ServiceMax, que são duplicados) 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 do menu Cortar e Copiar no menu de ações de uma operação em qualquer um destes locais:

• Componentes independentes na guia Componentes do aba do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).
• Referências de componentes na quadro de design (consulte Menu Ações de Componentes em Quadro de Design).
• Referências de componentes na guia Workflows do aba do projeto (consulte Menu Ações de componentes em Guia 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 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 área de transferência.

Cortar uma operação do projeto (na guia Componentes do aba do projeto) exclui o componente independente original do projeto. Como a exclusão é necessária, o corte de 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 do projeto (da quadro de design ou da guia Workflows do aba do projeto) exclui apenas a referência do 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 Cortar, Copiar e Colar (ou seus atalhos de teclado) ou usar a opção Duplicar ação do menu.

Ao usar uma combinação das ações de menu Cortar, 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:

• Quaisquer horários atribuídos são removidos.
• 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 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 anexado com -Copiar. As cópias subsequentes são anexadas com um número incrementado entre parênteses.

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.

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

Cortar ou copiar uma operação e cole a operação na guia Componentes do aba do projeto ou na quadro de design:

• Guia Componentes do painel Projeto: Use a ação de menu Operação Colar no menu de ações de uma categoria de componente (consulte Menu Ações de categoria em Guia Componentes do painel do projeto). Esta ação é habilitada somente quando você tem uma operação na á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 do menu Colar (consulte Menu de ações da zona para soltar em Quadro 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 do menu Duplicar no menu de ações de uma operação na aba Componentes do painel do projeto (consulte Menu Ações do Componente em Guia Componentes do painel do projeto) ou a quadro de design.

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

• Com referências de etapa: Cria apenas uma operação nova e 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 ServiceMax, que são duplicados.
• Com Cópias de Etapas: Cria uma operação nova e independente e novos componentes independentes referenciados como etapas de 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 é exibida imediatamente abaixo da operação original e o cursor é posicionado no nome da operação para renomeá-la.

Crie uma Referência de Componente¶

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

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

Referenciar uma Operação¶

Você pode fazer referência à 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 objeto de ações configuradas para execução em caso de sucesso, falha ou falha SOAP de qualquer número de outras operações no mesmo projeto.

Chame uma Operação em um Script¶

Use uma operação com um Jitterbit Script Função Geral que usa um caminho de referência de operação como parâmetro, como RunOperation ou GetLastOperationRunStartTime. Uma operação pode ser chamada por funções inúmeras vezes.

Arrastar e Soltar¶

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

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 possam ou não estar no mesmo ou workflows diferentes).

Uma operação só pode aparecer 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 para soltar uma operação (consulte Menu Ações da zona para soltar em Quadro 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.

visualizar o Número de Referências de Componentes e Workflow¶

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

• Sem referências

  Se uma operação não for referenciada por (usada em) nenhum dos workflows do projeto, ela será 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 (link quebrado) próximo ao 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 próximo ao 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 diversas vezes na quadro de design, o número de componentes do workflow do projeto e/ou workflows pelos quais ela é referenciada será exibido em um emblema ao lado do nome do componente.

  Neste exemplo, Exemplo de Operação e Segundo Exemplo de Operação estão em um workflow e cada um tem uma ação de operação configurada para chamar Exemplo de Operação - 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 diversas vezes por outro componente, isso poderá contar como uma referência única ou múltipla, dependendo de como a operação foi referenciada. Cada uma das ações de operação configuradas conta como uma referência, mas diversas referências por componentes que não são de operação 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 os GetLastOperationRunStartTime e RunOperation funções — conta a referência da operação apenas uma única vez.

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

Embora não haja indicação visual no painel do projeto de que as ações de 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 de operação, conforme descrito em Dependências, exclusão e remoção de operação.

Por exemplo, ao visualizar as dependências de Exemplo de Operação e Segundo Exemplo de Operação, você verá que Exemplo de Operação - Copiar depende das duas primeiras operações. Ao tentar excluir Exemplo de Operação - Copiar, você verá Exemplo de Operação e Segundo Exemplo de Operação listados como componentes que impedem que Exemplo de Operação - Copiar possa ser excluído.