Canvas

visão geral do canvas o canvas da fluid é a área visual onde você modela integrações como fluxos de passos conectados cada passo representa uma ação (ex chamar uma api, transformar dados, aguardar, disparar e mail), e o conjunto forma um processo automatizado, testável e versionado conceitos chave conector componente que integra um serviço/sistema (api, banco, erp etc ) passo uma instância configurada de um conector no seu fluxo fluxo sequência orquestrada de passos que resolve um caso de uso canvas a superfície de arrastar e soltar onde você constrói o fluxo dados entre passos use as convenções de entrada/saída do canvas (ex input e step) para referenciar dados já produzidos anatomia do canvas top bar testar executa o fluxo (ou um passo) para validações rápidas salvar registra alterações em rascunho publicar promove a versão atual para execução histórico de versões consulta, compara e restaura versões ai assistant auxilia com dicas, geração de exemplos e inspeção de erros área de desenho arraste conectores, posicione passos, conecte nós e organize o layout renomeie passos para facilitar entendimento (ex get users) gavetas laterais conectores / meus modelos catálogo para arrastar novos passos monitoramento painel de logs em tempo real e histórico de execuções fluxo de trabalho recomendado modelagem inicial comece pelo caminho feliz (entrada → transformações → saída) acrescente validações e ramificações para exceções configuração de passos defina entradas, parâmetros, headers/credenciais e mapeie saídas padronize nomes de variáveis e chaves de resposta teste e depuração use testar durante a construção acompanhe o monitoramento para ver latência, payloads e respostas por passo ajuste até obter sucesso em todos os passos críticos versionamento e publicação salvar para consolidar mudanças revise o histórico , compare diffs e adicione comentários de release publicar quando estiver pronto para produção monitoramento tempo real visualize a execução passo a passo (status, duração e mensagens) filtre por status, pesquise por id de execução e reexecute quando aplicável histórico consulte execuções anteriores, identifique padrões de falha e gargalos use as informações para otimizar tempo de resposta e confiabilidade tratamento de erros boas práticas antecipe falhas prováveis (timeouts, validação de schema, credenciais) crie ramificações de erro (try/catch) com mensagens claras e contexto útil registre logs acionáveis (o que ocorreu, onde e com quais dados mínimos) estruture respostas de erro para facilitar reprocesso e alerta privacidade e segurança dados sensíveis aplique mascaramento/anonimização quando necessário use o princípio do menor privilégio nas credenciais evite logar pii ou segredos; guarde os em cofres apropriados governança documente propósitos, fontes e destinos de dados controle versões e mudanças via comentários de publicação checklist de qualidade modelagem fluxo claro do início ao fim e nomes descritivos entradas/saídas mapeadas com input/ step confiabilidade tratamento de erros com mensagens úteis e caminhos alternativos timeouts e retries configurados conforme o conector observabilidade logs concisos e suficientes para diagnóstico métricas de duração por passo observadas e otimizadas segurança segredos fora do código e pii não logada permissões mínimas e revisadas governança versão comparada e comentada antes de publicar mudanças documentadas (o que/por quê/impacto) dicas rápidas prefira pequenos passos coesos a passos “faz tudo” valide schemas (entrada/saída) para evitar efeito dominó centralize trechos reutilizáveis em flowkits/modelos faça testes locais frequentes; publique apenas quando tiver métricas estáveis glossário essencial canvas área visual de construção de fluxos conector componente que integra serviços passo instância configurada de um conector fluxo orquestração de passos monitoramento painel de logs e execuções scheduler agendamento de execução recorrente flowkit pacote de fluxos reutilizáveis publicar promover versão para execução oficial limitações e observações a profundidade de logs depende da configuração de cada passo agendamentos e reprocessos devem respeitar limites e quotas dos sistemas de destino integrações com dados sensíveis exigem políticas adicionais de segurança e auditoria parametrizações docid\ vpilzuenypycbjpp4yand