Quadro de Design¶

Introdução¶

A quadro de design é a área central quando você abre um projeto que serve como espaço de trabalho principal onde você projeta integrações visualmente. Esta página aborda elementos da interface do usuário que estão presentes na quadro de design, bem como conceitos-chave a serem compreendidos ao trabalhar na quadro de design.

Para acessar a quadro de design, primeiro abra um projeto. Em um projeto aberto, a quadro de design é a área central localizada à direita do painel do projeto e à esquerda da paleta de componentes, abaixo da barra de ferramentas do projeto:

Cabeçalho de Quadro de Design¶

Esses elementos estão presentes na parte superior da quadro de design:

• Guias de Workflow: Os Workflows são acessados nas guias na parte superior da quadro de design. workflows adicionais podem ser criados clicando no ícone do novo workflow . O novo workflow é aberto em uma nova aba na quadro de design. Os Workflows são numerados sequencialmente na ordem em que são criados, como 1,0, 2,0, 3,0, etc. Se você reordenar os workflows, essa sequência numérica será ajustada de acordo (consulte Reordenar Workflows em Criação e design de Workflow).

• Status de salvamento: O status de salvamento automático é exibido no canto superior esquerdo da quadro de design. Esses status estão disponíveis:

  • Salvos: Todos os itens do projeto são salvos conforme configurados atualmente.
  • Salvando: O projeto está sendo salvo no momento. Esse status ocorre somente após as alterações terem sido feitas.

• Última implantação: A data e a hora em que qualquer parte do projeto foi implantada pela última vez são exibidas. Se nenhuma parte do projeto tiver sido implantada ainda, nada será exibido aqui.

• Recolher todas as operações ou Expandir todas as operações: Alterna a exibição de todas as operações no workflow atual para uma visualização condensada ou expandida (consulte Expandir ou recolher operações em Criação e configuração de operação).

• Destacar itens inválidos: Alterna a exibição de itens inválidos (consulte Validade do Workflow, Validade da Operação ou Validade do Componente, respectivamente).

• Ações: Clique no ícone do menu de ações para abrir o menu de ações do quadro de design (consulte Menu de ações do Quadro de Design mais adiante nesta página).

Elementos de Quadro de Design¶

A função principal da quadro de design é ter um espaço de trabalho onde você projeta workflows visualmente. Cada workflow é composto por um conjunto de operações que são usadas como uma ferramenta para sua conveniência, ajudando a segregar diferentes partes do projeto.

Os Workflows são projetados colocando e configurando operações na quadro de design. Os elementos da tela de design são os itens que aparecem visualmente na quadro de design para ajudá-lo a projetar um workflow, incluindo estes:

• Zonas de lançamento para operações e para outros componentes usados como etapas de operação
• Operações e os componentes usados como etapas de operação dentro deles
• Notificações que estão vinculados a operações
• Referências de operação que estão fora do workflow atual e vinculados a uma operação no workflow atual
• Linhas que conectam operações, scripts e notificações vinculados

Cada um desses elementos da quadro de design é abordado abaixo. Para obter informações adicionais sobre como projetar workflows, consulte Criação e design de Workflow.

Áreas de Inserção¶

Uma área de inserção é uma representação visual de onde uma operação ou outro componente pode ser colocado na quadro de design. Existem dois tipos de zonas de lançamento, zonas de lançamento de operação e zonas de lançamento de componentes:

• Área de inserção de operações: As zonas de lançamento de operação indicam onde uma operação pode ser colocada. Uma área de inserção de operações é exibida permanentemente na parte inferior da quadro de design após a última operação. Para mostrar zonas de lançamento de operação adicionais, passe o mouse sobre as operações existentes. Quando você clica para selecionar uma área de inserção de operações, ela é exibida com uma borda roxa delineando a área de inserção e fica selecionada até você alterar o foco:

  

• Área de inserção de componentes: As zonas para soltar componentes indicam onde outros componentes que podem ser usados como etapas de operação podem ser colocados em uma operação existente. Para mostrar uma área de inserção de componentes, passe o mouse para a esquerda ou direita de uma etapa de operação em uma operação existente na quadro de design. Quando você clica para selecionar uma área de inserção de componentes, ela é exibida com uma borda roxa delineando a área de inserção e fica selecionada até você alterar o foco:

  

