自動データ更新を設定する

はじめに

UiPath Process Mining にデータを頻繁に、または間隔を置いて読み込む場合は、自動データ更新を設定できます。このガイドでは、一括スクリプトを使用して自動データ更新を設定する方法について説明します。

スクリプトを実行すると、指定したデータセット名を使用するデータセットのフォルダー構造が最初に生成されます。 その後、コネクタ内のすべてのテーブルが再読み込みされ、指定されたモジュール用にキャッシュされます。 これらのキャッシュ テーブルは、コネクタから出力テーブルをエクスポートするために使用されます。 出力データセットを使用して、指定した環境でアプリケーションのキャッシュを生成します。

前提条件

UiPath Process Mining のインストールを含むサーバーまたは仮想マシンへのアクセス権が必要です。

ワークスペースにコネクタも必要です。

注:

スクリプトはワークスペースを偽装します。コネクタ用のワークスペースを作成し、ワークスペースが最新の状態に保たれていることを確認する必要があります。データ更新では、コミットされていないすべての変更 (存在する場合) を使用して、指定されたワークスペースをそのまま使用します。そのため、データの更新専用のワークスペースを使用することをお勧めします。

重要:

このバッチスクリプトでは、ワークスペースとSuperadminのビルドが同一である必要があります。ワークスペースのビルドを変更せずに Superadmin のビルドを更新すると (またはその逆)、スクリプトは失敗し、データは更新されません。そのため、すべての場所 (Superadmin、コネクタ、その他のアプリケーション) で同時にビルドを更新することをお勧めします。

ステップ1: 準備

以下のコード サンプルから、データの自動更新に使用するバッチ スクリプトを作成し、 UiPath Process Mining インストールのルート フォルダーに保存します。

注:

バッチファイル名には、プロセスの名前とシステムの名前を含めることをお勧めします。

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax_datasets\%DATASET%"
mkdir "%MAINDIR%\datax_datasets\%DATASET%_org"
echo. > "%MAINDIR%\datax_datasets\%DATASET%\nomodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax_datasets\%DATASET%_org\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax_datasets\%DATASET%_org\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*

手順 2: スクリプトのパラメーターを設定する

以下で、スクリプトで指定する必要があるパラメーターについて説明します。

パラメーター	説明
データセット	スクリプトから生成する出力データセットの名前です。このデータセットは、 Superadmin の [開発データ ] タブに表示されます。
ロボット グループ	キャッシュを生成する環境です。 注: 通常、これはプロセスの AppOne がアクティブになる環境です。
ワークスペース	コネクタが配置されているワークスペースへのパスです。これは、 ログイン名 の後に ワークスペース の名前が続くものです。 スクリプトで正しいワークスペースが見つからない場合は、バックスラッシュではなくスラッシュを使用してみてください。

ワークスペース名

ワークスペースへのパスを決定するには、以下の手順に従います。

手順	操作
1	UiPath Process Mining のインストール フォルダーに移動します。
2	ワークスペースフォルダーに移動します。
3	[あなたのログイン名]フォルダーに移動します。このフォルダーには、各ワークスペースのフォルダーが含まれています。

重要:

ログイン名に特殊文字が含まれている場合、ユーザー名フォルダーは HTML 用にエンコードされます。ただし、スクリプトで使用するには、%を3つ追加してエスケープする必要があります。例: ユーザー名が [e-mail] の場合、フォルダー test%2Eexample%40uipath%2Ecomに変わります。スクリプトでは、ユーザー名は test%%%%2Eexample%%%%40uipath%%%%2Ecomのように指定する必要があります。ユーザー名にアンダースコアが含まれている場合は、このアンダースコア('_')を %%%%5Fでエスケープする必要があります。

手順 3: コネクタ モジュール コードを追加する

一部のコネクタには複数のモジュールがあるため、データの自動更新を実装するコネクタのモジュール コードを指定する必要があります。

for %M in (…) do ループにコネクタのモジュール コードを追加します。

モジュール コードを見つけてスクリプトに追加するには、以下の手順に従います。

手順	操作
1	開発環境でコネクタを開きます。
2	ロゴ アイコンをクリックして [ モジュール...] を選択します。
3	[アプリケーション コード] フィールドからモジュール コードをコピーします。
4	CANCELをクリックして、Modulesダイアログを閉じます。
5	コネクタを閉じます。
6	スクリプトで「..」を置き換えます。( ) 内にコネクタのモジュール コードが for %M in (…) do ループに含まれます。

手順 4: 同期のタスクのスケジュールを設定する

Windows のタスク スケジューラーを使用すると、バッチ スクリプトを実行するタスクをスケジュールして、データの更新を自動化できます。

注:

Windows のタスク スケジューラでタスクを作成する場合は、[タスクの作成] ウィンドウでタスクの実行者にローカルの SYSTEM ユーザー アカウントを選択し、[最上位の特権で実行する] オプションを選択することをお勧めします。

このタスクにかかる時間は、コネクタ内を移動するデータの量によって大きく異なります。 タスクの実行時間が多すぎる場合は、次の事項を順番に検討することをお勧めします。

• コネクタに入るデータ ボリュームを最小限に抑えます。
• データの重複の原因となる、誤った結合条件がないかチェックします。
• コネクタ内の未使用の属性をすべて削除します (コネクタの追加の属性ごとに、スクリプトの実行時間が増加します)。
  重要:

  実行が 3 日以上続いているタスクは取り消すことを強くお勧めします。