8.1. チュートリアル¶

8.1.1.1. 本チュートリアルの利用方法について¶

8.1.1.2. 各グラフの詳細¶

8.1.2.1. 追加するテーブルのリレーション¶

図：追加するテーブルとタスク実行ログの関連

コラム

IM-LogicDesignerのタスク実行ログは、2020 Winter(Azalea)以降に利用が可能です。

コラム

タスク実行ログは、運用の環境によっては大量の実行ログが保存されます。

著しくログの量が増えた場合、ダッシュボードの表示速度が低下します。

本番運用前に性能面の検討をして頂き、必要に応じてタスク実行ログの定期的な削除や、ダッシュボード用ログデータの別保管を検討してください。

8.1.2.2. 追加するテーブルの詳細¶

8.1.2.3. データの集計方法¶

図：データの集計方法

コラム

「⑥ロボットワークフローのタスク確認」についてはIM-Workflowの「タスク通知ポートレット」を利用しているため、説明を割愛します。

8.1.3.1. 手順１　テーブルを作成する¶

CREATE TABLE imrpa_optime_task (
  execute_id VARCHAR(100),
  optime DECIMAL(16),
  PRIMARY KEY (execute_id)
);

CREATE TABLE imrpa_monitoring_task (
  execute_id VARCHAR(100),
  category_name VARCHAR(300),
  task_name VARCHAR(300),
  PRIMARY KEY (execute_id)
);

1. 「サイトマップ」→「 テナント管理」→「データベース操作」をクリックします。

   テーブル作成用のSQLをセットし、「実行」をクリックします。
   
   図：「データベース操作」画面
2. 「データベース処理が完了しました。 」のメッセージを確認します。
   
   図：処理完了メッセージ
3. 同様の手順で、もう1つのテーブルを作成します。

8.1.3.2. 手順２　モニタリング対象のロボットを確認する¶

1. 「サイトマップ」→「LogicDesigner」→「フロー定義一覧」をクリックします。

   ダッシュボードでモニタリングしたいロボット呼び出しのあるロジックフローをクリックします。
2. モニタリングしたいロボット呼び出しタスクをクリックします。

   「基本設定」の「タスクID」に記載されている文字列を控えておきます。
   
   図：タスクIDの確認方法
3. 同様の手順で、モニタリングしたいすべてのロボット呼び出しタスクのタスクIDを控えておきます。

コラム

上記タスクIDが、当該タスクの実行時にログとして、 imld_log テーブルの execute_id 項目に保存されます。

execute_id は本チュートリアルで追加するテーブルの主キーです。

8.1.3.3. 手順３　マスタ設定をする¶

1. 「サイトマップ」→「 TableMaintenance」→「テーブル一覧」をクリックします。

   imrpa で検索を行い、今回作成したテーブルに絞り込みます。

   imrpa_monitoring_task をクリックします。
   
   図：「テーブル一覧」画面
2. imrpa_monitoring_task の内容を設定します。

   日々状態を監視したいロボットタスクを登録してください。

   execute_id には、先ほど確認したモニタリング対象となるロボット呼び出しのタスクIDを設定します。

   category_name に業務名を、 task_name にロボットタスク名を記載します。
   
   図： imrpa_monitoring_task テーブルの設定例
3. imrpa_optime_task の内容を設定します。

   ロボットの導入効果を測定したいタスクを登録してください。

   execute_id には、先ほど確認したモニタリング対象となるロボット呼び出しのタスクIDを設定します。

   optime には、対象の業務にロボットを導入する前に掛かっていた処理時間を秒単位で設定してください。
   
   図： imrpa_optime_task テーブルの設定例

コラム

imrpa_monitoring_task と imrpa_optime_task に記載する execute_id は異なっても構いません。

モニタリングしたいロボットと、ROIを計測したいロボットは分けることが可能です。

8.1.3.4. 手順４　テーブルビューを作成する¶

1. 各テーブルビューを作成するスクリプトのサンプルコードについては、下記リンクより参照してください。

   imld_log_optime ビュー

   imld_log_optime_accum ビュー

   imld_log_monitoring_task ビュー

   imld_log_op_cnt ビュー

   imld_log_mon_err ビュー

   
   

   必要なビューの分だけ、スクリプトを実行してください。

   
   
   
   図：「データベース操作」画面

