Studio-Aktivitäten-SDK

Das UiPath.Activities.API SDK-Paket wird im Feed für offizielle Aktivitäten gehostet (https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json).

Das Paket wird unter anderem verwendet für:

• Erstellen von Workflow-Analyseregeln durch Hinzufügen von Beschreibungen, Parametern und Integrieren in das Einstellungsfenster Workflow-Analyse von Studio.

  

• Erstellen von Aktivitätenprojekteinstellungen durch Hinzufügen von Kategorien, Abschnitten, numerischen Eingabefeldern, Kombinationsfeldern und Integrieren in das Fenster Aktivitätsprojekteinstellungen in Studio, ähnlich wie Aktivitäten aus UiPath-Paketen.

  

• Erstellen benutzerdefinierter Assistenten und Integrieren in das Studio-Menüband.

  

  Wichtig:

  Das UiPath.Activities.API SDK-Paket muss als Entwicklungsabhängigkeit in Ihrem benutzerdefinierten Projekt verwendet werden. Lesen Sie mehr über Entwicklungsabhängigkeiten.

So verwenden Sie die API

Wenn die Aktivitäten in Studio geladen werden, wird auf verschiedene Arten ein Verweis auf IWorkflowDesignApi bereitgestellt:

1. Fügen Sie innerhalb der IRegisterMetadata-Implementierung eine public void Initialize(object api)-Methode hinzu. Diese Methode wird während des Aktivitätsladevorgangs aufgerufen, und die Aktivität kann den api-Parameter für die spätere Verwendung speichern.
2. Definieren Sie eine Klasse, die IRegisterWorkflowDesignApi implementiert. Die Methode IRegisterWorkflowDesignApi.Initialize(IWorkflowDesignApi api) wird während des Aktivitätsladevorgangs aufgerufen, und die Aktivität kann den api -Parameter für die spätere Verwendung speichern. Wenn Sie diese Methode verwenden, können nur Studio-Versionen ab 2019.6 Ihr Paket laden.
3. Rufen Sie einen Verweis auf das api-Objekt ab, indem Sie context.Services.GetService<IWorkflowDesignApi>() aufrufen, bei dem context ein System.Activities.Presentation.EditingContext ist, auf den in der Regel Aktivitätsdesigner zugreifen können.

Design-Funktionstasten

Vorab muss eine Überprüfung auf DesignFeatureKeys durchgeführt werden, um zu sehen, ob die erforderlichen Funktionsschlüssel unterstützt werden. Weitere Informationen finden Sie unter DesignFeature Keys.

Um nach einer Funktion zu suchen, müssen Sie die HasFeature-Methode in der IWorkflowDesignApi-Referenz aufrufen. Anderenfalls schlägt der Aufruf der entsprechenden API-Methoden mit MissingMemberException oder MissingMethodException für ältere Studio-Versionen möglicherweise fehl.

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
           }

Schnittstellen

Folgende Schnittstellen sind verfügbar:

• IExtensionsInstallerService
• IOrganizationalSettingsService
• IRegisterAnalyzerConfiguration
• IRegisterWorkflowDesignApi
• IStudioDesignSettingsService
• IWorkflowDesignApi
• IWindowOperationsService