Écriture du code d'une activité personnalisée

Pour mieux comprendre comment écrire le code d'une activité personnalisée, nous allons créer une activité simple qui demande à l'utilisateur deux nombres, puis génère le carré de leur somme.

1. Lancer Microsoft Visual Studio.
2. Sélectionner Fichier > Ctrl + Shift + N > Projet . La fenêtre Nouveau projet s’affiche.
3. Sélectionnez C# dans le menu déroulant Langues . La liste de toutes les dépendances utilisant C# s'affiche.
4. Sélectionnez Bibliothèque de classes (.NET Framework). Ceci nous permet d'exporter l'activité personnalisée en tant que fichier .dll . Sélectionnez Suivant pour accéder à la fenêtre Configurer votre nouveau projet .
   
   

   

   
   
5. Renseignez le champ Nom du projet avec le nom d'activité souhaité. Dans notre cas, nous pouvons utiliser "MathSquareOfSum" ).
6. Sélectionnez .NET Framework 4.6.1 dans le menu déroulant Framework . Cela garantit que la bibliothèque est compatible avec UiPath Studio.
   Attention : dans les projets hérités depuis Windows, UiPath Studio prend en charge les activités créées avec .NET Framework 4.5.2 à 4.6.1. Pour plus d'informations sur la migration des activités vers .NET pour une utilisation dans des projets avec la compatibilité Windows, voir Migration des activités vers .NET 6.

   
   

   

   
   
7. Sélectionnez Créer pour accéder au concepteur de code et commencer à écrire le code d’activité.
8. Dans le panneau Explorateur de solutions , cliquez avec le bouton droit sur la branche Références et sélectionnez Ajouter une référence... (Add Reference...). La fenêtre Gestionnaire de références ( Reference Manager) s'affiche.
9. Recherchez les références System.Activities et System.ComponentModel.Composition et ajoutez-les. Assurez-vous de cocher la case devant chacun d'eux et cliquez sur OK. Cela nous permet d’utiliser les classes des références susmentionnées.
   
   

   

   
   

   
   

   

   
   
10. Maintenant, nous devons nous assurer que notre code utilise les références nouvellement ajoutées. Cela se fait en ajoutant les lignes suivantes dans le concepteur de code :

    using System.Activities;
    using System.ComponentModel;

    Notre projet devrait maintenant ressembler à ceci :

    
    

    

    
    