コラム

imld_log_optime 、および、 imld_log_op_cnt のサンプルコード内には execute_id として以下の3つを記述しています。

• bizrobo0021
• im_winactorCallAgent1
• uipath0012

必要に応じて、これらの execute_id をモニタリング対象のタスクIDに差し替えてご利用ください。

対象のタスクを増減する場合は、これらの execute_id を含む該当ブロックごと、記述の追加・削除をしてください。

コラム

サンプルコードに含まれるSQLはPostgreSQL用です。テナントDBに他のDBMSを利用している場合は、適宜記述内容の変更をしてください。

8.1.3.5. 手順５　ViewCreatorのクエリを作成する¶

1. 「サイトマップ」→「ViewCreator」→「クエリ一覧」 →「新規」をクリックします。

   imld_log_op_cnt を選択します。

   表示された imld_log_op_cnt のカラムを全てダブルクリックして、「カラム一覧」に表示させます。
   
   図：「クエリ編集」画面 - カラム一覧
2. 「抽出条件一覧」を選択します。

   カラム「 bday 」をダブルクリックし、抽出方法を「直接入力」、条件値を <%SYSTEM_DATE(yyyy/MM/dd)%> と設定します。
   
   図：「クエリ編集」画面 - 抽出条件一覧
3. 「保存」をクリックします。

   クエリ名に「RPA本日のロボット実行回数」と設定します。

   クエリコードは任意で設定してください。
   
   図：「クエリ編集」画面 - 保存
4. 以上の手順を必要なクエリの分だけ、実施します。

クエリ名	参照ビュー/テーブル	カラム一覧	抽出条件一覧	備考
RPAロボットによる削減時間	imld_log_optime_accum	全て Bdayのソートを昇順にします	なし
RPAモニタリングロボット一覧	mld_log_monitoring_task	全て category_nameのソートを昇順にします	なし
RPA本日のロボット実行回数	imld_log_op_cnt	全て	<%SYSTEM_DATE(yyyy/MM/dd)%>
RPAエラー率集計	SQLを記載	event_type、cnt	なし	SQLで編集で直接スクリプトを記載します。（後述）
RPAロボット実行エラー	imld_log_mon_err	全て	なし
RPAロボット実行回数	imld_log_op_cnt	全て	なし

コラム

「RPAエラー率集計」のクエリでは、ビューを選択せず、直接SQLを設定してください。

直接SQLを設定するには、「クエリ編集」画面で「SQLで編集」ボタンをクリックしてください。

図：「クエリ編集」画面 - SQLで編集

SQLのサンプルコードは以下の通りです。

SELECT
      case when l.event_type = 'END_TASK' then '正常' else 'エラー' end as event_type,
count(l.execution_no) as cnt

  FROM
      imld_log l,
      imrpa_monitoring_task mon

  WHERE
        l.execute_id = mon.execute_id
      AND l.event_type IN ('ERROR_TASK','END_TASK')
      AND l.task_type  in  ('uipath','bizrobo','im_winactorCallAgent')
      AND l.execution_time > now() + '-5 day'
group by l.event_type

8.1.3.6. 手順６　ViewCreatorのデータ参照を作成する¶

1. 「サイトマップ」→「ViewCreator」→「クエリ一覧」 をクリックします。

   クエリ名「RPA本日のロボット実行回数」の左にある「グラフ」アイコンをクリックします。
   
   図：「クエリ一覧」画面
2. 「データ参照・編集 グラフ集計」画面の「カラム設定」カテゴリを設定します。

   taskX と etaskX を同じグループに設定します。

   グラフタイプは全て棒グラフとします。

   カラーは任意ですが、エラー表示となる etask を警告色とすると視認性が高まります。
   
   図：「データ参照・編集 グラフ集計」画面 - カラム設定
3. 「権限設定」カテゴリを設定します。

   認証済みユーザを選択します。

   ゲストユーザにも参照可能なグラフとしたい場合、ゲストユーザも選択します。
   
   図：「データ参照・編集 グラフ集計」画面 - 権限設定
4. 「プレビュー」をクリックします。

   設定したグラフが表示されることを確認してください。
   
   図：「データ参照・編集 グラフ集計」画面 - プレビュー
