例: R スクリプトを作成する

はじめに

この例では、 UiPath Process Mining プラットフォームを外部 R スクリプトとインターフェイスさせて外部データ処理を実装する方法について説明します。

R をインストールする

プラットフォームで R スクリプトを使用できるようにするには、以下の手順に従います。

手順	操作
1	R パッケージの最新バージョンのダウンロード場所 https://cran.r-project.org/bin/windows/base/。
2	R をサーバーにインストールします。 注: これは、 UiPath Process Mining がインストールされているサーバーである必要があります。
3	インストール ディレクトリを見つけて、Rscript.exe のパスを見つけます。 例: C:/Apps/Rscript.exe

R はサーバーにインストールされ、開発者は接続文字列を使用して接続できます。

R スクリプトの接続文字列を作成するには、インストール パスが必要です。

重要:

ダミー データから始めて、ワークスペースの設定をテストします。たとえば、「 例: Python スクリプトの作成」で説明されているように、"Hello World" の例を使用します。ダミーのRスクリプトには、次のものが含まれます write("Hello world!", stderr()); quit("default", 1)

概要

この例では、R スクリプトが作成され、そのトレースに基づくクラスター ケースが作成されます。

手順

1. サーバーの設定を設定する
2. スクリプトを記述する。
3. データ ソースを設定する
4. スクリプト のデータ ソースを設定する

サーバー設定を設定する

汎用スクリプトのデータソースには、実行するすべての外部プロセスのハンドラーが必要です。

R スクリプトのスクリプト ハンドラーを追加するには、以下の手順に従います。

手順	操作
1	[Superadmin Settings] タブに移動します。
2	値として Python 実行可能ファイルへのパスを持つ 1 つのキー "r" を持つオブジェクトを値としてフィールド GenericScriptHandlers を追加します。例: "GenericScriptHandlers": {"r": "C:/Apps/Rscript.exe",}
3	[保存] をクリックします。

スクリプトを記述する

テキスト エディターで空のテキスト ファイルを開始し、次のコードを入力します。

# get command line arguments
args <- commandArgs(trailingOnly=TRUE)
inputfile <- args[1]
# read csv file
input <- file(inputfile, 'r')
df <- read.table(input, header=TRUE, sep=";")
# pre-processing
df <- table(df)
df <- as.data.frame.matrix(df)
df <- df[, sapply(data.frame(df), function(df) c(length(unique(df)))) > 1] #remove columns with unique value 
# cluster
df <- scale(df)
kc <- kmeans(df, centers = 5)
cluster <- kc$cluster
# output
resultdata <- cbind(rownames(df), cluster)
colnames(resultdata)[1] <- 'Case ID'
write.table(resultdata, row.names = FALSE, sep=";", qmethod = "double")

以下の手順を実行します。

手順	操作
1	テキスト ファイルを script.rとして保存します。
2	script.r ファイルをワークスペースにアップロードします。

データ ソースを設定する

入力データを定義するには、 .CSV のような文字列を生成する属性を作成します。これはテーブル定義の入力として機能するため、 グローバル テーブルに配置する必要があります。

注:

csvtable 関数を使用して入力データを定義できます。

この例では、 Events テーブルを持つアプリケーションがあります。以下の画像でご確認ください。

グローバル テーブルからイベントにR_input_dataするルックアップ式を作成するには、以下の手順に従います。

手順	操作
1	開発環境でアプリを開き、[ データ ] タブに移動します。
2	[グローバル] テーブルを選択します。テーブル項目リスト内の グローバル テーブルを右クリックし、[ 新しい式...] を選択します。
3	[種類] を [検索] に設定します。
4	入力テーブルとして [ イベント ] を選択します。
5	以下の式を入力します。 csvtable( 'CaseID', records.text(Case_ID) , 'Activity', records.text(Activity) )
6	[名前] フィールドに「 R_input_data 」と入力します。
7	[OK] をクリックして、式の属性を [グローバル] テーブルに保存します。

式属性は グローバル テーブルに作成されます。以下の画像でご確認ください。

スクリプト データ ソースを設定する

次に、スクリプトを呼び出すデータソーステーブルをアプリケーションに設定します。

スクリプト データ ソースを設定するには、以下の手順に従います。

手順	操作
1	[ データ ] タブで、新しい接続文字列テーブルを作成します。
2	New_table の名前を「 RscriptExample」に変更します。
3	RscriptExample テーブルを右クリックし、[詳細] > [オプション...] をクリックします。
4	[テーブル オプション] ダイアログで、[テーブル スコープ] を [ワークスペース] に設定します。
5	RscriptExample テーブルをダブルクリックして、[接続文字列テーブルを編集] ウィンドウを開きます。
6	接続文字列として「'''driver={mvscript」と入力します。
7	「クエリ」として以下を入力します'' +'&scriptFile=' + urlencode("script.r") +'&inputData=' + urlencode(R_input_data) 以下の画像でご確認ください。
8	[OK] をクリックし、[はい] をクリックしてデータを再読み込みします。

データを読み込むと、新しい属性が検出されます。YES(2x)をクリックし、OKをクリックします。

Rscript_example テーブルには、Case_ID と cluster の 2 つのデータソース属性が追加されました。

以下の画像でご確認ください。

[クエリ] フィールドで R スクリプトを定義する

R スクリプトを含む別のファイルを使用する代わりに、[接続文字列の編集] ダイアログの [クエリ] フィールドで R スクリプトを定義することもできます。その場合は、scriptFile パラメーターの代わりに scriptText パラメーターを使用します。

以下の画像でご確認ください。