SDK

Studio アクティビティ SDK

UiPath.Activities.API SDK パッケージは、オフィシャルアクティビティフィード (https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json) でホストされています。

特に、このパッケージは以下に使用されています。

説明やパラメーターを追加してワークフローアナライザーのルールを作成し、それを Studio の [ワークフローアナライザーの設定] ウィンドウに組み込みます。
カテゴリ、セクション、数値入力フィールド、コンボボックスを追加してアクティビティプロジェクト設定を作成し、これらを UiPath パッケージのアクティビティと同様に、Studio の [アクティビティのプロジェクト設定] ウィンドウに組み込みます。
カスタムウィザードを作成し、Studio のリボンに統合する

重要: カスタムプロジェクトでは開発依存関係として UiPath.Activities.API SDK パッケージを使用する必要があります。開発依存関係については、こちらをご覧ください。

API の使用法

アクティビティが Studio に読み込まれると、 IWorkflowDesignApi への参照がいくつかの方法で提供されます。

IRegisterMetadata の実装に public void Initialize(object api) メソッドを追加します。このメソッドはアクティビティの読み込みプロセスで呼び出され、読み込まれたアクティビティは後で使用するため api パラメーターを保存します。
IRegisterWorkflowDesignApiを実装するクラスを定義します。アクティビティの読み込みプロセス中に IRegisterWorkflowDesignApi.Initialize(IWorkflowDesignApi api) メソッドが呼び出され、アクティビティは後で使用するために api パラメーターを格納できます。この方法を使用すると、v2019.6 の Studio のみがパッケージを読み込むことができます。
api オブジェクトへの参照を、context.Services.GetService<IWorkflowDesignApi>() を呼び出すことで取得します。ここで、context は、通常アクティビティの設計者がアクセス可能な System.Activities.Presentation.EditingContext です。

デザイン機能キー

必要な機能キーがサポートされているかどうかを確認するには、 DesignFeatureKeys に対して予備チェックを実行することが重要です。詳細については、 DesignFeatureKeysをご覧ください。

フィーチャーをチェックするには、IWorkflowDesignApi の参照に対して HasFeature メソッドを呼び出す必要があります。これを行わないと、Studio のより古いバージョンでは、関連する API メソッドの呼び出しが MissingMemberException または MissingMethodException で失敗する可能性があります。

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
           }