RPA デスクトップデザインスタジオ のユーザープラグインを作成する
Microsoft Visual Studio を使用してユーザープラグインを作成し、RPA 開発者が複雑な .NET コンポーネントやライブラリを RPA デスクトップデザインスタジオ でシームレスに使用できるようにします。
始める前に
Microsoft Visual Studio Pro、Community、Enterprise のうち、いずれかのバージョンを使用して、このタスクを実行します。
必要なロール:なし
このタスクについて
次の手順では、C#.NET を使用してユーザープラグインを作成する方法について説明します。
手順
- Microsoft Visual Studio を開き、[新しいプロジェクトを作成] をクリックします。
-
[新しいプロジェクトを作成] ダイアログボックスで、クラスライブラリ (.NET Framework) テンプレートを選択します。
図 : 1. クラスライブラリ DOT NET Framework のプロジェクトタイプを選択する - [次へ] をクリックします。
-
[新しいプロジェクトを構成 (Configure your new project)] ダイアログボックスで、次のフィールドに入力します。
フィールド 説明およびアクション プロジェクト名 プロジェクトの名前です。 たとえば、「MyFirstPlugin」です。
ロケーション プロジェクトの場所です。 ディスクの場所を選択します。
ソリューション名 プロジェクトのソリューション名です。 フレームワーク フレームワークのバージョンを選択します。 [.NET Framework 4.7] バージョンを選択します。
-
[作成] をクリックします。
Class1.cs ファイルが開きます。
- [ソリューションエクスプローラー (Solution Explorer)] ペインで、[参照] を右クリックし、[参照を追加] を選択します。
- [参照マネージャー] ダイアログボックスで、 アセンブリ > フレームワーク.
-
[System.AddIn] アセンブリを選択して、このアドインの注釈を追加します。
図 : 2. [System.AddIn] アセンブリを選択する - [OK] をクリックします。
-
Class1.cs ファイルで、
System.AddIn.AddIn("MyFirstPlugin", Description = "Learning to create custom components", Version = "1.0")コードスニペットをクラスの上に追加します。 -
Class1.cs ファイルで、コードにパブリック静的メソッドを 1 つ以上作成します。
この例では、2 つのメソッドをコードに追加しています。
- [SayHello] メソッド:名前が入力として取得され、名前の後に感嘆符の付いた「Hello」が返されます。たとえば「User」と入力すると、「Hello User!」が返されます。
- [Sum] メソッド:2 つの数値が入力として取得され、これら 2 つの数値の合計が返されます。たとえば「5」と「12」を入力すると、「17」が返されます。
図 : 3. パブリック静的メソッド - [保存] をクリックします。
- [ソリューションエクスプローラー (Solution Explorer)] ペインで、プロジェクトを右クリックし、[ビルド] を選択します。
-
ビルドが成功したら、次のアクションを実行し、.dll ファイルをコピーして貼り付けます。
- [ソリューションエクスプローラー (Solution Explorer)] ペインで、プロジェクトを右クリックし、[ファイルエクスプローラーでフォルダーを開く(Open Folder in File Explorer)] を選択します。
- 移動先 ビン > デバッグ をクリックし、.dllファイルをコピーします。
-
RPA デスクトップデザインスタジオ 自動化プロジェクトフォルダーに移動し、新しいフォルダーを [UserPlugins] として作成します。
重要:このフォルダーのスペルが正しく入力されていることを確認してください。
-
[UserPlugins] フォルダーでフォルダーを作成し、そのフォルダーの名前を入力します。
たとえば、「My First Plugin」です。
- このフォルダーに .dll ファイルを貼り付けます。
-
RPA デスクトップデザインスタジオ で次のアクションを実行し、自動化プロジェクトにプラグインを追加します。
- [プロジェクトエクスプローラー (Project Explorer)] ペインで、[ユーザープラグイン (User Plugins)] を右クリックし、[ユーザープラグインの追加 (Add User Plugin)] を選択します。
- [利用可能なユーザープラグイン (Available User Plugins)] ダイアログボックスで、プラグインを選択します。
- [OK] をクリックします。
[ツールボックス] ペインに、作成したユーザープラグインが表示されます。 -
次のアクションを実行し、ユーザープラグインを使用します。
-
[ツールボックス] ペインで、ユーザープラグインコンポーネントカテゴリに移動し、メソッドを選択します。
図 : 4. ユーザープラグインコンポーネントカテゴリに表示される 2 つのメソッド - メソッドを [デザイン面 (Design surface)] にドラッグします。
- 入力パラメーター値を手動で指定するには、メソッドの下の入力パラメーターフィールドをダブルクリックし、値を入力します。
- 別のメソッドまたはコンポーネントから入力パラメーター値を指定するには、メソッドのデータ入力ポートを別のメソッドまたはコンポーネントのデータ出力ポートに接続します。
- メソッドのコントロールポートを別のメソッドまたはコンポーネントの対応するポートに接続します。
-
[デザイン面 (Design surface)] で、実行を開始するコンポーネントのタイトルバーを右クリックし、[ここから実行 (Run From Here)] を選択します。
図 : 5. SayHello メソッドの出力 図 : 6. Sum メソッドの出力
-
[ツールボックス] ペインで、ユーザープラグインコンポーネントカテゴリに移動し、メソッドを選択します。