Visor de código bajo

Visor de código bajo, la extensión de Studio que representa los flujos de trabajo C# codificados como un lienzo visual de código bajo junto con el código fuente.

El Visor de código bajo es una extensión de Studio que representa un flujo de trabajo codificado, un archivo .cs cuya clase se deriva de CodedWorkflow, como un flujo de trabajo visual de código bajo junto a su código fuente, la forma en que el diseñador RPA clásico muestra un automatización.

Está dirigido a desarrolladores que escriben flujos de trabajo codificados y desean una vista visual limpia y legible de su automatización sin salir del código C#.

Nota:

El visor de código bajo está en vista previa. Se distribuye como una extensión de Visual Studio Code (VS Code) en el mercado Open VSX y requiere la última versión de Studio. Puedes instalarlo desde el panel Extensiones en Studio.

Qué hace el espectador

El visor proporciona dos vistas sincronizadas de un flujo de trabajo codificado, las mantiene sincronizadas con el código fuente y obtiene su paleta de actividades de tu proyecto.

Vista de flujo de trabajo

Un árbol al estilo de Studio que cubre todo el archivo. Cada método obtiene una sección con sus variables y una fila por declaración, con contenedores anidados para if, foreach, try y construcciones similares.

Vista de gráfico

Un diagrama de flujo del método de entrada del flujo de trabajo: el método marcado como [Workflow] o Execute. Las condiciones y los conmutadores se convierten en nodos de decisión que se distribuyen por rama, los bucles obtienen bordes de iteración y finalización, y las llamadas a tus propios métodos aparecen como bloques Invoke únicos. El gráfico refleja la forma de tu método de entrada.

Seguir el origen en ambos sentidos

Al mover el cursor en el editor se selecciona el bloque correspondiente, y al seleccionar un bloque se salta a su línea. Las ediciones de propiedades realizadas en el panel se vuelven a escribir en C# con ediciones mínimas, por lo que se conservan los comentarios y el formato.

La paleta de actividades

Cuando el visor se ejecuta dentro de Studio, el conjunto de actividades, junto con sus editores de propiedades, nombres para mostrar e iconos, se activa desde los paquetes a los que hace referencia tu proyecto. En VS Code simple, sin Studio, las llamadas de servicio se siguen renderizando como tarjetas, pero con etiquetas genéricas y sin metadatos de propiedades enriquecidos.

Cómo lee el espectador tu código

El lienzo se crea declaración por declaración. Cada declaración se asigna a un bloque dedicado o recurre a un bloque de código sin formato. Las declaraciones consecutivas no reconocidas se fusionan en una sola tarjeta de bloque de código, por lo que una ejecución de código no compatible se colapsa en un cuadro opaco.

El visor nunca reescribe el código que no has tocado: cualquier cosa que no reconozca se muestra palabra por palabra en una tarjeta de Bloqueo de código y los viajes de ida y vuelta sin cambios. Nada de lo que escribes se pierde, pero cuanto más código cae en bloques de código, menos se muestra en el lienzo.

Construcciones representadas como bloques

Escribes	Obtienes
system.GetAsset(...), excel.ReadRange(...), otras llamadas de servicio	Tarjeta de actividad con icono, nombre para mostrar, propiedades editables y salida escrita
Log(...), Delay(...), throw ...	Tarjetas de actividad integradas (Mensaje de registro, Retraso, Lanzamiento)
var x = <expr>;, int x = 0;, x = <expr>;	Asignar tarjeta ("a variable" y "valor")
count++;, count += 5;	Incrementar o decrementar tarjeta
if / else if / else	Contenedor de ramas; rombo de decisión con bordes verdaderos y falsos en el gráfico
foreach, for, while, do ... while	Contenedor de bucles; nodo de bucle con un borde posterior de iteración en el gráfico
try / catch / finally	Pruebe el contenedor con una ruta de error
switch Declaración	Cambiar el contenedor con un brazo de caso por rama; en el gráfico, una decisión con un borde etiquetado por caso
using (...) { }, lock (...) { }	Marco de ámbito
return <expr>;, throw <expr>;	Devolver fila o Lanzar tarjeta; en el gráfico, ambos terminan la ruta
MyHelper(...) (método en el mismo archivo)	Invocar bloque; selecciónalo para abrir el asistente
Helpers.Method(...) (clase en otro archivo)	Invocar bloque con navegación entre archivos
workflows.MyWorkflow(...)	Invocar tarjeta de flujo de trabajo con insignias de argumento de entrada y salida
#region Name ... #endregion	Grupo contraíble con nombre en ambas vistas

Construcciones que recurren a un bloque de código

Construir	Por qué limita el lienzo
Lambdas en el nivel de declaración (rows.ForEach(r => ...)) y lógica dentro de lambdas	El cuerpo lambda es invisible para el lienzo
Funciones locales (void Helper() { ... } dentro de un método)	Todo el cuerpo de la función se incorpora al bloque de código
Declaraciones sin inicializador (string name;)	Se renderiza como una fila de bloque de código
Declaraciones multivariables (int a = 1, b = 2;)	Se renderiza como una fila de bloque de código
using var x = ...; (formulario de declaración)	Se renderiza como una fila de bloque de código y las llamadas en x pierden el reconocimiento de actividad
arr[i] = value;, total *= 2;, msg += suffix;	Se renderiza como una fila de bloque de código

Para mantener la mayor parte posible de tu flujo de trabajo en el lienzo, consulta Escribir flujos de trabajo codificados compatibles con el lienzo.

Contenido relacionado

• Escribir flujos de trabajo codificados compatibles con lienzos
• Introducción a las automatizaciones codificadas
• Mejores prácticas