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 への参照がいくつかの方法で提供されます。

1. IRegisterMetadata の実装に public void Initialize(object api) メソッドを追加します。このメソッドはアクティビティの読み込みプロセスで呼び出され、読み込まれたアクティビティは後で使用するため api パラメーターを保存します。
2. IRegisterWorkflowDesignAPI を実装するクラスを定義します。メソッド IRegisterWorkflowDesignApi.Initialize(IWorkflowDesignApi api) はアクティビティの読み込みプロセス中に呼び出され、アクティビティは後で使用するために api パラメーターを格納できます。この方法を使用すると、パッケージを読み込むことができるのは 2019.6 以降のバージョンの Studio のみです。
3. 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
           }

インターフェイス

次のインターフェイスを使用できます。

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