【JPIERE-0538】WF承認依頼の通知

iDempiereのワークフロー(WF)の標準機能では、メールを送信するWFノードを作成する事でメールを送信する事ができます。しかしながら、WF承認依頼のメールを承認者に送信するために、WFノードを作成するのは少々面倒です。

そこでJPiereでは、メールを送信するWFノードを作成しなくても承認者になった人に承認依頼のメールを送信できるようにしました。

WF承認依頼の通知の機能概要

WFの承認者になったユーザーに、「Eメール」もしくは「通知」を送信する機能です。「Eメール」もしくは「通知」の選択は、ユーザーマスタの「通知タイプ」の設定によります。

◆メール

「メール」を選択した場合、メールを送信できる設定が行われていると、承認者となったユーザーにメールが送信されます。

送信するメールの内容は、メールテンプレートにあらかじめ登録しておきます。メールテンプレートではWFのもととなった伝票(ドキュメント)の値を変数として利用する事もできます。

◆通知

「通知」を選択した場合、ログイン直後に表示される業務状況確認ガジェットで確認できます。

業務状況確認ガジェットの「通知」をクリックすると下記のように表示されます。表示される内容は「メール」を選択した時にメール送信される内容と同じです。リファレンスフィールドにメールの件名が、テキストフィールドにメールの内容が表示されます。

「認知」のチェックボックスをONにすると、次回から表示されなくなります。

◆WF承認者の追加/転送時

【JPIERE-0513】検索ウィンドウでのワークフロー(WF)承認における、WF承認者の追加/転送時にもWF承認依頼の通知は行われます。

WF承認者の追加/転送時に入力したコメントは、「メール」や「通知」の最後尾に追加されます。

WF承認依頼の通知設定

WF承認依頼の通知を送付するためには、ワークフローノード、ユーザーマスタ、クライアントの３つの設定が必要になります。

ワークフローノード

WFの承認ノードの設定において、メールテンプレートフィールドを表示し、設定できるようにしました。WFの承認ノードのおいて、メールテンプレートを設定する事で、WF承認依頼の通知が送信されます。

メールテンプレートの設定は、「通知」の場合も必要になります。メールテンプレートの内容を「通知」しているためです。メールテンプレートを設定しないと、WF承認依頼の通知は送信されませんので、WF承認依頼の通知を送信したくない場合は、メールテンプレートは設定しないようにして下さい。

ユーザーマスタ

WF承認依頼の通知が、「メール」で来るかそれとも「通知」でくるかは、ユーザーマスタの「通知タイプ」の設定によります。

「通知タイプ」を「なし」にした場合、WF承認依頼の通知以外の「メール」や「通知」が届かなくなる場合がありますので注意して下さい。

クライアント

WF承認依頼の通知を「メール」で送信する場合には、クライアントウィンドウで、メールを送信できるようになっている必要があります。

カスタマイズ情報

追加カラム

AD_WF_ActivityテーブルとAD_WF_ActivityApproverテーブルにIsProcessedApprovalRequestJPカラムを追加しました。IsProcessedApprovalRequestJPカラムは、WF承認依頼の通知の送信処理を実施したかどうかを記録するフラグです。実際にWF承認依頼の通知を送信したかどうかにかかわらず、送信処理の実施判定も含めて、送信処理ロジックを通過した時にONになり、2重送信を防ぐ役割があります。

◆AD_WF_ActivityテーブルにIsProcessedApprovalRequestJPカラムを追加

◆AD_WF_ActivityApproverテーブルにIsProcessedApprovalRequestJPカラムを追加

修正クラス

下記のクラスを修正し、WF承認依頼の通知が送信されるようにしています。

◆jpiere.base.plugin.org.adempiere.base.JPiereWFActivityModelValidator

WFの承認者となったユーザーにWF承認依頼の通知が送信されるように修正しました。

関連するカスタマイズ

◆jpiere.base.plugin.org.adempiere.process.WFActivityForward

WF承認の転送処理において、WF承認依頼の通知が送信されるように修正しました。