Um menu de ações está disponível em cada área de inserção. Ambas as zonas de lançamento de operação e as zonas de lançamento de outros componentes mostram os mesmos itens de menu, conforme descrito em Menu de ações da zona de lançamento mais adiante nesta página.

Operações¶

As operações são representadas visualmente na quadro de design por uma área retangular dinâmica com fundo cinza.

Uma operação consiste nestes elementos:

1. Número e Nome da Operação
2. Barra de ação de operação
3. Etapas da operação
4. Status da operação

Número e Nome da Operação¶

A seção superior esquerda de uma operação consiste no operação e no nome da operação:

• Número da operação: Um número exclusivo atribuído automaticamente dependendo de onde a operação aparece em um workflow. Os Workflows são automaticamente numerados sequencialmente, começando com o número 1.0 e aumentando em 1.0 para cada workflow subsequente (1.0, 2.0, 3.0, etc.). Dentro de um workflow, as operações são designadas automaticamente com um número decimal, começando com .0 e aumentando em .1 para cada operação subsequente. Para obter exemplos, consulte Projetando um Workflow em Criação e design de Workflow.

• Nome da operação: O nome da operação fornecido pelo usuário. Quando você cria uma nova operação, seu nome padrão é Nova Operação. As novas operações subsequentes com nomes padrão são anexadas a um número incrementado entre parênteses. Os nomes das operações devem ser exclusivos e não devem conter barras (/) ou dois pontos (:) Ser válido. Para renomear uma operação, consulte Renomeando Workflows, operações e etapas de operação mais adiante nesta página.

Barra de Ação de Operação¶

A barra de ação da operação aparece no canto superior direito de uma operação e consiste neste conjunto de ícones:

Ícone	Descrição
	Abre a aba Programações das configurações de operação (consulte Programações de operação). Este ícone é exibido somente quando uma operação já possui um cronograma atribuído.
	Abre as configurações de operação na aba Opções, onde você pode definir a configuração Ativar registro de depuração até (consulte Opções de operação). Um ícone sólido indica que o registro de depurar da operação está atualmente ativado no nível da operação. Um ícone delineado indica que o registro de depurar da operação está desabilitado no momento no nível da operação.
	Implanta a operação e suas dependências (consulte Implantando em Implantação e Execução da Operação). A presença de um fundo azul indica que a operação possui alterações não implantadas. Assim que a operação for implementada, o ícone será exibido sem o fundo azul (veja a descrição do próximo ícone, abaixo).
	Reimplementa a operação e suas dependências (consulte Implantando em Implantação e Execução da Operação). A ausência de um fundo azul indica que a versão atual da operação está implantada. Se houver alguma alteração não implantada, o ícone será exibido com fundo azul (veja a descrição do ícone anterior, acima).
	Implanta e executa a operação e quaisquer operações abaixo (vinculadas) (consulte Implantação e execução da operação).
	Executa uma operação já implantada e quaisquer operações abaixo (vinculadas) (consulte Implantação e execução de operação).
	Reduz a operação em uma visualização menor e condensada (consulte Operações de expansão ou recolhimento em Criação e configuração de operação). Este ícone é exibido somente quando a operação é expandida.
	Expande a operação para a visualização padrão (consulte Operações de expansão ou recolhimento em Criação e configuração de operação). Este ícone é exibido somente quando a operação é recolhida.
	Abre o menu de ações de operação, descrito posteriormente nesta página.

Etapas da Operação¶

Cada operação que já foi configurada com etapas de operação inclui uma representação visual dessas etapas. Cada etapa é representada por um quadrado que mostra um ícone que representa o componente, abaixo do qual está o nome do componente:

• Menu Ações: Cada etapa de operação possui um menu de ações que pode ser acessado clicando com o botão direito na etapa de operação ou usando o ícone do menu de ações . Cada item de menu é descrito em Menu Ações do Componente mais adiante nesta página.

