カスタム変数

Insights では、Insights データモデルで利用可能な定義済みフィールドから常にデータを取り込みます。しかし、管理者はロボットログやキューから抽出されるカスタム変数を設定することで、特定の KPI を計算したり、より専門的なダッシュボードを構築したりできます。

ヒント:

プロセスのカスタム変数を含めるには、まずその変数が Studio の UiPath.System.Activities.AddLogFields アクティビティを介してオートメーションのログに追加されていることを確認してください。その後、それらの変数を取り込むよう選択する必要があります。
キューのカスタム変数を含めるには、まずその変数が Studio の以下のアクティビティを介してワークフローに追加されていることを確認してください。その後、それらの変数を取り込むよう選択する必要があります。
- 固有データには UiPath.System.Activities.AddQueueItem アクティビティを使用します。
- 出力データと分析データには UiPath.System.Activities.SetTransactionStatus アクティビティを使用します。
カスタム変数を無効化すると、その変数を参照している既存のダッシュボードが動作しなくなる可能性があります。

組織範囲のダッシュボードでカスタム変数を使用する

組織範囲のダッシュボードでカスタム変数を使用する場合は、以下の点を考慮してください。

テナントビューの [カスタム変数を設定] ウィンドウから抽出されたカスタム変数のみが、組織範囲のカスタム変数設定セクションに表示されます。テナントから抽出されないカスタム変数は、組織範囲のダッシュボードには表示されません。
テナント範囲のカスタム変数を変更すると、組織範囲のカスタム変数は組織で無効化されます。すべての変更をダッシュボード内に表示させるため、変更後には必ず再度有効化してください。
ROI セクションとカスタム変数セクションは読み取り専用です。

カスタム変数を設定する

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

Insights の任意のページの右上隅にある 3 点リーダーメニューをクリックして開き、[カスタム変数を設定] を選択します。設定ページが開き、抽出できるすべてのカスタムフィールドが一覧表示されます。
設定ページの上部に表示された、プロセスまたはキューのタブをクリックして、どちらのカスタム変数を設定するか決定します。
[抽出] 列で、ダッシュボードの構築に使用するカスタム変数を選択します。
[型] 列でカスタム変数の型を選択します。[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 データベースに保存されているログの数によって異なります。

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

重要: 変数を抽出できるプロセスまたはキューは最大 500 個です。変数はプロセスまたはキューごとに最大 200 個選択できます。

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

既存の設定を編集する

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

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

設定例

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

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

抽出対象として「ProcessCount」変数を選択し、[String] 型を選択します。
「Argument1_Email」変数を有効化して [String] 型を選択し、[保存] をクリックします。
ダッシュボード画面に戻って新しいダッシュボードを作成し、新しいタイルを追加します。
[*プロセス - CustomLogs2] Explore を選択して CustomLogs2 ビューを選択し、設定したカスタム変数をこのプロセスからタイルで使用します。

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

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

シナリオ 1

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

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

オプション 1: カスタム変数をフィルターとして追加し、条件を [is not null] に設定します。こうすることで、ビジュアリゼーションから null の値が削除されます。
オプション 2: カスタム変数を含むプロセス名のフィルターを設定します。ただし、この方法を採用した場合、以下のシナリオ 2 が発生する可能性があります。

シナリオ 2

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

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

[カスタム変数を設定] に移動します。カスタム変数フィールド「Birthday2」は、プロセス「CustomLogs2」で使用されていることが分かります。
新規または既存のダッシュボードを開き、タイルを追加します。
[CustomLogs2] Explore に移動します。ジョブビューの [プロセス名] フィールドとカスタム変数フィールドを選択します。この場合、カスタム変数フィールドは「CustomLogs2.Birthday2」です。
[Run] をクリックします。表示される結果は、以下のスクリーンショットのようになります。