汎用スクリプトのデータソースを使用する

はじめに

UiPath Process Mining には、アプリケーションのデータソースとして使用できる外部ツール (R スクリプト、Python、JavaScript、Ruby、Swift など) でのデータ処理をサポートする機能が含まれています。

アプリケーション開発者は、外部プロセスにエクスポートする必要がある属性を定義できます。

注:

外部プロセスで使用できるのは、外部処理で明示的に使用可能になっている属性のみです。

外部ツールを使用したデータの処理

概要

データソースが再読み込みされると、 UiPath Process Mining プラットフォームによって定義された属性がファイルに出力されます。その後、開発者は指定した引数を使用して外部プロセスが実行されます。

外部プロセスは、ファイルからデータを読み取り、その結果を標準出力チャネルに書き込むことによって、その処理を行う必要があります。 外部プロセスは、標準エラー・チャネルに書き込むことで、進行状況指示、警告、エラーなどのメッセージを表示できます。

外部プロセスの標準出力チャネルのデータは、 UiPath Process Mining プラットフォームでは、セミコロンで区切られた二重引用符で囲まれたデータとして解釈されます。

下の図は、UiPath Process Mining プラットフォームから外部プロセスまでのデータ フローの概要を示したものです。その後、再度データ フローを確認できます。

汎用スクリプトのデータソース

このデータソースでは、mvscript ドライバーが使用されます。これはつまり、これがスクリプトのデータソースであることを意味します。 mvscript ドライバーが使用する script パラメーターは、汎用スクリプトを参照します。たとえば、次の接続文字列です。

‘driver={mvscript}; script=Rscript’

Rscript のデータソースを参照します。

このガイドでは、これらのデータソースを汎用スクリプトのデータソースと呼ガイドします。 原則として、「汎用」スクリプトはスクリプトをサポートするだけではなく、引数の適切な組み合わせを指定した実行可能ファイルもサポートします。

• ファイルからデータを読み取ることができる
• その結果をセミコロンで区切られたデータおよび二重引用符で囲まれたデータとして出力する。

ただし、汎用スクリプト のデータソースの主なターゲットは、R や Python などで書かれたカスタム スクリプトを実行することです。

サーバーの設定

汎用スクリプトのデータソースを使用する前に、[ サーバー設定] で使用可能なハンドラーを構成する必要があります。これを行うには、[サーバー設定] にキー GenericScriptHandlersを追加します。このキーの値はオブジェクトです。ここで、

• 各キーは、スクリプトの種類の識別子を示します。
• 各キーの値は、スクリプトのインタープリター実行可能ファイルへのパスを表します。

識別子には任意の文字列を指定できます。ただし、 UiPath Process Mining プラットフォームはスクリプト ファイルの拡張子から正しいハンドラーを自動検出しようとするため、スクリプト ファイルの拡張子を使用することをお勧めします。以下は、 GenericScriptHandlers サーバー設定の例です。

"GenericScriptHandlers": {
    "r": "D:/R/R.exe",
    "py": "P:/Python/bin/python.exe",
    "perl": "C:/Strawberry/perl/bin/perl.exe"
}

拡張子 '.r' と '.py' を含むキーによって、R と Python の実行可能ファイルが自動的に選択されます。

注:

通常、拡張子が '.pl' である Perl スクリプトの場合、自動検出は "perl" ハンドラを選択しません。この場合、高度なクエリ パラメーター scriptType を指定して、目的のハンドラーを識別できます。

権限

Microsoft を実行する Windows ユーザー (例: IIS_IUSRS) は、スクリプト ハンドラーから参照される実行可能ファイルを実行するための適切な権限を持っている必要があります。 そうしない場合、実行可能ファイルが見つかりません。

データ ソース

汎用スクリプトのデータソースを構成するには、generic スクリプトで mvscript ドライバーを使用する接続文字列テーブルを作成する必要があります。汎用スクリプトには複数のパラメーターがあり、通常は scriptFile パラメーターと inputData パラメーターのみを指定する必要があります。残りは UiPath Process Mining プラットフォームによって推測できるためです。

