sdk

latest

false

Important :

Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.

Guide du développeur

Last updated 25 oct. 2024

SDK Activités Studio

Le package .API du SDK UiPath Activities 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 et 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 deprojet d'activité en ajoutant des catégories, des sections, des champs de saisie numériques, des zones de liste modifiable 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 packages 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 les 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.

Afin de vérifier une fonctionnalité, 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
           }