SalesforceのProcessBuilderからApexクラスを呼ぶためのクラス定義とその設定

Salesforceのプロセスビルダーはフロー図を描くようにビジネスフローを定義でき、

あるオブジェクトの作成時や更新時の項目の値などをもとに、他の項目の値を更新したり出来ます。

使いこなすと非常に便利な機能で、ワークフローよりもメンテナンスも楽に設計することも可能なのではないかと思います。

また、オブジェクトの項目設定だけではなく、メールアクションを呼んだり、Apexクラスを呼んだりすることも出来るので、複数のオブジェクトを更新したり、外部のWebサービスを呼んだりなど、もう少し複雑なビジネスロジックを処理したい場合も重宝します。

ただ、最初にオブジェクトの種類を決めて、そのオブジェクトの項目値によって条件分岐等を行うので、複数の種類のオブジェクトが作成・更新されたときに、汎用的にログを書いたりするのは難しいかと思っていましたが、引数の渡し方も結構フレキシブルにできる方法がありましたので、ご紹介しておきます。

ProcessBuilderからApexクラスを呼ぶためのクラスとその設定
- Apexクラスの記述方法
- 上記クラスを呼び出すProcessBuilderの作成

ProcessBuilderからApexクラスを呼ぶためのクラスとその設定

Apexクラスの記述方法

はじめに、呼ばれる側のApexクラスを作成します。

InvocableLoggerというクラスにします。

内容は、デバッグログを吐くだけのクラスですが、ログ出力の部分を変更して、ビジネスロジックを入れれば、様々なことができます。

global class InvocableLogger {
              
        global class LoggingRequest {
         
               @InvocableVariable(required=true)
               public ID objId;
                
               @InvocableVariable
               public String strComment;
        
       }     
        
        
       @InvocableMethod(label='Called Method for Logging')
       global static void createLog(List<LoggingRequest> requests){
        
           for(LoggingRequest requestObj:requests){        
 
               System.debug('requestObj.objId@@:'+requestObj.objId);          
               System.debug('requestObj.strComment@@:'+requestObj.strComment);
               //Do something for business logic
                
           }
              
       }

簡単に解説すると、

「@InvocableMethod」のアノーテーションのついたメソッドを、プロセスビルダーの中から呼ぶことができます。そのときの名称(見え方)は「label=」のところに記述します。

今回の場合は、「Called Method for Logging」ですね。

次のここがミソですが、引数のリストのクラスをグローバルで定義します。

「LoggingRequest」としました。なお、この引数の変数に「@InvocableVariable」アノーテーションをつけることで、引数として、プロセスビルダーの中で指定することができます。

今回は、「objId」と「strComment」を定義しましたが、好きなだけ増やすことも出来ますので、ご自由に。