9.3. ワークフローの処理時に特定のSlackチャンネルに通知する¶

9.3.3.1. 到達処理の業務ロジックを新規作成する¶

1. 「IM-BIS－フロー編集」画面の「業務ロジック」をクリックします。

   

   図：「IM-BIS－フロー編集」

   コラム

   「業務ロジック」が表示されない場合は、「定義の反映」をクリックしてください。

   また、フォームを編集した場合も必ず「定義の反映」を実行してください。

2. 「業務ロジック」画面が表示されます。

3. 「到達処理」の「新規作成」ボタンをクリックし、「業務ロジック登録 - 到達処理」画面を開きます。

   

   図：「基本設定 - 到達処理」

4. 業務ロジック名を入力し、対象ノードを選択します。

   今回は、「終了」以外のノードに到達した際に業務ロジックを実行するようにしたいので、「終了」以外にチェックを入れます。

   

   図：「業務ロジック登録 - 到達処理」

   コラム

   「終了」ノードに到達する際の処理は、この次に作成する案件終了処理で実装します。

   案件終了処理と重複して処理が実行されてしまわないように、「終了」ノードは到達処理の対象外にします。

5. 「登録」ボタンをクリックします。

6. 「ロジックフロー定義編集」画面が表示されます。

9.3.3.2. 定数を追加する¶

1. 「ロジックフロー定義編集」画面上部、ヘッダ内の「定数設定」をクリックします。

   

   図：「ロジックフロー定義編集」

2. 「定数設定」ダイアログが表示されます。「定数を追加」をクリックします。

   

   図：「定数設定」

3. 下記の定数を追加します。

   定数ID	定数値	説明
   channel	（メッセージを送信するSlackチャンネル）	「Accel-Mart QuickからSlackにメッセージを送信する」でアプリを追加したチャンネルのチャンネルID、または、チャンネル名を指定します。
   token	（Bot User OAuth Token）	「Accel-Mart QuickからSlackにメッセージを送信する」で発行した「Bot User OAuth Token」を指定します。
   authUserName	${$input.mailReplaceMap.Auth_User_Nm}	前ノードを処理したユーザの名前を取得するために使用します。
   beforeProcessName	${$input.mailReplaceMap.Before_Proc_Nm}	前ノードの処理名を取得するために使用します。

9.3.3.3. ユーザ定義タスクを作成する¶

1. 画面左側のパレットの「ユーザ定義追加」→「テンプレート定義新規作成」をクリックします。

   

   図：テンプレート定義新規作成

2. ユーザ定義ID、ユーザ定義名を入力します。本チュートリアルでは次のように設定します。

   • ユーザ定義ID：slack_message_template
   • ユーザ定義名：Slack通知メッセージ作成

3. 任意のユーザカテゴリを「検索」から選択、または、「新規作成」します。

4. 入力値に初期設定されている値を全削除し、 data<object> の配下に次の値を追加します。

   • authUserName<string>
   • resultStatusName<string>
   • matterName<string>
   • matterNumber<string>
   • total<integer>

   コラム

   total はワークフローで申請された内容をSlackに送信するメッセージに表示する方法を解説するために使用します。

   このチュートリアルでは、例としてフォームの「合計額」という項目をメッセージに表示します。

   total という項目は連携するワークフローに合わせて適宜変更、または、削除してください。

   

   図：作成するテンプレート定義の入力値

5. 「標準」欄に以下の内容を入力します。初期入力されているテンプレートを上書きしてください。

   <#setting url_escaping_charset="UTF-8">
   ${authUserName}さんが次のワークフロー案件を${resultStatusName}しました。
   案件番号：${matterNumber}
   案件名： ${matterName}
   合計額：${total}円
   

   コラム

   ${XXX} の部分が入力値として渡ってきた値で置換されます。

   テンプレート定義の詳しい説明は「初期サンプルから見るユーザ定義（テンプレート）の詳細」を参照してください。

6. 「登録」ボタンをクリックします。

7. テンプレート定義を作成できました。

9.3.3.4. タスクを配置する¶

図：タスクの配置

• Slack連携 > メッセージ送信
• 「ユーザ定義タスクを作成する」で作成したユーザ定義タスク

コラム

