SDK Activités Studio

Le package UiPath.Activities.API SDK est hébergé sur le flux d'activités Official (https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json).

Entre autres, le package est utilisé pour :

Création de règles de l'analyseur de workflow en ajoutant des descriptions, des paramètres et en les intégrant dans la fenêtre Paramètres de l’analyseur de workflow ( Workflow Analyzer Settings ) de Studio.
Création de paramètres de projet d'activité en ajoutant des catégories, des sections, des champs de saisie numériques, des listes modifiables et en les intégrant dans la fenêtre Paramètres de projet d' activité (Activity Project Settings) de Studio, un peu comme les activités des paquets UiPath.
Créer des assistants personnalisés et les intégrer dans le ruban de Studio.

Attention : Le package UiPath.Activities.API SDK doit être utilisé comme dépendance de développement dans votre projet personnalisé. En savoir plus sur Dépendances de développement.

Utilisation de l'API

Lorsque les activités sont chargées dans Studio, une référence à IWorkflowDesignApi est fournie de plusieurs manières :

Dans l'implémentation IRegisterMetadata, ajoutez une méthode public void Initialize(object api). Cette méthode est appelée pendant le processus de chargement d'activité et l'activité peut stocker le paramètre api pour une utilisation ultérieure.
Définissez une classe qui implémente IRegisterWorkflowDesignApi. La méthode IRegisterWorkflowDesignApi.Initialize(IWorkflowDesignApi api) est appelée pendant le processus de chargement de l'activité, et l'activité peut stocker le paramètre api pour une utilisation ultérieure. Lorsque vous utilisez cette méthode, seules les versions de Studio à partir de 2019.6 sont capables de charger votre package.
Obtenez une référence de l'objet api en appelant context.Services.GetService<IWorkflowDesignApi>() où context est un System.Activities.Presentation.EditingContext, généralement accessible aux concepteurs d'activités.

Touches de fonctionnalité de conception

Il est important d'effectuer une vérification préliminaire par rapport à DesignFeatureKeys pour voir si les touches de fonctionnalité nécessaires sont prises en charge. Pour plus d'informations, consultez les DesignFeatureKeys.

Pour vérifier une fonction, vous devez appeler la méthode HasFeature sur la référence IWorkflowDesignApi , sinon les appels aux méthodes api pertinentes pourraient échouer avec MissingMemberException ou MissingMethodException sur les anciennes versions de Studio.

IWorkflowDesignApi studioActivitiesApi;
            // How to check for a feature.
            if (studioActivitiesApi.HasFeature(UiPath.Studio.Activities.Api.DesignFeatureKeys.Settings))
            {
                // Call Method or lambda that is using specific feature
                // This ensures that the code is JIT compiled only after the feature check
           }IWorkflowDesignApi studioActivitiesApi;
            // How to check for a feature.
            if (studioActivitiesApi.HasFeature(UiPath.Studio.Activities.Api.DesignFeatureKeys.Settings))
            {
                // Call Method or lambda that is using specific feature
                // This ensures that the code is JIT compiled only after the feature check
           }