• Ícone de plugin: Atividades que foram configuradas com um plugin que é executado na execução da operação exibem um ícone de plugin no canto superior direito da etapa de operação. Para obter mais informações, consulte Plugins adicionados a uma atividade.

• Ícone do ouvinte: As atividades do ouvinte são mostradas com um ícone que indica o status do ouvinte. Para obter mais informações, consulte o Serviço de escuta página.

  • Um ícone de ouvinte verde indica que a escuta está habilitada para esta atividade.

  • Um ícone de ouvinte cinza indica que a escuta não está habilitada para esta atividade.

• Eventos habilitados/Eventos desabilitados: Após a implantação de uma operação que contém uma atividade de ouvinte, uma alternância aparece. A alternância pode ser usada para ativar ou desativar a escuta de eventos para essa operação. Para obter mais informações, consulte o Serviço de escuta página.

Status da Operação¶

Sob certas circunstâncias, a seção inferior esquerda de uma operação consiste no status da operação e na opção de cancelar a operação:

• Status da operação: Depois que uma operação é enviada com êxito à fila de operação, o status da operação em tempo real é relatado no canto inferior esquerdo de uma operação. Para obter detalhes, consulte Status da operação em Implantação e Execução da Operação.

• Cancelar: Visível somente quando o status da operação for Enviado, Recebido, Pendente ou Em execução. Clique para enviar uma solicitação ao agente para cancelar a operação. Clicar em Cancelar envia uma solicitação ao agente para interromper a operação e um status Cancelamento solicitado é exibido próximo ao status da operação em tempo real:

  

  Nota

  As operações com status Cancelamento solicitado ainda poderão ser executadas.

Selecione Operações e Etapas de Operação¶

Para selecionar uma operação, clique no plano de fundo da operação. Uma operação selecionada é exibida com uma borda roxa delineando a operação. Neste exemplo, toda a operação Upsert Postgres Products foi selecionada:

Para selecionar uma etapa de operação, clique na representação visual da etapa. Uma etapa de operação selecionada é exibida com uma borda roxa delineando o componente. Neste exemplo, a transformação Magento Products to Postgres está selecionada:

Notificações¶

Uma representação visual de uma notificação aparece automaticamente na quadro de design quando você vincula uma notificação email usando a ação de operação Enviar notificação Email . Informações adicionais sobre a exibição visual dos links são fornecidas abaixo em Linhas.

A notificação email é exibida com um fundo cinza. Na área de fundo, a notificação email é representada por um quadrado que mostra um ícone, abaixo do qual está o nome da notificação email. Para selecionar uma notificação email, clique na representação visual dela. Uma notificação email selecionada é exibida com uma borda roxa delineando o componente:

Para ações de menu disponíveis em uma notificação email, consulte Menu de ações do componente mais adiante nesta página.

Referências de Operação¶

As operações que existem fora do workflow atual podem ser referenciadas a partir de uma operação no workflow atual. Quando tal operação é vinculada, uma representação visual da operação externa aparece automaticamente na quadro de design do workflow atual. Informações adicionais sobre a exibição visual dos links são fornecidas abaixo em Linhas.

A referência da operação é exibida com fundo cinza e contém ícones de formato que servem como uma representação geral das etapas da operação.

Uma operação que não existe em outro workflow é exibida apenas com o nome da operação:

Uma operação que existe em outro workflow é exibida com o nome do workflow, seguido pelo nome da operação. Clique nas palavras para abrir o workflow no qual a operação existe:

Linhas¶

As linhas que conectam operações vinculadas, scripts e notificações aparecem automaticamente na quadro de design. Os links podem ser criados usando ações de operação ou usando o RunOperation função.

A cor e a posição das linhas indicam o seu significado. Exemplos dessas linhas são fornecidos seguindo estas descrições:

• Verde: As linhas verdes são exibidas para uma condição Em sucesso e aparecem à esquerda das operações ou emails vinculados.
• Vermelho: Linhas vermelhas são exibidas para uma condição Em Falha e aparecem à direita das operações ou emails vinculados.
• Laranja: Linhas laranja são exibidas para uma condição On SOAP Fault e aparecem à direita das operações ou emails vinculados.
• Cinza: Linhas cinza são exibidas para uma operação chamada de um script usando o RunOperation função.

