カスタム変数

Insights always ingests data via the pre-defined fields available in the Insights data model, but Admins can also configure custom variables extracted from robot logs and queues to use for calculating specific KPIs or building more specialized dashboards.

ヒント:

• プロセスにカスタム変数を含めるには、まず Studio の [UiPath.System.Activities.AddLogFields] アクティビティを介してその変数がオートメーションのログに追加されていることを確認してから、取り込むためにその変数を選択する必要があります。
• キューのカスタム変数を含めるには、まずその変数が Studio の以下のアクティビティを介してワークフローに追加されていることを確認してください。その後、それらの変数を取り込むよう選択する必要があります。
  • 固有データには UiPath.System.Activities.AddQueueItem アクティビティを使用します。
  • 出力データと分析データには UiPath.System.Activities.SetTransactionStatus アクティビティを使用します。

カスタム変数を設定する

カスタム変数を設定するには、管理者は次の手順に従う必要があります。

1. Insights の任意のページの右上隅にある 3 点リーダー メニューをクリックして開き、[カスタム変数を設定] を選択します。設定ページが開き、抽出できるすべてのカスタム フィールドが一覧表示されます。

2. プロセスとキューのどちらにカスタム変数を設定するかを指定するには、設定ページの上部にある対応するタブを選択します。

   

3. [抽出] 列で、ダッシュボードの構築に使用するカスタム変数を選択します。

4. [型] 列でカスタム変数の型を選択します。[String]、[Number]、[DateTime] から選択できます。

   重要:

   • フィールドには最大で 40 文字を入力でき、この数を超えた文字は切り捨てられます。40 文字を超える文字を追加するには、Insights.Etl.Json.MaxStringLen フラグを変更します。このフラグを Orchestrator の Web 構成に追加し、プロジェクトのニーズに従って値を設定できます。以下に例を示します。

   <add key="Insights.Etl.Json.MaxStringLen" value="60" />

   • バックフィルの進行状況には、すべてのプロセスまたはキューからのカスタム変数の抽出の進行状況が表示されます。バックフィルの最新の進行状況を確認するには、ページを更新する必要があります。データのサイズによっては、少し時間がかかる場合があります。カスタム変数の値は、最新のデータから最も古いデータの順にバックフィルされます。このフィールドは、設定を保存するとすぐに使用できるようになります。100% バックフィルされるまで待つ必要はありません。
   • 変数を抽出できるプロセスまたはキューはテナントあたり最大 500 個、変数はプロセスまたはキューあたり最大 200 個です。
   • カスタム変数の [型] を [Number] に設定する場合は、変数に , や他の数字以外の文字 ($ など) が含まれていないことを確認してください。これらの文字はサポートされていません。特殊文字が含まれる数値の場合は、[型] として [String] を選択します。
   • カスタム変数の設定が変更されるたびに、その特定のプロセスに対して完全なバックフィルが新規に行われます。バックフィルの時間は、その特定のプロセスに対して Insights データベースに保存されているログの数によって異なります。

5. 設定を保存します。特定のプロセスに対して抽出された変数はすべて、「*プロセス - プロセス名」という名前の Explore に表示され、特定のキューに対して抽出された変数はすべて、「*キュー - キュー名」という名前の Explore に表示されます。

   重要:

   変数を抽出できるプロセスまたはキューはテナントあたり最大 500 個、変数はプロセスまたはキューあたり最大 200 個です。

   設定されたカスタム変数の数	ハードウェア スケール	プロセスの数	プロセスあたりのロボット ログの数	おおよその抽出時間
   30	大規模	1	1,000,000	5 分
   30	大規模	1	40,000,000	120 分

既存の設定を編集する

既存の設定を編集するには、管理者は次の手順に従う必要があります。

1. Insights の任意のページの右上隅にある 3 点リーダー メニューをクリックして開き、[カスタム変数を設定] を選択します。設定ページが開き、抽出できるすべてのカスタム フィールドが一覧表示されます。
2. プロセスとキューのどちらにカスタム変数を設定するかを指定するには、設定ページの上部にある対応するタブを選択します。
3. 以前選択した変数を削除するには、[抽出] チェックボックスをオフにします。
4. 変数の型を変更するには、ドロップダウン リストから目的の新しい型を選択します。
5. 設定は忘れずに保存してください。
6. 変更または削除した変数を使用している既存のダッシュボードで、以下の項目を確認します。
   1. 変数を削除した場合は、作成・変更された式、フィルター、またはビジュアリゼーション内から、その変数への参照をすべて削除してください。
   2. 変数の型を変更した場合は、新しい型が引き続き正しく適用されていることを確認してください。

設定例

このセクションでは、ダッシュボードでカスタム変数を使用する例を示します。

カスタム変数を設定するには、以下の手順に従います。

1. 抽出対象として「ProcessCount」変数を選択し、[String] 型を選択します。

2. Argument1_Email 変数を有効化し、[文字列] 型を選択して [保存] を選択します。

   

3. ダッシュボード画面に戻って新しいダッシュボードを作成し、新しいタイルを追加します。

4. [*プロセス - CustomLogs2] Explore を選択して CustomLogs2 ビューを選択し、設定したカスタム変数をこのプロセスからタイルで使用します。

   

カスタム変数、null の大文字と小文字

カスタム変数は、以下のセクションで説明するような特定のケースで、値が null になることがあります。

シナリオ 1

ビジュアリゼーションで標準データ モデルのフィールドとプロセス固有のカスタム変数フィールドを組み合わせて使用し、ロボット ログにプロセスのカスタム変数が含まれていない場合、そのプロセスに関連付けられたすべてのフィールドの値は null になります。

このシナリオで null の値を削除する方法は、以下の 2 つです。

• オプション 1: カスタム変数をフィルターとして追加し、条件を [ null ではない ] に設定して、ビジュアリゼーションから null 値を削除します。

  

• オプション 2: カスタム変数を含むプロセス名のフィルターを設定します。ただし、このアプローチを採用すると、2 番目のシナリオが発生する可能性があることに注意してください。

  

シナリオ 2

プロセスによって生成されるすべてのログにカスタム変数が存在しない場合、そのカスタム変数の値を含まないログでは、次の画像に示すように、変数の値が null として表示されます。

この特定のケースの例を以下に示します。

1. [カスタム変数を設定] に移動します。カスタム変数フィールド「Birthday2」は、プロセス「CustomLogs2」で使用されていることが分かります。

   

2. 新規または既存のダッシュボードを開き、タイルを追加します。

3. [CustomLogs2] Explore に移動します。ジョブ ビューの [プロセス名] フィールドとカスタム変数フィールドを選択します。この場合、カスタム変数フィールドは「CustomLogs2.Birthday2」です。

4. [実行] を選択します。 表示される結果は、以下のスクリーンショットのようになります。

   

null 値を削除するには、カスタム変数フィールドをフィルターとして追加します。最後に、ビジュアリゼーションから null 値が削除されるよう、条件を [is not null] に設定します。

注:

上記のケースは 2 つとも、カスタム フィールドの生データを表示している場合に発生します。カスタム変数に関数 (Sum、Average など) を適用すると、null の値は除外されます。

トラブルシューティングと制限事項

トラブルシューティングや制限事項の情報について詳しくは、「トラブルシューティング」をご覧ください。