Saiba como testar seus pipelines ou cápsulas usando o Painel de Execução na Digibee Integration Platform.
Esta funcionalidade se chamava "Test mode" até junho de 2023.
O Painel de Execução permite testar um pipeline ou cápsula no ambiente de testes enquanto você projeta o fluxo. Ele utiliza valores de teste dos serviços Globals, Contas, Relacionamento e Multi-Instância.
Esse recurso ajuda a validar a lógica da implementação e depurar o fluxo em tempo real, sem precisar fazer o deploy.
Visão geral do Painel de Execução
Você pode abrir o Painel de Execução no canto inferior esquerdo do Canvas ou pressionando Cmd (ou Ctrl) + D.
O painel inclui quatro abas:
Payload: Insira dados de teste
Results: Revise o input, output e resultados de teste
Messages: Inspecione o output de cada conector
Logs: Rastreie eventos e erros
Aprenda mais sobre cada aba:
Aba Payload
Nessa aba, você define o payload de teste utilizado durante a execução. É possível:
Selecionar uma instância específica: Quando um pipeline está configurado como multi-instância, o menu Multi-instância é exibido para que você escolha a instância do teste. Para mais detalhes, consulte a documentação de Multi-Instância.
Salvar o payload: Você pode salvar um payload para uso futuro. Clique no ícone de salvar e dê um nome a ele. Os payloads salvos são específicos de cada pipeline ou cápsula e não são compartilhados entre fluxos diferentes.
Uma vez salvos, os payloads aparecem na coluna Payloads. Você pode Excluir ou Aplicar um payload. Payloads salvos não podem ser editados. Caso altere algo, será necessário salvar como um novo payload.
Formatar o JSON: Para melhorar a leitura, use o ícone da varinha mágica para formatar o JSON automaticamente.
Ao executar uma cápsula, a coluna Parâmetros será exibida. Nela, você deve preencher os parâmetros e valores de conta de acordo com a configuração da cápsula.
Aba Resultados
Após a execução do teste, o resultado aparece na aba Resultados, uma visualização somente leitura dos dados de entrada e saída do pipeline. Nessa aba, você pode:
Copiar o JSON de saída para a área de transferência.
Pesquisar elementos específicos do JSON de saída com uma expressão JSONPath.
Essa aba é especialmente útil durante a execução de casos de teste, pois qualquer falha de asserção é exibida aqui, facilitando a validação.
Aba Mensagens
A aba Mensagens mostra o resultado da execução de cada conector no pipeline, com até 5.000 mensagens. Cada conector recebe o payload do anterior, processa conforme sua função e gera um novo payload em resposta.
Lista de mensagens: Inclui o nome da mensagem, correspondente ao Step Name do conector, e o tempo de execução em milissegundos. É possível buscar por nome completo ou parcial da mensagem, ou por um parâmetro do conector.
Pré-visualização da mensagem: Permite baixar o JSON como arquivo, copiá-lo ou aplicar um filtro com JSONPath.
Aba Logs
A aba Logs contém informações sobre os eventos registrados durante a execução do pipeline. Nela, é possível filtrar por tipo, copiar mensagens e pesquisar por parte ou todo o conteúdo da mensagem.
A lista de logs exibe os seguintes dados:
Tipo de log: Classificação do log, indicada por um ícone. Tipos disponíveis:
Info: Informações gerais
Alerta: Avisos durante a execução
Erros: Erros ocorridos na execução
Timestamp: Data e hora da execução do passo
Mensagem: Conteúdo de cada log
Além de realizar testes, é possível importar e exportar arquivos de execução diretamente pelo painel.
Importar
Clique em Importar execução para carregar um arquivo com dados de execução.
Os dados de execution aparecem no painel, mas currentFlowSpec e executedFlowSpec não são exibidos no Canvas.
Só é possível reexecutar se estiver no mesmo pipeline de origem e o fluxo original ainda existir.
Exportar
Clique em Exportar execução para baixar um arquivo contendo os dados do pipeline e da execução. Certifique-se de que os dados estejam totalmente carregados antes de exportar.
O arquivo exportado inclui:
pipelineId e pipelineName
currentFlowSpec: Fluxo no Canvas no momento da exportação
executedFlowSpec: Fluxo no momento da execução
realm: Realm do pipeline
execution: Payload, Output, Mensagens e Logs
Caso nenhuma execução tenha sido feita, apenas os metadados do pipeline serão exportados.
Executando o fluxo
Executar um fluxo permite que você teste e valide seu pipeline e cápsula, garantindo que funcionem conforme esperado. É possível executar o fluxo completo ou apenas uma parte dele, dependendo das suas necessidades.
Como executar o fluxo inteiro
Você pode executar o fluxo inteiro utilizando uma das seguintes opções:
Pressione Cmd (Ctrl) + Enter.
Abra o Painel de execução e clique em Executar.
Abra o Painel de execução, clique na seta ao lado de Executar e selecione Executar pipeline ou Executar cápsula.
Independentemente de haver conectores selecionados, essas opções sempre executarão o fluxo inteiro.
Como executar parte do fluxo
Para executar uma parte específica do fluxo:
Etapa 1: Selecione os conectores
Escolha os conectores desejados utilizando uma das seguintes opções:
Segure Shift e arraste o mouse sobre os conectores.
Segure Shift e clique em cada conector individualmente.
Certifique-se de que os conectores selecionados estejam conectados e em sequência. Saltar um conector no meio da sequência invalidará a seleção.
Etapa 2: Execute a seleção
Após selecionar os conectores, execute a parte escolhida do fluxo de uma das seguintes formas:
Pressione Cmd (Ctrl) + Shift + Enter.
Abra o Painel de execução, clique na seta ao lado de Executar e selecione Executar seleção.
Como executar a partir de um passo específico
Você pode iniciar a execução do pipeline a partir de qualquer passo escolhido, garantindo que todos os passos seguintes no fluxo sejam executados. Para isso, siga estes passos:
Clique no conector onde deseja iniciar a execução.
Abra o Painel de execução.
Clique no menu suspenso ao lado de Executar e selecione Executar daqui. Você também pode utilizar o atalho Ctrl + Alt + Enter para Windows ou Cmd (⌘) + Option (⌥) + Enter para macOS.
O pipeline será então executado a partir do passo selecionado e continuará com o restante do fluxo.
Informações adicionais
Abaixo você encontrará alguns detalhes importantes sobre o Painel de execução e teclas de atalho úteis.
Inatividade do Painel de execução
Se o Painel de execução ficar inativo por 24 horas sem uso, ele será desativado. Ao reabrir o Canvas, pode levar até 3 minutos para o Painel ficar ativo novamente.
Atalho de teclado
macOS
⌘ + D: Abre ou fecha o Painel de Execução
⌘ + Enter: Executa o fluxo completo
⌘ + Shift + Enter: Executa os conectores selecionados
⌘ + ⌥ + Enter: Executa a partir de um passo selecionado
Windows
Ctrl + D: Abre ou fecha o Painel de Execução
Ctrl + Enter: Executa o fluxo completo
Ctrl + Shift + Enter: Executa os conectores selecionados
Ctrl + Alt + Enter: Executa a partir de um passo selecionado