IM-BPM for Accel Platform IM-BPM チュートリアルガイド 第18版 2021-04-01

4.3.3.2. タスクリスナを利用してタスクの処理依頼メールを送信する

このチュートリアルでは、タスクリスナを利用する方法を解説します。
「タスクリスナ」を設定することで、任意の処理をタスクのイベント発生時に実行できます。
「タスクリスナ」の詳細については、「IM-BPM プロセスデザイナ 操作ガイド」 - 「タスクリスナ」もあわせて参照してください。
タスクリスナを使って処理依頼メールを送信する際に、「IM-LogicDesigner」のロジックフローと「IM-FormaDesigner」で作成したFormaアプリケーションを使用します。
チュートリアルを開始する前に以下の資材をインポートしてください。
  • ロジックフロー
  • Formaアプリケーション
また、タスク処理依頼メールの受信者としてサンプルユーザ「上田辰男」(ユーザコード:ueda)を使用します。
「サイトマップ」→「共通マスタ」→「ユーザ」から「上田辰男」を検索し、以下の設定を行ってください。
  • 「ロール」タブ - 「IM-BPMユーザ」ロールの追加
  • 「プロファイル」タブ - 「メールアドレス」の設定

コラム

このチュートリアルで作成するプロセス定義のサンプルを以下のリンクからダウンロードできます。

このサンプルは「プロセス定義アップロード」機能でプロジェクトにアップロードできます。
アップロード手順は「IM-BPM プロセスデザイナ 操作ガイド」 - 「プロセス定義のアップロード」を参照してください。

コラム

各種設定・詳細については、以下のリンクを参照してください。

コラム

各種インポート方法については、以下のリンクを参照してください。

4.3.3.2.1. プロセス定義を作成する

タスクリスナを利用してタスクの処理依頼メールを送信するプロセスを作成します。
このチュートリアルでは、画面から選択されたタスク処理者に対して、タスク処理画面のURLをメール送信します。
タスク処理者を選択する際に、「IM-FormaDesigner」で作成したアプリケーションを入力フォーム画面として使用します。
../../../../_images/listener_0101.png

図:完成イメージ

  1. 「開始イベント」を配置します。

  2. プロセス全体に対する設定を行います。
    「開始イベント」ではない場所をクリックし、「プロセス」タブの項目を以下のとおりに設定します。
    • プロセス定義キー: listener_send_mail
    • 名前 : タスクの処理依頼メールを送信するプロセス
    • 処理対象グループ : im_bpm_user
    ../../../../_images/listener_0102.png
    図:プロパティ全体 - 「プロパティ」 - 「プロセス」

  3. 「開始イベント」の「メインコンフィグ」タブから、「フォームキー」を設定します。

    • フォームキー : forma:select_usercd
    ../../../../_images/listener_0103.png
    図:「開始ベント」 - 「プロパティ」 - 「メインコンフィグ」

  4. 「ユーザタスク」を配置し、「メインコンフィグ」の「担当者」と「フォームキー」を設定します。

    • 担当者 : ${userCd1}
    • フォームキー : forma:conduct_button
    ../../../../_images/listener_0104.png
    図:「ユーザタスク」 - 「プロパティ」 - 「メインコンフィグ」

  5. 「リスナ」 タブから、「タスクリスナ」 の 「追加」リンクをクリックします。

    ../../../../_images/listener_0105.png
    図: 「ユーザタスク」- 「プロパティ」 - 「リスナ」

  6. 「タスクリスナ」を以下のように設定します。

    • イベント : create
    • タイプ : IM-LogicDesigner
    • フローID : listener_send_mail
    • 最新バージョン : 最新バージョンを利用
    ../../../../_images/listener_0106.png
    図 : 「タスクリスナ」

コラム

本来ロジックフローと変数を連携するには、「IM-LogicDesigner」リスナのプロパティ「入力データ」を設定する必要があります。
今回は、ロジックフローの「入出力設定」で、入力データに対し「暗黙オブジェクト」を設定してあるため、必要ありません。

「暗黙オブジェクト」についての詳細は「IM-BPM 仕様書」-「IM-LogicDesignerリスナ」を参照してください。

4.3.3.2.2. 実行結果を確認する

このチュートリアルで作成した「プロセス定義」を実行環境にデプロイし、実行した結果の確認を行います。

  1. 「プロセス開始一覧」 から、「タスクの処理依頼メールを送信するプロセス」を開始します。

    ../../../../_images/listener_0108.png
    図:「プロセス開始一覧」

  2. 「IM-FormaDesigner」で作成したアプリケーション、「select_usercd」に遷移します。
    虫眼鏡のアイコンをクリックし、検索画面を開いてください。
    ../../../../_images/listener_0110.png
    図:Formaアプリケーション「select_usercd」

  3. 「上田辰男」を選択します。
    「決定」ボタンをクリックすると検索画面が閉じるので、「select_usercd」の「送信」ボタンをクリックします。
    ../../../../_images/listener_0111.png
    図:「ユーザ検索」

  4. 「select_usercd」画面で設定した「上田辰男」に届いたメールを確認します。
    メールに記載されたURLをクリックすると、「IM-FormaDesigner」で作成したFormaアプリケーション「conduct_button」が開きます。
    ../../../../_images/listener_0112.png
    図:処理依頼先の「上田辰男」に届いたメール

    注意

    依頼URLへアクセスした際、既に「青柳辰巳」(ユーザコード:aoyagi)でログインしている場合は実行権限がないためエラー画面へ遷移します。
    ログイン画面に戻り、作業依頼先の「上田辰男」でログインして、再度依頼URLへアクセスしてください。
  5. 「完了」ボタンをクリックすることにより、タスクが完了します。

    ../../../../_images/listener_0114.png
    図:Formaアプリケーション「conduct_button」