5. その他「データ参照設定」「グラフ設定」「ページ設定」各カテゴリについては、任意で設定し、「更新して一覧へ戻る」をクリックします。
6. 以上の手順を必要なクエリの数分実施をします。

クエリ名/データ参照名	集計パターン	グラフ描画形式	カラム設定
RPAロボットによる削減時間	グラフ	HighCharts	下記「RPAロボットによる削減時間カラム設定」参照
RPAモニタリングロボット一覧	リスト	-	下記「RPAモニタリングロボット一覧カラム設定」参照
RPA本日のロボット実行回数	グラフ	HighCharts	上記参照
RPAエラー率集計	グラフ	HighCharts	下記「RPAエラー率集計カラム設定」参照
RPAロボット実行エラー	リスト	-	下記「RPAロボット実行エラーカラム設定」参照
RPAロボット実行回数	グラフ	HighCharts	下記「RPAロボット実行回数カラム設定」参照

コラム

「RPAロボットによる削減時間」カラム設定

図：「RPAロボットによる削減時間」カラム設定

カラムの国際化項目の編集

図：「RPAロボットによる削減時間カラム設定」 - カラムの国際化項目の編集

コラム

「RPAモニタリングロボット一覧」カラム設定

図：「RPAモニタリングロボット一覧」カラム設定

rtype カラムの表示設定

図：「RPAモニタリングロボット一覧」カラム設定 - 表示設定 - rtype

category_name カラムの表示設定

図：「RPAモニタリングロボット一覧」カラム設定 - 表示設定 - category_name

task_name カラムの表示設定

図：「RPAモニタリングロボット一覧」カラム設定 - 表示設定 - task_name

statusカラム の表示設定

図：「RPAモニタリングロボット一覧」カラム設定 - 表示設定 - status

コラム

「RPAエラー率集計」カラム設定

図：「RPAエラー率集計」カラム設定

コラム

「RPAロボット実行エラー」カラム設定

図：「RPAロボット実行エラー」カラム設定

コラム

「RPAロボット実行回数」カラム設定

図：「RPAロボット実行回数」カラム設定

8.1.3.7. 手順７　グラフおよび一覧をポートレット登録する¶

1. 「サイトマップ」→「ViewCreator」→「データ参照一覧」 をクリックします。

   作成したグラフにチェックをつけ、「ポートレット登録」をクリックします。
   
   図：「データ参照一覧」画面 - ポートレット登録
2. 「登録に成功しました。」というメッセージを確認します。
   
   図：ポートレット登録成功メッセージ

8.1.3.8. 手順８　ポートレットの権限設定¶

1. 「サイトマップ」→「 テナント管理」→「認可」をクリックします。

   「リソースの種類」で「ポートレット設定」を選択します。

   「権限設定を開始する」ボタンをクリックし、インジケーターがオンの状態にします。

   先ほど登録したポートレットに対して、「認証済みユーザ」の権限にチェックをつけ、設定を完了します。
   
   図：「認可設定」画面

8.1.3.9. 手順９　ポートレット配置¶

1. ポータルを表示します。

   ポータルタブの左にある「＋」ボタンをクリックします。
   
   図：「ポータル」画面
2. 「ポータルコード」、「名称」に任意のIDと名前を設定します。

   「レイアウト」を任意に設定します。

   「登録」ボタンをクリックします。
   
   図：「ポータル新規登録」画面
3. 登録されたポータルタブの右にある「▼」をクリックします。

   「ポートレットの追加」をクリックします。
   
   図：ポートレットのタブ
4. 「アプリケーション」で「ViewCreator」を選択します。

   配置したいポートレットを選択します。

   「追加」ボタンをクリックします。
   
   図：ポートレットの追加
5. ポートレットが配置されたことを確認します。

   配置したポートレットは、タイトル部分をドラッグ&ドロップすることで、任意の場所に配置可能です。

   画面の解像度などを考慮し、見やすいレイアウトに再配置してください。
   
   図：ポートレットの配置

コラム

紹介した手順はユーザごとのポートレットを設定する「ユーザポータル」の設定例です。

intra-mart Accel Platformでは、グループで共通したポートレットを表示する「グループポータル」も利用可能です。

利用方法は下記を参照してください。

「ポータル 管理者操作ガイド」 - 「グループポータルを管理する」