Na Condição de Sucesso¶

Em Condição de Falha¶

Na Condição de Falha SOAP¶

RunOperation Função¶

Menus de Ações¶

Os menus de ações acessíveis na quadro de design incluem aqueles para a quadro de design, componentes e zonas para soltar.

Menu de Ações do Quadro de Design¶

Clique no ícone do menu de ações no canto superior direito da quadro de design para abrir um menu com estas ações:

Item do menu	Descrição
	Desfazer reverte sua última ação (consulte Desfazer e Refazer em Permissões, colaboração e salvamento do Cloud Studio).
	Refazer reverte sua última ação Desfazer (consulte Desfazer e Refazer em Permissões, colaboração e salvamento do Cloud Studio).
	Implantar mostra estas ações de menu: Implantar: Implanta todas as operações usadas pelos workflows de um projeto (consulte Implantação do projeto). Implantação configurável: Abre a tela de implantação do projeto, onde você pode selecionar workflows e operações a serem implantar (consulte Implantação do projeto).
	Migrate abre a tela de migração do projeto, onde você pode escolher o ambiente de destino (consulte Migração do projeto).
	Histórico do projeto abre um painel no lado direito do designer do projeto onde você pode visualizar eventos do histórico do projeto, marcar eventos e restaurar projetos (consulte Histórico do projeto).

Menu de Ações do Componente¶

Para abrir o menu de ações de uma operação, siga um destes procedimentos:

• Clique com o botão direito em qualquer lugar na barra de ação da operação.
• Clique no ícone do menu de ações no canto superior direito de uma operação.

Para abrir o menu de ações de outro componente na quadro de design, incluindo etapas de operação (atividades, transformações ou scripts) e notificações email, siga um destes procedimentos:

• Clique com o botão direito na etapa de operação ou na notificação email.
• Passe o mouse sobre a etapa de operação ou notificação email e clique no ícone do menu de ações .

Algumas ações estão disponíveis apenas em determinados tipos de componentes, conforme detalhado nas subseções abaixo:

• Operações: O menu de ações para operações (mostrado na imagem à esquerda) possui itens exclusivos como Configurações, Duplicar, Executar, Ver Logs, Renomear, Ver dependências, Adicionar ao grupo e Excluir e submenus exclusivos para Implantar. Também inclui ações comuns como Cortar, Copiar e Remover.
• Atividades, Scripts, Transformações e Notificações Email: Os menus de ações desses componentes compartilham as mesmas ações, incluindo Visualizar/Editar, Cortar, Copiar e Remover (mostrados no menu de ações de uma atividade em a imagem certa).

Operações¶

Estes itens estão disponíveis no menu de ações de uma operação:

Item do menu	Descrição
	Configurações abre as configurações da operação, contendo três guias: Programações: Crie e aplique programações para executar operações automaticamente (consulte Programações de Operação). Ações: Configure ações a serem executadas em caso de sucesso ou falha da operação (consulte Ações de operação). Opções: Defina opções como quando a operação atingirá o tempo limite, o que registrar e o período de registro, quando a operação será executada ou se deseja usar fragmentação de dados (consulte Opções de operação).
	Publicar como API abre uma caixa de diálogo para configurar e publicar um API Manager API Customizada a ser usado para expor a operação para consumo (consulte Publicar como API). Esta ação só é visível quando a operação não tem alterações não implementadas.
	Cut coloca uma cópia da operação na área de transferência e exclui a operação original do projeto (consulte Reutilização de operação).
	Copiar coloca uma cópia da operação na área de transferência (consulte Reutilização de operação).
	Duplicar mostra essas ações de menu (consulte Operação Reutilizar): Com referências de etapas: Duplica apenas a operação. A operação duplicada contém referências a cada uma das etapas da operação original. Com Cópias de Etapas: Duplica a operação e os componentes referenciados como etapas de operação. Novos componentes são criados para cada etapa de operação e são referenciados pela operação duplicada.
	Deploy mostra estas ações de menu: Deploy: Implanta a operação e suas dependências (consulte Implantação e execução da operação). Implantar e executar: Implanta e executa a operação e quaisquer operações abaixo (vinculadas) (consulte Implantação e execução da operação). Implantação configurável: Abre a tela de implantação, onde você pode selecionar workflows e operações para implantar (consulte Implantação e execução de operações).
	Run executa uma operação já implantada e quaisquer operações abaixo (vinculadas) (consulte Implantação e execução de operação).
	Ver logs abre a tela de log de operação, que inclui logs desta operação e quaisquer operações filhas que foram implantadas e executadas (consulte Logs de operação).
	Renomear posiciona o cursor no nome da operação para você fazer as edições necessárias.
	Visualizar dependências altera a visualização no painel do projeto para exibir quaisquer outras partes do projeto das quais a operação específica depende (consulte Dependências de operação, exclusão e remoção).
	Adicionar ao grupo abre uma caixa de diálogo para criar um novo grupo personalizado ou para adicionar o componente a um grupo existente (consulte Grupos de componentes).
	Excluir exclui permanentemente o componente (consulte Dependências de operação, exclusão e remoção).
	Remover remove a operação da quadro de design. Quaisquer outras referências à operação, como em scripts, transformações ou definições de configuração, não são afetadas (consulte Dependências, exclusão e remoção de operação).