タスクを配置する詳しい操作方法は「エレメントを配置する」を参照してください。

コラム

作成したユーザタスクは、作成する際に選択したユーザカテゴリに追加されています。

また、ユーザ定義タスクを含む各タスクはパレット上部の「パレット内検索」を利用して検索できます。

図：パレット内検索

9.3.3.5. タスクのマッピング設定をする¶

コラム

マッピング設定の詳しい操作方法は「マッピング設定を行う」を参照してください。

1. 作成したテンプレートユーザ定義を用いて、Slackに送信するメッセージ文を作成します。

   ユーザ定義タスク「Slack通知メッセージ作成（slack_message_template1）」のマッピング設定を以下の通り行います。

   Slack通知メッセージ作成（slack_message_template1）

   始点	終点
   （※コラムに記載）	slack_message_template1<object> - data<object> - authUserName<string>
   （※コラムに記載）	slack_message_template1<object> - data<object> - resultStatusName<string>
   入力<object> - matterName<string>	slack_message_template1<object> - data<object> - matterName<string>
   入力<object> - matterNumber<string>	slack_message_template1<object> - data<object> - matterNumber<string>
   business_data_select<object> - formaItemInfo<object> - total<bigdecimal>	slack_message_template1<object> - data<object> - total<integer>

   コラム

   authUserName<string> 、および、 resultStatusName<string> は、入力の mailReplaceMap<map> （メール置換文字情報）から取得します。

   mailReplaceMap には、ワークフロー関連のメール（処理依頼メールなど）に使用される置換文字情報が格納されています。

   • mailReplaceMap の置換文字列と置換内容の詳細は、「IM-Workflow 仕様書 別紙」を参照してください。

   slack_message_template1 の入力値には、それぞれ以下のEL式を解決した値をマッピングします。

   • ${$input.mailReplaceMap.Auth_User_Nm} → authUserName<string>
   • ${$input.mailReplaceMap.Before_Proc_Nm} → resultStatusName<string>

   「定数を追加する」で定数 authUserName ・ beforeProcessName に上記内容を設定しています。

   ただし、そのままマッピングしてもEL式を解決できないため、マッピング関数「 el 」を使用します。

   • EL式の詳細は「EL式」を参照してください。
   • マッピング関数の使い方については「マッピング関数の利用」を参照してください。

   

   図：Slack通知メッセージ作成（slack_message_template1）のマッピング設定

   コラム

   business_data_select<object> は初期状態ではマッピング設定の入力値に設定されていません。

   「様々な入力情報の利用」を参考に、マッピング設定の入力値に追加してください。

   コラム

   total には、ワークフローの申請内容から「合計額」の項目を取得してマッピングします。

   このように、到達処理でワークフローの申請内容を取得するには、初期配置されている「業務データ取得」タスクを利用します。

   「業務データ取得」タスクの詳細は、以下を参照してください。

   • 「到達処理」-「ユーザ定義タスク」

2. 作成したメッセージ文をSlackに送信します。

   「メッセージ送信（im_slackPostMessage1）」のマッピング設定を以下の通り行います。

   メッセージ送信（im_slackPostMessage1）

   始点	終点
   定数<object> - channel<string>	im_slackPostMessage1 - channel<string>
   slack_message_template1<object> - output<string>	im_slackPostMessage1 - text<string>
   定数<object> - token<string>	im_slackPostMessage1 - token<string>

3. 以上で到達処理の業務ロジックの設定は完了です。業務ロジックを保存してください。

   コラム

   この段階で業務ロジックをデバッグ実行することをおすすめします。

   デバッグ機能の使い方は「ロジックフローのデバッグ」を参照してください。

   なお、デバッグ実行の際にもSlackにメッセージが送信されますので、注意してください。

9.3.4.1. 案件終了処理の業務ロジックを新規作成する¶

1. 「業務ロジック」画面を表示します。

2. 「案件終了処理」の「新規作成」ボタンをクリックし、「業務ロジック登録 - 案件終了処理」画面を開きます。

   

   図：「基本設定 - 案件終了処理」

3. 業務ロジック名を入力し、「登録」ボタンをクリックします。

4. 「ロジックフロー定義編集」画面が表示されます。

9.3.4.2. 定数を追加する¶

