Visionneuse low-code

Low-Code Viewer, l'extension Studio qui restitue les workflows C# codés sous la forme d'une zone de dessin visuelle low-code avec le code source.

La visionneuse low-code est une extension de Studio qui restitue un workflow codé - un fichier .cs dont la classe dérive de CodedWorkflow - sous la forme d'un workflow visuel low-code à côté de son code source, de la manière dont le concepteur RPA classique affiche une l'automatisation.

Il est destiné aux développeurs qui écrivent des workflows codés et souhaitent une vue visuelle propre et lisible de leur automatisation sans quitter le code C#.

Remarque :

La visionneuse low-code est en aperçu. Il est distribué en tant qu'extension Visual Studio Code sur le Marketplace Open VSX et nécessite la dernière version de Studio. Vous pouvez l'installer à partir du panneau Extensions dans Studio.

Ce que fait la visionneuse

La visionneuse fournit deux vues synchronisées d'un workflow codé, les maintient synchronisées avec le code source et source sa palette d'activités de votre projet.

Affichage du workflow

Une arborescence de style Studio qui couvre l'ensemble du fichier. Chaque méthode obtient une section avec ses variables et une ligne par instruction, avec des conteneurs imbriqués pour if, foreach, try et des constructions similaires.

Affichage sous forme de graphique

Un organigramme de la méthode d'entrée du workflow — la méthode marquée [Workflow] ou Execute. Les conditions et les commutateurs deviennent des nœuds de décision qui s'étendent par branche, les boucles sont itérées et terminées, et les appels à vos propres méthodes apparaissent sous forme de blocs d'invocation uniques. Le graphique reflète la forme de votre méthode d’entrée.

Suivre la source dans les deux cas

Le déplacement du curseur dans l'éditeur sélectionne le bloc correspondant, et la sélection d'un bloc passe à sa ligne. Les modifications de propriété apportées dans le panneau sont réécrites dans le fichier C# avec un minimum de modifications, de sorte que les commentaires et le formatage sont conservés.

La palette des activités

Lorsque la visionneuse s'exécute dans Studio, l'ensemble d'activités, ainsi que leurs éditeurs de propriétés, noms complets et icônes, sont extraits des packages référencés dans votre projet. Dans VS Code simple, sans Studio, les appels de service s’affichent toujours sous forme de cartes, mais avec des libellés génériques et sans métadonnées de propriété enrichies.

Comment l'observateur lit votre code

La zone de dessin est créée instruction par instruction. Chaque instruction correspond à un bloc dédié ou revient à un bloc de Code brut. Les instructions consécutives non reconnues sont fusionnées en une seule carte de bloc de code, de sorte qu'une exécution de code non pris en charge se réduit en une seule boîte invisible.

La visionneuse ne réécrit jamais le code que vous n'avez pas touché: tout ce qu'elle ne reconnaît pas est affiché textuellement dans une carte de bloc Code et les allers-retours restent inchangés. Rien que vous écrivez n’est perdu, mais plus votre code se trouve dans les blocs de code, moins la zone de dessin s’affiche.

Créations rendues sous forme de blocs

Vous écrivez	Vous obtenez
system.GetAsset(...), excel.ReadRange(...), autres appels de service	Carte d’activité avec icône, nom complet, propriétés modifiables et sortie saisie
Log(...), Delay(...), throw ...	Cartes d’activité intégrées (Message du journal, Retard, Générer)
var x = <expr>;, int x = 0;, x = <expr>;	Attribuer une carte (« à variable» et « valeur»)
count++;, count += 5;	Incrémenter ou Décrémenter la carte
if / else if / else	Conteneur de branche; diagramme de décision avec des bords vrai (true) et faux (false) dans le graphique
foreach, for, while, do ... while	Conteneur de boucle; nœud de boucle avec un bord arrière itéré dans le graphique
try / catch / finally	Essayer le conteneur avec un chemin d'erreur
switch Instruction	Commutateur de conteneur avec une branche de cas par branche; dans le graphique, une décision avec un bord libellé par cas
using (...) { }, lock (...) { }	Cadre de l’étendue
return <expr>;, throw <expr>;	Retourner la ligne ou lancer la carte; dans le graphique, les deux terminent le chemin
MyHelper(...) (méthode dans le même fichier)	Appeler le bloc; sélectionnez-le pour ouvrir l’assistant
Helpers.Method(...) (classe dans un autre fichier)	Appeler le bloc avec la navigation inter-fichiers
workflows.MyWorkflow(...)	Appeler la carte Workflow avec les badges d’argument In et Out
#region Name ... #endregion	Groupe nommé et réductible dans les deux vues

Créations qui basculent sur un bloc de code

Construire	Pourquoi la zone de dessin est-elle limitée
Lambdas au niveau de l’instruction (rows.ForEach(r => ...)) et logique à l’intérieur des lambdas	Le corps lambda est invisible dans la zone de dessin
Fonctions locales (void Helper() { ... } à l'intérieur d'une méthode)	Le corps de la fonction entier est ingéré dans le bloc de code
Déclarations sans initialiseur (string name;)	Se rend sous la forme d'une ligne de bloc de code
Déclarations à variables multiples (int a = 1, b = 2;)	Se rend sous la forme d'une ligne de bloc de code
using var x = ...; (formulaire de déclaration)	S'affiche sous la forme d'une seule ligne de bloc de code et appelle x perdre la reconnaissance de l'activité
arr[i] = value;, total *= 2;, msg += suffix;	Se rend sous la forme d'une ligne de bloc de code

Pour conserver autant de votre workflow que possible sur la zone de dessin, consultez Rédiger des workflows codés compatibles avec la zone de dessin.

Contenu associé

• Écrire des workflows codés conviviaux
• Introduction aux automatisations codées
• Meilleures pratiques