11. Ajoutez les paramètres d'entrée et de sortie. Dans notre cas, le code devrait ressembler à ceci :

    //Note that these attributes are localized so you need to localize this attribute for Studio languages other than English
     
    //Dots allow for hierarchy. App Integration.Excel is where Excel activities are.
    [Category("Category.Where.Your.Activity.Appears.In.Toolbox")]
    [DisplayName("Human readable name instead of class name")]
    [Description("The text of the tooltip")]
     public class MathSqSum : CodeActivity
    {
     
        //Note that these attributes are localized so you need to localize this attribute for Studio languages other than English
                 [Category("Input")]
            [DisplayName("First Number")]
            [Description("Enter the first number")]
            [RequiredArgument]
            public InArgument<int> FirstNumber { get; set; }
            [Category("Input")]
            [DisplayName("Second Number")]
            [Description("Enter the second number")]
            [RequiredArgument]
            public InArgument<int> SecondNumber { get; set; }
            [Category("Output")]
            public OutArgument<int> ResultNumber { get; set; }
            protected override void Execute(CodeActivityContext context)
            {
            }

    L'attribut <DisplayName(" ")> est le libellé qui s'affiche avant le champ de saisie dans le panneau Propriétés (Properties) de Studio. L'attribut <Description(" ")> est le texte de l'info-bulle affichée au survol de la souris.

    
    

    

    
    

    L'attribut <ReguiredArgument> est nécessaire si vous souhaitez qu'un élément déclaré soit obligatoire pour l'entrée. Si elle n'est pas renseignée, une icône de prudence apparaît dans la barre de titre de l'activité.
12. Ajoutez la fonctionnalité dans la fonction remplacée <Execute( )> . Dans notre cas, il ressemble à ceci :

    protected override void Execute(CodeActivityContext context)
    {
        var firstNumber = FirstNumber.Get(context);
      var secondNumber = SecondNumber.Get(context);
      
      var result = (int)Math.Pow(firstNumber + secondNumber, 2);
      ResultNumber.Set(context, result);
    }

(Facultatif) Création d'une interface de conception

Si vous ne souhaitez pas que votre activité ait une interface de concepteur, vous pouvez passer à la section construction de la bibliothèque.

Important :

Pour créer une interface de concepteur, le composant Windows Workflow Foundation doit être installé dans Visual Studio. Si vous n'avez pas sélectionné le composant dans le programme d'installation Visual Studio, vous pouvez l'ajouter comme suit :

• Dans Visual Studio, cliquez sur le menu Outils et sélectionnez Obtenir les outils et fonctionnalités.... La fenêtre Visual Studio Installer s'affiche.
• Basculez sur l'onglet Composants individuels ( Individual Components ) et recherchez le composant Windows Workflow Foundation . Il se trouve sous la section Activités de développement (Development activities ).
• Cochez la case devant le composant Windows Workflow Foundation et cliquez sur Modifier ( Modify). Le composant requis est installé.

1. Faites un clic droit sur le projet à partir du panneau Propriétés (dans notre cas, le projet est MathSquareOfSum). Le menu contextuel s’affiche.
2. Dans le champ Ajouter un élément, sélectionnez Nouvel élément.... La fenêtre Ajouter un nouvel élément s'affiche.
3. Sélectionnez Workflow sous la catégorie Installed du panneau gauche. Tous les éléments associés sont affichés.
4. Sélectionnez Concepteur d'activités et cliquez sur Ajouter pour inclure l'élément dans le projet.
   
   

   

   
   

   L'élément Concepteur d'activités est ajouté et le fichier .xaml correspondant est immédiatement ouvert. Il devrait ressembler à ceci :

   
   

   

   
   
5. Remplacez le code Designer d'activités existant par le code suivant :

   <sap:ActivityDesigner x:Class="MathSquareOfSum.MathSqSumDesigner"
       xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
       xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
       xmlns:s="clr-namespace:System;assembly=mscorlib"
       xmlns:sap="clr-namespace:System.Activities.Presentation;assembly=System.Activities.Presentation"
       xmlns:sapc="clr-namespace:System.Activities.Presentation.Converters;assembly=System.Activities.Presentation"
       xmlns:sapv="clr-namespace:System.Activities.Presentation.View;assembly=System.Activities.Presentation">
       <a href="sap:ActivityDesigner.Resources">sap:ActivityDesigner.Resources</a>
           <ResourceDictionary>
               <sapc:ArgumentToExpressionConverter x:Key="ArgumentToExpressionConverter" />
           </ResourceDictionary>
       </sap:ActivityDesigner.Resources>
       <DockPanel Width="300">
           <Grid>
               <Grid.ColumnDefinitions>
                   <ColumnDefinition Width="90"></ColumnDefinition>
                   <ColumnDefinition Width="210"></ColumnDefinition>
               </Grid.ColumnDefinitions>
               <Grid.RowDefinitions>
                   <RowDefinition></RowDefinition>
                   <RowDefinition></RowDefinition>
                   <RowDefinition></RowDefinition>
               </Grid.RowDefinitions>
               <TextBlock Grid.Row="0" Grid.Column="0" Text="First Number"></TextBlock>
               <sapv:ExpressionTextBox Grid.Row="0" Grid.Column="1"  OwnerActivity="{Binding Path=ModelItem}" ExpressionType="s:Int32" HintText="Enter first number" Expression="{Binding Path=ModelItem.FirstNumber, Converter={StaticResource ArgumentToExpressionConverter},ConverterParameter=In, Mode=TwoWay}" />
               <TextBlock Grid.Row="1" Grid.Column="0" Text="Second Number"></TextBlock>
               <sapv:ExpressionTextBox Grid.Row="1" Grid.Column="1"  OwnerActivity="{Binding Path=ModelItem}" ExpressionType="s:Int32" HintText="Enter second number" Expression="{Binding Path=ModelItem.SecondNumber, Converter={StaticResource ArgumentToExpressionConverter},ConverterParameter=In, Mode=TwoWay}" />
               <TextBlock Grid.Row="2" Grid.Column="0" Text="Result"></TextBlock>
               <sapv:ExpressionTextBox Grid.Row="2" Grid.Column="1"  OwnerActivity="{Binding Path=ModelItem}" ExpressionType="s:Int32" HintText="The sum of the numbers" UseLocationExpression="True" Expression="{Binding Path=ModelItem.ResultNumber, Converter={StaticResource ArgumentToExpressionConverter},ConverterParameter=Out, Mode=TwoWay}" />
           </Grid>
       </DockPanel>
   </sap:ActivityDesigner>

   La nouvelle mise en page définie pour l'activité devrait maintenant ressembler à ceci :

   
   

   

   
   
6. Cliquez avec le bouton droit sur l'activité (dans notre cas ActMathSquareOfSum), et dans le menu Ajouter , sélectionnez Classe.... La fenêtre Ajouter un nouvel élément s'affiche.
7. L'élément Class est déjà sélectionné. Il suffit maintenant de le renommer DesignerMetadata.cs et de sélectionner Add. La nouvelle classe est maintenant ajoutée à l’activité et s’ouvre dans un nouvel onglet.
   
   

   

   
   
8. Ajoutez le contenu suivant dans la nouvelle classe ConcepteurMétadonnées :

   using MathSquareOfSum;
   using System.Activities.Presentation.Metadata;
   using System.ComponentModel;
   namespace ActMathSquareOfSum
   {
       public class DesignerMetadata : IRegisterMetadata
       {
           public void Register()
           {
               AttributeTableBuilder attributeTableBuilder = new AttributeTableBuilder();
               attributeTableBuilder.AddCustomAttributes(typeof(MathSqSum), new DesignerAttribute(typeof(MathSqSumDesigner)));
               MetadataStore.AddAttributeTable(attributeTableBuilder.CreateTable());
           }
       }
   }