Visualizador de pouco código

Visualizador de baixo código, a extensão do Studio que renderiza fluxos de trabalho codificados em C# como uma tela visual de pouco código ao lado do código-fonte.

O Visualizador de pouco código é uma extensão do Studio que renderiza um fluxo de trabalho codificado — um arquivo .cs cuja classe deriva de CodedWorkflow — como um fluxo de trabalho visual e de pouco código ao lado de seu código-fonte, da maneira como o designer de RPA clássico mostra um automação.

Ele é voltado para desenvolvedores que escrevem fluxos de trabalho codificados e desejam uma visualização limpa e legível de sua automação sem sair do código C#.

Observação:

O Visualizador de pouco código está em pré-visualização. Ele é distribuído como uma extensão Visual Studio Code (VS Code) no Open VSX marketplace e requer a versão mais recente do Studio. Você pode instalá-las a partir do painel Extensões no Studio.

O que o visualizador faz

O visualizador fornece duas visualizações sincronizadas de um fluxo de trabalho codificado, mantém-nas em sincronia com o código-fonte e fornece sua paleta de atividades ao seu projeto.

Visualização do fluxo de trabalho

Uma árvore no estilo do Studio que cobre todo o arquivo. Cada método obtém uma seção com suas variáveis e uma linha por instrução, com contêineres aninhados para if, foreach, try e construções semelhantes.

Exibição de gráfico

Um fluxograma do método de entrada do fluxo de trabalho — o método marcado [Workflow] ou Execute. Condições e chaves tornam-se nós de decisão que se estendem por ramificação, os loops obtêm bordas iteradas e concluídas, e as chamadas para seus próprios métodos aparecem como blocos Invoke únicos. O gráfico espelha a forma do seu método de entrada.

Seguindo a origem em ambos os casos

Mover o cursor no editor seleciona o bloco correspondente, e selecionar um bloco salta para sua linha. As edições de propriedades feitas no painel são gravadas no C# com edições mínimas, assim, os comentários e a formatação são preservados.

A paleta de atividades

Quando o visualizador é executado dentro do Studio, o conjunto de atividades — juntamente com seus editores de propriedades, nomes de exibição e ícones — vem dos pacotes que o seu projeto faz referência. No VS Code simples, sem o Studio, as chamadas de serviço ainda são renderizadas como cartões, mas com rótulos genéricos e sem metadados de propriedades avançados.

Como o visualizador lê seu código

A tela é criada instrução por instrução. Cada instrução mapeia para um bloco dedicado ou retorna a um bloco de Código bruto. Instruções consecutivas não reconhecidas são mescladas em um único cartão de bloco de código, de modo que uma execução de código não compatível é recolhida em uma caixa opaca.

O visualizador nunca reescreve código em que você não tocou: qualquer coisa que ele não reconheça é mostrado textualmente em um cartão de bloco de código e viagens de ida e volta inalteradas. Nada que você escrever é perdido, mas quanto mais do seu código estiver em blocos de código, menos a tela mostrará.

Construções renderizadas como blocos

Você escreve	Você recebe
system.GetAsset(...), excel.ReadRange(...), outras chamadas de serviço	Cartão de atividade com ícone, nome de exibição, propriedades editáveis e saída digitada
Log(...), Delay(...), throw ...	Cartões de atividades integrados (Mensagem de Log, Atraso, Lançar)
var x = <expr>;, int x = 0;, x = <expr>;	Atribuir cartão ("para variável" e "valor")
count++;, count += 5;	Cartão de aumentar ou diminuir
if / else if / else	Contêiner de ramificação; Projeto de decisão com bordas verdadeiras e falsas no gráfico
foreach, for, while, do ... while	Contêiner de loop; nó de loop com uma borda posterior de iteração no gráfico
try / catch / finally	Contêiner de teste com caminho de erro
switch Instrução	Contêiner de Switch com um grupo de Case por ramificação; no gráfico, uma decisão com uma borda rotulada por caso
using (...) { }, lock (...) { }	Quadro de escopo
return <expr>;, throw <expr>;	Retornar linha ou gerar cartão; no gráfico, ambos terminam o caminho
MyHelper(...) (método no mesmo arquivo)	Invocar bloco; selecione-o para abrir o auxiliar
Helpers.Method(...) (classe em outro arquivo)	Invocar bloco com navegação entre arquivos
workflows.MyWorkflow(...)	Invocar cartão de fluxo de trabalho com selos de argumento In e Out
#region Name ... #endregion	Grupo nomeado e recolhível em ambas as visualizações

Construções que retornam a um bloco de código

Construir	Por que isso limita a tela
Lambdas no nível de instrução (rows.ForEach(r => ...)) e lógica dentro de lambdas	O corpo lambda é invisível para a tela
Funções locais (void Helper() { ... } dentro de um método)	O corpo inteiro da função é incluído no bloco de código
Declarações sem um inicializador (string name;)	Renderiza como uma linha de bloco de código
Declarações de várias variáveis (int a = 1, b = 2;)	Renderiza como uma linha de bloco de código
using var x = ...; (formulário de declaração)	É renderizado como uma linha de bloco de código e as chamadas em x perdem o reconhecimento da atividade
arr[i] = value;, total *= 2;, msg += suffix;	Renderiza como uma linha de bloco de código

Para manter o máximo possível de seu fluxo de trabalho na tela, consulte Escrevendo fluxos de trabalho codificados compatíveis com a tela.

Conteúdo relacionado

• Escrevendo fluxos de trabalho codificados compatíveis com a tela
• Introdução de automações codificadas
• Melhores práticas