パラメーターの概要

次の表で、スクリプトの generic パラメーターの概要を示します。

パラメーター	説明	必須 Y/N
scriptFile	スクリプトへのパスです。たとえば、 resources/my_script.r です。 注: scriptFile 代わりに、 scriptText 引数を使用することもできます。	n
スクリプトの種類	scriptFileに使用するハンドラー。GenericScriptHandlers内のハンドラーの 1 つである必要があります。	n
入力データ	処理のためにスクリプトに渡される必要のあるデータ。	Y
debugPath	フォルダーの絶対パスです。このパラメーターを指定すると、 UiPath Process Mining は以下の出力を行います。 • 入力ファイル (外部プロセスに渡される) • 外部プロセスの出力 (外部プロセスの標準出力から読み取るように) デバッグ目的でこのフォルダーに保存されます。	n
args	スクリプトのハンドラーに渡す追加の引数の配列です (例: Python を使用する場合)。このオプションを使用して -I フラグを渡し、分離モードを有効化できます。 • 配列要素の少なくとも 1 つは、コマンドラインのどこにスクリプトファイルへのパスを挿入するかを示すテキスト <SCRIPT> である必要があります。• 配列要素の少なくとも 1 つは、コマンドラインのどこに入力ファイルへのパスを挿入するかを示すテキスト <INPUT> である必要があります。	n

テーブルの範囲

スクリプトの場所は、テーブルの範囲を基準にした相対的な場所として解釈されます。そのため、テーブルスコープは サーバー または ワークスペースのいずれかに設定する必要があります。[なし] に設定すると、スクリプト ファイルへのパスが存在せず、データの読み込みが失敗します。テーブルの範囲は、[ テーブルの詳細オプション] で設定できます。

データ

データは、受信外部プロセスに最も便利な方法でエクスポートできます。

外部スクリプトで処理するデータをエクスポートするには、以下の手順に従います。

手順	操作
1	スクリプトで使用できる必要があるフィールドを決定します。
2	アプリケーション内に新しいグローバル テーブルを作成します。
3	手順 1 の各フィールドのグローバル テーブルに検索式属性を作成します。

注:

その後、この表をエクスポートして、スクリプトで読み取ることができます。csvtable() 関数を使用すると、データを CSV のような形式に変換できます。この関数は (テキスト) レコードのリストを必要とするため、検索式の結果の型はテキストのリスト、つまり、すべてのデータがリストにエンコードされた 1 つのレコードである必要があります。

API インターフェイス

UiPath Process Mining と、汎用スクリプトのデータソースを介してアクセスする外部プロセスとの間のインターフェイスは、以下のように定義されます。

手順	説明
1	UiPath Process Mining によって、 inputData パラメーターで指定したデータを含むファイルが作成されます。
2	外部プロセス: • ファイルからデータを読み取ります。•その処理を実行します。• 結果をセミコロンで区切られた二重引用符の形式で標準出力チャネルに書き込みます。出力の 1 行目は、列名を指定するヘッダーである必要があります。例えば： "Case_ID"; "Amount" "110553"; "73650" "110565"; "14420" "110689"; "262370" "110754"; "3500" "110939"; "50270" "111155"; "2400" "111251"; "27530" "111251"; "27530" "111397"; "123450" "111418"; "100"
3	外部プロセスは、任意のステータス メッセージをその標準エラー チャネルに書き込みます。
4	外部プロセスが、ゼロのステータス コード、成功を示す、または非ゼロのステータス コードで終了し、失敗を示します。
5	UiPath Process Mining は、外部プロセスによって返されたステータス コードを評価します。 ステータス コードが • 0 の場合、外部プロセスの標準出力チャネルは、セミコロンで区切られた二重引用符で囲まれたデータとして解析されます。• 0 以外の場合、外部プロセスによって標準エラーチャネルに書き込まれたメッセージを含むエラーメッセージが表示されます。テーブルの読み込みは中止されます。