Atividades, Scripts, Transformações e Notificações Email¶

Os menus de ações para estes componentes compartilham as mesmas ações:

Item do menu	Descrição
	Visualizar/Editar abre a tela de configuração do componente. Para obter detalhes sobre a configuração, consulte o respectivo componente em Conectores, Scripts ou Transformações.
	Cut coloca uma cópia do componente na área de transferência e exclui o componente original do projeto (consulte Reutilização de componentes).
	Copiar coloca uma cópia do componente na área de transferência (consulte Reutilização de componentes).
	Remover remove o componente como uma etapa de operação da operação. Quaisquer outras referências ao componente, como em scripts, transformações ou definições de configuração, não são afetadas (consulte Dependências, exclusão e remoção de componentes).

Menu de Ações da Zona de Lançamento¶

As zonas de lançamento de operação estão sempre visíveis na quadro de design. Para mostrar a área de inserção de um componente que pode ser usado como uma etapa de operação, passe o mouse para a esquerda ou direita de uma etapa de operação em uma operação existente na quadro de design.

Para abrir o menu de ações para qualquer tipo de área de inserção, siga um destes procedimentos:

• Clique com o botão direito na área de inserção.
• Passe o mouse sobre a área de inserção e clique no ícone do menu de ações .

Tanto as zonas para soltar de operação quanto as zonas para soltar de outros componentes mostram os mesmos itens de menu:

Item do menu	Descrição
	Novo Script cria um novo script como uma etapa em uma operação nova ou existente (consulte Tipos de Script e criação). Quando usado em uma área de inserção de operações, uma nova operação também é criada.
	Nova Transformação cria uma nova transformação como uma etapa em uma operação nova ou existente (consulte Criação e configuração de Transformação). Quando usado em uma área de inserção de operações, uma nova operação também é criada.
	Colar cria uma duplicata de uma atividade, script, operação ou notificação email que está na sua área de transferência como um novo componente referenciado por uma operação nova ou existente (consulte Reutilização de componentes). Quando usado em uma área de inserção de operações, uma nova operação também é criada. O nome padrão do novo componente usa o nome do componente original anexado com -Copiar. As duplicatas subsequentes serão anexadas com um número incrementado entre parênteses.

Renomear Workflows, Operações e Etapas de Operação¶

Para renomear um workflow na quadro de design, clique duas vezes no nome na aba do workflow na parte superior da quadro de design:

Para renomear uma operação na quadro de design, clique no nome da operação:

Para renomear etapas em uma operação na quadro de design, clique no nome da operação:

Reordenar Operações¶

As operações no mesmo workflow podem ser reordenadas arrastando-as e soltando-as na quadro de design.

Clique e segure em qualquer lugar de uma operação para selecioná-la e arrastá-la para cima ou para baixo de outras operações no workflow:

Esta ação tem um efeito cascata de renumerar as operações acima ou abaixo dela na árvore do projeto.