UiPathアクティビティを開発する

Last updated on 2020年6月20日

UiPath のアクティビティって自分で作ることができるって知ってる？

えっそうなのニャ？

みなさん、こんにちはエピックです。

UiPathには、標準でたくさんのアクティビティが用意されています。

また、追加で公式・コミュニティまたは他の企業からアクティビティを追加することもできます。

それらを利用することでほとんどの業務は自動化することができてしまいます。

一方で、独自の機能に対応させるためにカスタマイズしたアクティビティを作成したいということがあります。

例えば、「専用のAPIを利用したい」「独自のAIモデルを利用するためにより簡単にPythonを利用したい」等がそうでしょうか。

今回は、そのような要望をいただいたのでUiPathのアクティビティを開発する方法を記載してみたいと思います。

少し複雑なので、分かりづらい等あればコメントにてお願いします。

事前準備するもの

開発するにあたり次の２つのソフトウェアが必要になります。

UiPtah Studio/ Robotはすでに導入している前提となります。

どちらのソフトウェアも個人利用であれば、無料で利用する事ができます。

リンク先のURLよりダウンロードしインストールをしてください。

※すみませんがインストール手順は省略します

開発の流れ

開発の手順は次のようになります。

Visual Studio で処理コード（C#）を記述
NuGetPackageExplorerで.dllファイルからNugetパッケージを作成
UiPath Studioからインストール

コードの記述については、C#を利用します。

あまりコードを書いたことのない方にとってはハードルが高い内容となります。

もしつまってしまった場合は連絡いただければと思います。

※すぐにはかえせないかもしれません

開発サンプル

今回開発するものがどのようなものか事前にお伝えします。

開発するアクティビティですが、２つの数字を受け取り平均（足して２で割る）を求める処理を行うアクティビティです。

Visual Studioでプロジェクトを作成する際、いくつかパラメータを設定するのですがこれらが実際のアクティビティの名称やパラメータに反映されます。

これらを意識して見てみてください。

Visual Studio で処理コード（C#）で記述

Visual Studio を起動します。

[ファイル] > [新規] > [プロジェクト] をクリックしプロジェクト作成画面を開きます。

左ペインから[Visual C#] を選択し、表示された中央のペインから[クラスライブラリ (.NET Framework)] を選択します。

[名前] フィールドには、今回のプロジェクトの名前を入力します。

[Solution name] と書かれた箇所が開発後のグループ名（アクティビティをまとめた単位）となるのでわかりやすい名称をつけるように気をつけてください。

入力が出来たら、[OK] をクリックします。

プロジェクト開発画面が起動します。

右側の【Solution Explorer】には、今回の開発材料が一覧になって表示されているのを確認してください。

ここで、UiPathで利用可能なアクティビティを開発するために、追加で次の２つの参照を追加する必要があります。

System.Activities
System.ComponentModel.Composition

先程つけた名前と同一の名称のフォルダを選択し、右クリックをします。

[追加] > [参照の追加]を選択します。

Reference Mnager】の新しいウィンドウが開きますので、右上の検索欄に先程の２つの参照名をそれぞれ入力し、右側のチェックボックスにチェックを入れます。

まず、"System.Activities"を検索し、右側にチェックします。

次に、"System.ComponentModel.Composition"を検索し、右側にチェックします。

２つともチェックが出来たら[OK]を選択します。

と、準備が終わりましたので、ようやくコードの記述を行っていきます。

先程加えた参照を使えるようにしましょう。

次の画像のように、using・・・で参照を追加します。

using System.Activities;
using System.ComponentModel;

加えて開発するカスタムアクティビティはUiPathで利用可能な"CodeActivity"クラスに準拠していなければなりません。

そのため、それを明示しておきます。

次の画像のように"CodeActivity"を記述してください。

エラーとなると思いますが、必要メソッド（Execute()）の実装不足であるため今は無視して問題ありません。

public class Class1 : CodeActivity
{

}

ようやく中身の記述です。

その前に簡単に記述方法を説明します。

UiPathのアクティビティは、インプットとアウトプットの引数（変数）とそれらを利用して行う処理から成り立っています。

それらを記述する必要がありますが、それぞれ記述する場所が決まっています。

まず、引数（変数）ですが、これらは"Class"〜"Execute"の間に、インプット・アウトプットどちらも記述をしてしまいます。

また、インプット・アウトプットを定義しているのはコードの"InArgument"と"OutArgument"という単語です。

処理については、"Execute()"の枠内に記述をします。

引数（変数）へアクセスするときは、getとsetを基本は利用します。

では、まず引数を記述します。

今回は、２つの数字を受け取りますので、２つの InArgument 、そして計算した結果を返すので一つの OutArgument となります。

//1つ目の数字
[Category("Input")]
[RequiredArgument]
public InArgument<Int32> FirstNumber { get; set; }

//2つ目の数字
[Category("Input")]
[RequiredArgument]
public InArgument<Int32> SecondNumber { get; set; }

//平均の結果
[Category("Output")]
[RequiredArgument]
 public OutArgument<Int32> ResultNumber { get; set; }

続いて、処理を記述します。

Execute() メソッドを定義し、その中に下記のコードを記述します。

protected override void Execute(CodeActivityContext context)
{
    int firstNumber = FirstNumber.Get(context);
    int secondNumber = SecondNumber.Get(context);

    int resultNumber = (firstNumber + secondNumber) / 2;

    ResultNumber.Set(context, resultNumber);
}

最終的なイメージは次のようになります。