定数ID	定数値	説明
channel	（メッセージを送信するSlackチャンネル）	「Accel-Mart QuickからSlackにメッセージを送信する」でアプリを追加したチャンネルのチャンネルID、または、チャンネル名を指定します。
token	（Bot User OAuth Token）	「Accel-Mart QuickからSlackにメッセージを送信する」で発行した「Bot User OAuth Token」を指定します。
authUserName	${$input.imwMatterEndProcess.mailReplaceMap.Auth_User_Nm}	前ノードを処理したユーザの名前を取得するために使用します。
lastResult	${$input.imwMatterEndProcess.mailReplaceMap.Last_Result}	最終処理結果を取得するために使用します。

9.3.4.3. ユーザ定義タスクを作成する¶

1. 「ユーザ定義タスクを作成する」の手順を参考に、テンプレート定義を作成します。

   コラム

   「ユーザ定義編集」で「ユーザ定義IDを新しく割り当てて複製する」にチェックを入れると、既存のユーザ定義をコピーしたユーザ定義が作成できます。

2. ユーザ定義ID、ユーザ定義名を入力します。本チュートリアルでは次のように設定します。

   • ユーザ定義ID：slack_message_template_matter_end
   • ユーザ定義名：Slack通知メッセージ作成【案件終了】

3. ユーザカテゴリ・入力値は到達処理で作成したテンプレート定義と同様に設定してください。

4. 「標準」欄に以下の内容を入力します。初期入力されているテンプレートを上書きしてください。

   <#setting url_escaping_charset="UTF-8">
   ${authUserName}さんが次のワークフロー案件を${resultStatusName}したため、案件が終了しました。
   案件番号：${matterNumber}
   案件名： ${matterName}
   合計額：${total}円
   

5. 「登録」ボタンをクリックします。

6. テンプレート定義を作成できました。

9.3.4.4. タスクを配置する¶

9.3.4.5. タスクのマッピング設定をする¶

1. ユーザ定義タスク「Slack通知メッセージ作成【案件終了】（slack_message_template_matter_end1）」のマッピング設定を以下の通り行います。

   Slack通知メッセージ作成（slack_message_template_matter_end1）

   始点	終点
   （※コラムに記載）	slack_message_template_matter_end1<object> - data<object> - authUserName<string>
   （※コラムに記載）	slack_message_template_matter_end1<object> - data<object> - resultStatusName<string>
   入力<object> - imwMatterEndProcess<object> - matterName<string>	slack_message_template_matter_end1<object> - data<object> - matterName<string>
   入力<object> - imwMatterEndProcess<object> - matterNumber<string>	slack_message_template_matter_end1<object> - data<object> - matterNumber<string>
   business_data_select<object> - formaItemInfo<object> - total<bigdecimal>	slack_message_template_matter_end1<object> - data<object> - total<integer>

   コラム

   authUserName<string> 、および、 resultStatusName<string> は、入力の mailReplaceMap<map> （メール置換文字情報）から取得します。

   到達処理と同様に、定数に設定した以下のEL式を解決した値を slack_message_template_matter_end1 の入力値にマッピングします。

   • ${$input.imwMatterEndProcess.mailReplaceMap.Auth_User_Nm} → authUserName<string>
   • ${$input.imwMatterEndProcess.mailReplaceMap.Last_Result} → resultStatusName<string>

   

   図：Slack通知メッセージ作成【案件終了】（slack_message_template_matter_end1）のマッピング設定

2. 「メッセージ送信（im_slackPostMessage1）」のマッピング設定を以下の通り行います。

   メッセージ送信（im_slackPostMessage1）

   始点	終点
   定数<object> - channel<string>	im_slackPostMessage1 - channel<string>
   slack_message_template_matter_end1<object> - output<string>	im_slackPostMessage1 - text<string>
   定数<object> - token<string>	im_slackPostMessage1 - token<string>

3. 以上で案件終了処理の業務ロジックの設定は完了です。業務ロジックを保存してください。

   コラム

   この段階で業務ロジックをデバッグ実行することをおすすめします。

   デバッグ機能の使い方は「ロジックフローのデバッグ」を参照してください。

   なお、デバッグ実行の際にもSlackにメッセージが送信されますので、注意してください。