よく設定する内容ではありますが、毎回忘れて調べながらやることが多いので、一通りの手順を纏めておきます。

尚、リストビューで選択したレコードに対して、一括でレコードIDを画面フローに引き渡す方法は、現時点では、少しだけコーディングが必要となります。以下の記事で詳細を記載していますので、参考までに。

参考

【Tips!】リストビューで選択したレコードを引数にして画面フロー(Flow)を実行する方法

本日のTips!は、リストビューで選択したレコードを引数にしてフローを実行する方…

続きを読む

1.画面フローの設定手順

画面フローにレコードIDをパラメータとして引き渡す手順は以下のようになります。

今回は、サンプルとして取引先（Account）を利用します。

取引先の詳細画面に画面フローを起動するアクション（ボタン）を追加して実行する流れとなります。

では早速作成してみたいと思います。

画面フローの作成

手順①システム管理者にて、Salesforce組織にログインします。

ログイン後、[設定]->[フロー]の順に実行し、フローの画面を表示します。

手順②新規フローボタンをクリックして、画面フローの作成を選択します。

手順③画面フローの作成画面では、最初に[新規リソース]ボタンをクリックして、レコードIDを保存する入力パラメータを定義します。

手順④レコードIDを受け取るための入力変数を定義します。

リソース種別：変数

API参照名：recordId

※API参照名が非常に重要です。　最初のrecordはすべて小文字で、IdのIだけ大文字で定義してください。ここを間違えるとIDが画面に表示されます。

ただしフロー内部で取得したレコードIDを使って処理するところはエラーがでないので、間違えに気づきにくいため注意が必要です。

データ型は、テキストとして、デフォルト値は不要

最後に「入力で使用可能」にチェックをして完了ボタンをクリックします。

手順⑤続いて、レコードIDを使って、取引先のレコードを取得してみましょう。

画面フローに「レコードを取得」の要素を追加します。

手順⑥新規のレコードの取得画面で、以下の内容を登録します。

表示ラベル、API参照名：ご自由に定義してください。

オブジェクト：取引先

絞り込み条件：IDが入力パラメータのrecordIdと一致するを指定してください。

設定したら完了ボタンをクリックします。

手順⑦続いて、取得した取引先の情報を表示する画面を定義します。

画面の要素を追加してください。

手順⑧最初に画面のプロパティを設定します。

手順⑨続いて、表示テキストコンポーネントを追加します。

リソースの挿入は、レコード（単一）変数から、さきほど定義した取引先レコードを指定します。

以下の例では、取引先IDと取引先名を指定しています。ご自由にお好きな項目を指定してください。

手順⑩画面を追加したらフローの保存ボタンをクリックします。以下の画面が表示されるため、名称を指定して保存します。

手順⑪保存後フローを有効化します。「有効化」ボタンをクリック

手順⑫次にオブジェクトマネージャから取引先オブジェクトを選択して、フローのアクションを定義していきます。

取引先オブジェクト画面にて、ボタン、リンク、およびアクションのメニューを開いて、「新規アクション」をクリックします。

手順⑬新規アクション画面で、アクション種別でフローを選択し、フローには、先ほど作成したフローを指定します。

表示ラベル、名前、説明欄を入力後、[保存]します。

保存後画面

手順⑭取引先オブジェクト画面のページレイアウトを開きます。画面フローを実行したいページレイアウトを編集します。

手順⑮ページレイアウト編集画面にて、モバイルおよびLightningのアクションメニューから先ほど作成したフローアクションを選択して、Drag&Dropでレイアウトに配置します。編集後保存しておきます。

手順⑯取引先の参照画面を開きます。すると作成したフローアクションのボタンが表示されているので、実行します。

手順⑰以下の画面フローが表示され、取引先のレコードIDや名称が表示されることを確認できます。

【補足】デバッグ実行

画面フローの編集画面でデバッグ実行をしても動作の確認ができます。

手順①フローの画面で、保存、有効化したあと、デバッグボタンを実行します。

手順②フローをデバッグの画面で、入力パラメータに取引先のレコードIDを指定して実行します。

手順③デバッグ実行結果が表示されます。

画面上に正しくIDと名称が表示されていることを確認できます。また途中経過の変数の値も確認することができます。

まとめ

画面フローにレコードIDを渡す場合に一番間違えやすいのは、「recordId」のスペルと大文字小文字の違いとなりますので、注意してください。

今回ご紹介した画面フローにレコードIDを渡すやり方は、実際のプロジェクトでも頻繁に利用することになると思いますので、ぜひ使いこなせるようになってください。

よくある要件としては、活動や行動、TODOの登録を画面フローを使って行う方法となります。取引先IDを使って関連付けをして活動やTODOを登録する場合には、画面フローは非常に使い勝手がよいです。是非おためしください。

それでは。

サポーターさん

ブログランキングに参加しましたので、ご支援していただけると幸いです。

にほんブログ村

なるべく標準機能を利用して、リスビューで選択したレコードに対して一括で処理したいという要件は多々あるかと思います。

昔はよくボタンとJavascriptを組み合わせて実現していましたが、今はフロー（Flow）が非常に使いやすく高機能になってきたため、カスタムボタン＋Flowで実現することをお勧めしています。

ただし、今回ご紹介する方法は、完全に標準というわけではなく、一部Visualforceを利用します。

※セールスフォースのヘルプでも紹介されているやり方となります。

1.リストビューで選択した取引先責任者を画面フロー(Flow)に表示してみよう

今回は、サンプルとして取引先責任者（Contact）を利用します。

取引先責任者は、リストビューで選択した取引先責任者に対してリストメール送信（一括で複数の取引先責任者へメールを送信）の機能が用意されていますが、そのほかの用途として、例えば、標準のアンケート（Survey）を顧客担当者へ一括で送信したいという場合に、今回ご紹介する機能を使えば実現することができます。

アンケートを複数の取引先に一度に送信する方法は別の記事でご紹介します。

サポーターさん

記事を書いたときにはありませんでしたが、アンケートは一括で送信する機能が実装されましたね

では、一つ一つ手順の内容を解説していきたいと思います。

1.フロービルダー(Flow Builder)を新規作成

管理人

まずはシステム管理者でSalesforceへログインして、フロー作成画面を開きましょう

1.Salesforceにログインして、設定から[フロー]を検索して、フロー画面から、[新規フロー]ボタンをクリックします。

画像をクリックすると拡大できます。

2.続いて、画面フローを選択して、[次へ]ボタンをクリックします。

※リストビューで選択されたレコードを使って、フローの画面上で選択されたレコードを別の値に更新する処理を行います。

3.フロービルダー(Flow Builder)では、まずリストビューで選択された取引先責任者のレコードをフロー画面のパラメータとして受け取るための変数を定義します。[新規リソース]ボタンをクリックします。

4.新規リソース画面で、以下の内容を登録して、[完了]ボタンをクリックします。

※今回はVisualforceからFlowに取引先責任者のレコードセットを入力パラメータとして引き渡すため、フロー外部での可用性の入力で使用可能にチェックしています。

5.次に画面を作成します。要素を追加から、画面を選択します。

6.画面を編集にて、以下の内容を設定します。

7.最終的に以下のような構成となります。

8.最後に保存ボタンをクリックして、名前を付けて保存して、有効化します。

2.フローを実行するVisualforceの作成

次にリストビューで選択した値をフローに引渡すVisualforceページを作成します。

1.Visualforceページから[新規]ボタンをクリックします。

2.Visualforceページにて、以下の内容を登録します。

管理人

Visualforceの説明をより詳しく知りたい方は、セールスフォース社の以下のページを参照ください

3.Visualforceを実行するカスタムボタンを作成

作成したVisualforceページを実行するカスタムボタンを作成します。

1.オブジェクトマネージャから取引先責任者を検索し、[ボタン、リンク、およびアクション]のメニューから「新規ボタンまたはリンク」ボタンをクリックします。

2.続いて、ボタンの内容を以下の通り設定します。

※Visualforceの標準コントローラ（StandardController）で取引先責任者（Contact）が設定されていないとコンテンツでは作成したVisualforceページが選択できないため、表示されていない場合はもう一度Visualforceが正しく作成されているか確認しましょう。

4.カスタムボタンを取引先責任者へ表示する

1.Salesforce Classicの検索レイアウトで、リストビューの▼ボタンから編集を実行します。

取引先責任者をリストビューでは、先ほど作成したカスタムボタンが利用可能となっているので、選択して保存します。

※標準ボタンが多いと表示されなくなるので、不要なチェックはすべて外しておきましょう。

正しく設定されると以下のようにボタンが表示されます。

5.処理を実行して、設定内容を検証する

1.取引先責任者のリストビューから複数の取引先責任者を選択して、[画面フロー起動]ボタンをクリックします。

2.選択された取引先責任者のレコードはVisualforceページ経由で画面フローへ引き渡され、画面フローのテキストで表示されることが確認できます。

以上で設定から検証まで完了となります。

（2023/02/17 Update）

サポーターさん

最新のフローでは以下のApexが不要で、上記フローで取得したレコード変数を直接利用して繰り返し処理など行うことができるようになっているようです。

取得したIDの一覧はこのままの状態では、フローの中で繰り返し処理を行ったりすることができません。

Apexコードに上記取得したIDの文字列を渡して、String型のリストに変換することで、繰り返し処理などを行うことができます。

Apexコードのサンプルは以下となります。

サンプルコード

/**--------------------------------------------------------------------------
プログラム名 CCLT_MultiSelectFlowIds
* 概　要 ：セミコロン区切りのID文字列をフロー対応のリスト型にして返却する
* 作成日 ：2023.02.17
* 作成者 ：クリエイティブコンテンツラボトウキョウ
*--------------------------------------------------------------------------**/
public with sharing class CCLT_MultiSelectFlowIds {

@InvocableMethod(label='FlowのIDリストを指定' description='セミコロン区切りのID文字列をフロー対応のリスト型にして返却する')
public static List<List<String>> getIdList(List<String> ids) {

if(!(ids.isEmpty())){
string tempStr = ids[0];
List<String> lstnew = tempStr.split(';');
list<list<string>> finalLst = new list<list<string>>();
finalLst.add(lstnew);
return finalLst;
//IDリストが指定されていない場合NULLを返却
} else {
return null;
}
}
}

※こちらはテストクラスのサンプルです。

/**--------------------------------------------------------------------------
* プログラム名:CCLT_MultiSelectFlowIdsTest
* 概　要 CCLT_MultiSelectFlowIdsテストクラス
* 作成日 ：2023.02.18
* 作成者 ：クリエイティブコンテンツラボトウキョウ
* --------------------------------------------------------------------------**/
@isTest(SeeAllData=false)
public with sharing class CCLT_MultiSelectFlowIdsTest {
@isTest
public static void getIdList_case1() {
// 取引先を作成
Account acc1 = new Account(name='cclt');
insert acc1;
// 募集人を2名作成
List<Contact> conList = new List<Contact>();
conList.add(new Contact(FirstName='creative', Lastname='content',AccountId=acc1.id));
conList.add(new Contact(FirstName='lab', Lastname='tokyo',AccountId=acc1.id));
insert conList;
//String型のリストを生成
List<String> ids = New List<String>();
//取引先のIDをセミコロンで結合した文字列をStringリストに格納
ids.add(conList[0].id + ';' +conList[0].id);
//テスト開始
Test.startTest();
//セミコロンで結合したIDをIDのリスト型で返却するメソッドを実行
List<List<String>> listd = CCLT_MultiSelectFlowIds.getIdList(ids);
//リストのレコードが2件返却されればOK
system.assertEquals(2,listd[0].size());
//テスト終了
Test.stopTest();
}
/**
*　メソッドに空文字列を渡した場合にNULLが返却されることを確認
*/
@isTest
public static void getIdList_case2() {
//文字列のリストを生成　※値は設定しない
List<String> ids = New List<String>();
//テスト開始
Test.startTest();
List<List<String>> listd = CCLT_MultiSelectFlowIds.getIdList(ids);
//NULLが返却されればOK
system.assertEquals(null,listd);
//テスト終了
Test.stopTest();
}
}

まとめ

いかがでしたでしょうか。説明した手順で設定はうまくいきましたか。

今回は、画面フローで取引先責任者のIDを表示する方法をご紹介しましたが、実際に利用する場合は、このあと取得したレコード分繰り返し処理を行いい、更新用のレコード変数を作成したり、リストが未選択の場合のエラー処理や画面表示を追加するなど具体的なロジックを入れることになります。

それでは、また。

お客様の業務を自動化する場合に、会社の営業日だけ処理を実行したいというご要望がよくありますが、この方法を使えば簡単に実現することができますので、是非マスターしてください。

例えば、毎朝9時に商談の期日が切れているタスクがあるかチェックして、存在する場合には担当者へメール通知するなどの用途があります。

1.フロービルダーを使って営業日を判定してみよう

今回は、スケジュールトリガーフローを使って、営業日判定処理を作成してみます。もちろんスケジュールトリガー以外のフローでも構いません。

では、一つ一つ手順の内容を解説していきたいと思います。

1.組織の休日・国民の祝日を設定

管理人

まずは会社の設定の休日に祝日を定義しましょう

1.Salesforceにログインして、[設定] からクイック検索で[休日]を検索して実行します。休日設定画面から、[新規]ボタンをクリックして休日登録画面を表示します。

画像をクリックすると拡大できます。

2.休日の詳細画面で、国民の祝日や会社の休日を設定します。

例：休日名：元旦　説明：1月1日を元旦として設定　日付に今年の1月1日をセット　時間は今回は利用しません。

毎年同じ周期の祝日の場合は、繰り返しをチェックして、頻度と繰り返しの開始、終了（任意）時期をセットします。

組織(会社の設定）の休日設定は以上となります。

※会社独自の休日や毎年変わる祝日などは必要な時期にメンテナンスを忘れないように注意が必要です。

2.フロービルダーを使って週末判定処理を作成

続いて、フロービルダーを使って、週末の判定処理を作成しますが、こちらについては、以下の記事で紹介しておりますので、今回は省略します。

参考

【Tips!】フロー(Flow)で週末（土日）を判定し平日だけ処理を実行する方法

本日のTips!は、標準のフローだけを使って、開発なし（ノンコーティング）で休日…

続きを読む

以下のフローの部分までは同じ処理となるため、上記記事を参考に作成してから次へお進みください。

サポーターさん

変数の定義もこの後の流れで利用するので忘れずに設定してください

3.フロービルダーで祝日判定処理を作成

週末（土日）判定処理では、週末（土日）の場合に営業日フラグをFalseとしましたが、平日の場合は営業日フラグはデフォルトのTrueのままとなっています。

この後は、平日の場合に組織で定義された休祝日にあたるかどうかを判定する処理を作成していきます。

1.休祝日判定ロジックの追加

平日のプロセスで、レコードの取得処理を追加し以下の内容を定義します。

オブジェクト：休日

条件の要件：なしーすべての休日レコードを取得

並べ替え：なし

保存するレコード数：すべてのレコード

レコードデータの保存方法：すべての項目を自動的に保存　（または項目を選択してあとはsalesforceに任せる）

※取得データが大量になる場合や項目数が多い場合などは、項目を選択してレコード型の変数に割り当てるほうがリソースや性能面からはお勧めします。

今回はテストのため、簡単に設定できる（すべての項目を自動的に保存または項目を選択してあとはsalesforceに任せる）を選択しています。

2.休祝日レコード数分の繰り返し処理を定義

1.で休祝日を取得した後に取得したレコード数分繰り返し処理を定義します。

コレクション変数を選択で、1.で定義したコレクションを選択します。

3.休祝日の条件分岐を作成

取得した休祝日レコードの繰り返し処理の中で、以下の条件分岐を定義します。

結果１：祝日　表示ラベル：祝日　API名は自由に定義してください。

結果を実行する条件の要件：すべての条件に一致（AND）

条件：リソース：現在の日付（フローのCurrentDate）　演算子：次の文字列と一致する

値：ループの現在の項目＞休日　　※{!LoopHolidayRecords.ActivityDate}

繰り返し処理の現在の休祝日がフローの実行日と一致する場合は、祝日と判断する

結果2はラベル名だけ営業日としておき、ロジックは不要です。

4.繰り返し処理で休祝日判定された場合に、営業日フラグをFalseに更新する

休祝日判定された場合の後続処理に以下の割り当てを追加し、営業日フラグにFalseをセットします。

変数：BusinessDayFlag（営業日フラグ）

演算子：次の文字列と一致する

値：グローバル変数False

最後に、最初に作成した週末判定処理の条件分岐で週末（土日）のロジックの後続処理を上記の休祝日繰り返し処理の終了プロセスの終了処理とマージします。

以下のようにプロセスを繋げます。

最後のアクションでは営業日判定結果を表示するメモを追加しています。※デバッグ実行で処理結果の詳細を確認するため。

3.デバッグ実行

1.フローを保存したあと、デバッグボタンをクリックします。

フローをデバッグの画面が表示されます。今回作成したフローは特に処理を入れていないためロールバックの必要はありませんが、

データを作成したりするような処理がある場合は、ロールバックオードを利用して既存データに影響しないように実行することもできます。

2.実行結果の確認

デバッグ実行すると処理結果の詳細を確認することができます。上記ではご説明していませんが、以下の図の最後に表示されているような変数の値などを表示するメモを追加するとデバッグしやすくなりますので、ぜひお試しください。

※処理の最後にメモなどのアクションを定義するだけです。

4.フローの有効化とスケジュール設定

1.デバッグ実行で問題がなければ、上記で作成したフローを保存した後、有効化ボタンをクリックしてください。

2.フローを有効化すると、スケジュール済みジョブに実行計画が登録されます。

※スケジュールを変更したい場合は、フローのスケジュールを変更して保存後、有効化することで新しいスケジュールに変更することができます。

サンプルフロー（メタデータ）

本記事でご紹介したフローのメタデータを公開します。

<?xml version="1.0" encoding="UTF-8"?>
<Flow xmlns="http://soap.sforce.com/2006/04/metadata">
    <actionCalls>
        <name>DebugMemo</name>
        <label>営業日判定結果</label>
        <locationX>358</locationX>
        <locationY>1164</locationY>
        <actionName>NewNote</actionName>
        <actionType>quickAction</actionType>
        <inputParameters>
            <name>Title</name>
            <value>
                <stringValue>営業日判定</stringValue>
            </value>
        </inputParameters>
        <inputParameters>
            <name>Body</name>
            <value>
                <stringValue>日付：{!$Flow.CurrentDate}　曜日判定：{!DayOfTheWeekDecimal}　営業日判定：{!BusinessDayFlag}</stringValue>
            </value>
        </inputParameters>
    </actionCalls>
    <apiVersion>50.0</apiVersion>
    <assignments>
        <name>SetBusinessDayFlagFalse</name>
        <label>営業日フラグにFalseをセット</label>
        <locationX>50</locationX>
        <locationY>396</locationY>
        <assignmentItems>
            <assignToReference>BusinessDayFlag</assignToReference>
            <operator>Assign</operator>
            <value>
                <booleanValue>false</booleanValue>
            </value>
        </assignmentItems>
        <connector>
            <targetReference>DebugMemo</targetReference>
        </connector>
    </assignments>
    <assignments>
        <name>SetBusinessDayFlagFalse_0</name>
        <label>営業日フラグにFalseをセット</label>
        <locationX>754</locationX>
        <locationY>756</locationY>
        <assignmentItems>
            <assignToReference>BusinessDayFlag</assignToReference>
            <operator>Assign</operator>
            <value>
                <booleanValue>false</booleanValue>
            </value>
        </assignmentItems>
        <connector>
            <targetReference>LoopHolidayRecords</targetReference>
        </connector>
    </assignments>
    <decisions>
        <description>祝日判定処理</description>
        <name>ConditionJudgementHolidays</name>
        <label>祝日判定処理</label>
        <locationX>886</locationX>
        <locationY>636</locationY>
        <defaultConnector>
            <targetReference>LoopHolidayRecords</targetReference>
        </defaultConnector>
        <defaultConnectorLabel>営業日</defaultConnectorLabel>
        <rules>
            <name>IsHoliday</name>
            <conditionLogic>and</conditionLogic>
            <conditions>
                <leftValueReference>$Flow.CurrentDate</leftValueReference>
                <operator>EqualTo</operator>
                <rightValue>
                    <elementReference>LoopHolidayRecords.ActivityDate</elementReference>
                </rightValue>
            </conditions>
            <connector>
                <targetReference>SetBusinessDayFlagFalse_0</targetReference>
            </connector>
            <label>祝日</label>
        </rules>
    </decisions>
    <decisions>
        <description>週末(土日)判定処理
0:日曜日、6:土曜日</description>
        <name>ConditionJudgementIsWeekend</name>
        <label>週末(土日)判定処理</label>
        <locationX>358</locationX>
        <locationY>276</locationY>
        <defaultConnector>
            <targetReference>GetOrgHolidayRecords</targetReference>
        </defaultConnector>
        <defaultConnectorLabel>平日</defaultConnectorLabel>
        <rules>
            <name>IsWeekend</name>
            <conditionLogic>or</conditionLogic>
            <conditions>
                <leftValueReference>DayOfTheWeekDecimal</leftValueReference>
                <operator>NotEqualTo</operator>
                <rightValue>
                    <numberValue>0.0</numberValue>
                </rightValue>
            </conditions>
            <conditions>
                <leftValueReference>DayOfTheWeekDecimal</leftValueReference>
                <operator>NotEqualTo</operator>
                <rightValue>
                    <numberValue>6.0</numberValue>
                </rightValue>
            </conditions>
            <connector>
                <targetReference>SetBusinessDayFlagFalse</targetReference>
            </connector>
            <label>週末（土日）</label>
        </rules>
    </decisions>
    <formulas>
        <description>曜日判定のための変数</description>
        <name>DayOfTheWeekDecimal</name>
        <dataType>Number</dataType>
        <expression>MOD( {!$Flow.CurrentDate} - DATE(1900, 1, 7), 7)</expression>
        <scale>0</scale>
    </formulas>
    <interviewLabel>営業日判定フロー {!$Flow.CurrentDateTime}</interviewLabel>
    <label>営業日判定フロー</label>
    <loops>
        <name>LoopHolidayRecords</name>
        <label>祝日分繰り返し処理 (LoopHolidayRecords)</label>
        <locationX>666</locationX>
        <locationY>516</locationY>
        <collectionReference>GetOrgHolidayRecords</collectionReference>
        <iterationOrder>Asc</iterationOrder>
        <nextValueConnector>
            <targetReference>ConditionJudgementHolidays</targetReference>
        </nextValueConnector>
        <noMoreValuesConnector>
            <targetReference>DebugMemo</targetReference>
        </noMoreValuesConnector>
    </loops>
    <processMetadataValues>
        <name>BuilderType</name>
        <value>
            <stringValue>LightningFlowBuilder</stringValue>
        </value>
    </processMetadataValues>
    <processMetadataValues>
        <name>CanvasMode</name>
        <value>
            <stringValue>AUTO_LAYOUT_CANVAS</stringValue>
        </value>
    </processMetadataValues>
    <processMetadataValues>
        <name>OriginBuilderType</name>
        <value>
            <stringValue>LightningFlowBuilder</stringValue>
        </value>
    </processMetadataValues>
    <processType>AutoLaunchedFlow</processType>
    <recordLookups>
        <name>GetOrgHolidayRecords</name>
        <label>組織の休日レコード取得</label>
        <locationX>666</locationX>
        <locationY>396</locationY>
        <assignNullValuesIfNoRecordsFound>false</assignNullValuesIfNoRecordsFound>
        <connector>
            <targetReference>LoopHolidayRecords</targetReference>
        </connector>
        <getFirstRecordOnly>false</getFirstRecordOnly>
        <object>Holiday</object>
        <storeOutputAutomatically>true</storeOutputAutomatically>
    </recordLookups>
    <start>
        <locationX>232</locationX>
        <locationY>0</locationY>
        <connector>
            <targetReference>ConditionJudgementIsWeekend</targetReference>
        </connector>
        <schedule>
            <frequency>Once</frequency>
            <startDate>2021-02-14</startDate>
            <startTime>00:00:00.000Z</startTime>
        </schedule>
        <triggerType>Scheduled</triggerType>
    </start>
    <status>Active</status>
    <variables>
        <description>平日判定フラグ</description>
        <name>BusinessDayFlag</name>
        <dataType>Boolean</dataType>
        <isCollection>false</isCollection>
        <isInput>true</isInput>
        <isOutput>true</isOutput>
        <value>
            <booleanValue>true</booleanValue>
        </value>
    </variables>
</Flow>

まとめ

いかがでしたでしょうか。説明した手順で設定はうまくいきましたか。

標準機能のフロービルダーを使えば、多くの複雑な処理を自動化することができますが、変数を使ったり条件分岐などのロジックを組む必要があるため、プログラミングに近い作業が必要になります。

ただし、テストクラスを作成する必要がなかったり、コードを書くよりも簡単に短時間で設定して検証できるというのはメリットが大きいと思います。

今回紹介した内容を理解してぜひ実際のプロジェクトで活用してみてください。

お客様の業務を自動化する場合に、平日だけ処理を実行したいというご要望がよくありますが、この方法を使えば簡単に実現することができますので、是非マスターしてください。

※祝日も判定して営業日だけ処理をする方法については、最後にご紹介いたします。

例えば、平日の毎朝8時に期日切れタスクがあるかチェックして、期日超過がある場合には担当者へメール通知するなどの用途があります。

1.フロービルダーを使って週末を判定してみよう

今回は、スケジュールトリガーフローを使って、曜日を判定する処理を作成してみます。もちろんスケジュールトリガー以外のフローでも構いません。

大まかな処理の流れは以下の通りです。

では、一つ一つ手順の内容を解説していきたいと思います。

1.フローの実行日を使って曜日を判断する変数を定義

1.Salesforceにログインして、[設定] からクイック検索で[フロー]を検索して実行します。

[新規フロー]のボタンをクリックして、新規フロー作成画面を開きます。

2.新規フロー画面では、スケジュールトリガーフローを選択します。

作成方法で表示される自由形式と自由レイアウト(Beta)はどちらでもお好きなものを選択してください。

3.スケジュールを設定をクリックして、スケジュール設定画面を表示します。

①開始日と開始時間を入力します。指定された開始日、開始時間でスケジュールが起動します。

※開始時間は、組織のタイムゾーンの時間で実行されます。

組織のタイムゾーンが海外になっている場合、日本の時間で設定すると期待した時間に動作しないため注意が必要となります。

②頻度を指定します。※今回は週末判定のテストフローを作成し、デバッグ実行で確認するだけのため、1回のみとします。

4.新規リソースをクリックし、曜日を判定するための変数を定義します。

リソース種別：数式　API参照名、説明：自由に定義してください。

データ型：数値　※少数は0としてください。

数式は以下の内容を設定します。

上記数式により、フロー実行日の曜日が以下の0~6の数値で判定されます。

• 0:日曜日
• 1:月曜日
• 2:火曜日
• 3:水曜日
• 4:木曜日
• 5:金曜日
• 6:土曜日

2.曜日の変数を条件にして条件分岐処理を作成

1.続いて、要素を追加から、ロジック[決定]をクリックして、週末判定のロジックを作成します。

2.週末（土曜日・日曜日）を判定する処理を以下の内容で作成します。

結果：週末（土日）　表示ラベル：週末（土日）　API名は自由に定義ください。

結果を実行する条件の要件：いずれかの条件に一致（OR）を選択し以下2つの条件を追加

1. リソース：DayOfTheWeekDecimal　演算子：次の文字列と一致しない　値：0
2. リソース：DayOfTheWeekDecimal　演算子：次の文字列と一致しない　値：6

曜日判定の数式を使って、フロー実行日が0(日曜日)、または6(土曜日)のどちらかの場合は、週末（土日）と判断します。

もう一方のデフォルトの結果に関しては、ラベルを平日と定義　※ロジックは不要

3.営業日を最終的に判断するための新規リソースを追加して、以下の変数を定義します。

変数名：BusinessDayFlag　（ご自由に定義してください）

データ型：Boolean　デフォルト値：{!GlobalConstant.True}　※グローバル変数のTrueをセット（Trueで検索すると候補に表示されます）

4.週末判定処理の分岐で、週末判定された場合の後続フローで以下のロジック[割り当て]を定義します。

※週末の場合に、3.で作成した週末変数フラグにTrueをセットします。

変数：BusinessDayFlag　演算子：次の文字列と一致する　値：Global変数のFalseをセット

5.週末判定ロジックの完了

最終的に以下のようなフローが作成されます。

上記サンプルでは、スケジュール実行時の日付を使って、週末(土日)の判定が行われます。

週末判定処理の平日の後続フローに実行したい処理やサブフローの呼び出しを定義することで平日だけ処理を行うことができます。

また、今回のサンプルでは、1回だけの繰り返しとしましたが、スケジュールを毎日繰り返し処理として定義すれば平日の日次処理を作成することができます。

3.デバッグ実行

1.フローを保存したあと、デバッグボタンをクリックします。

フローをデバッグの画面が表示されます。今回作成したフローは特に処理を入れていないためロールバックの必要はありませんが、

データを作成したりするような処理がある場合は、ロールバックオードを利用して既存データに影響しないように実行することもできます。

2.実行結果の確認

デバッグ実行すると処理結果の詳細を確認することができます。上記ではご説明していませんが、以下の図の最後に表示されているような変数の値などを表示するメモを追加するとデバッグしやすくなりますので、ぜひお試しください。

※処理の最後にメモなどのアクションを定義するだけです。

4.フローの有効化とスケジュール設定

1.デバッグ実行で問題がなければ、上記で作成したフローを保存した後、有効化ボタンをクリックしてください。

2.フローを有効化すると、スケジュール済みジョブに実行計画が登録されます。

例では、2月14日の21:45に次回実行される予定で登録されています。

※スケジュールを変更したい場合は、フローのスケジュールを変更して保存後、有効化することで新しいスケジュールに変更することができます。

サンプルフロー（メタデータ）

本記事でご紹介したフローのメタデータを公開します。

<?xml version="1.0" encoding="UTF-8"?>
<Flow xmlns="http://soap.sforce.com/2006/04/metadata">
    <actionCalls>
        <name>DebugMemo</name>
        <label>営業日判定結果</label>
        <locationX>358</locationX>
        <locationY>1164</locationY>
        <actionName>NewNote</actionName>
        <actionType>quickAction</actionType>
        <inputParameters>
            <name>Title</name>
            <value>
                <stringValue>営業日判定</stringValue>
            </value>
        </inputParameters>
        <inputParameters>
            <name>Body</name>
            <value>
                <stringValue>日付：{!$Flow.CurrentDate}　曜日判定：{!DayOfTheWeekDecimal}　営業日判定：{!BusinessDayFlag}</stringValue>
            </value>
        </inputParameters>
    </actionCalls>
    <apiVersion>50.0</apiVersion>
    <assignments>
        <name>SetBusinessDayFlagFalse</name>
        <label>営業日フラグにFalseをセット</label>
        <locationX>50</locationX>
        <locationY>396</locationY>
        <assignmentItems>
            <assignToReference>BusinessDayFlag</assignToReference>
            <operator>Assign</operator>
            <value>
                <booleanValue>false</booleanValue>
            </value>
        </assignmentItems>
        <connector>
            <targetReference>DebugMemo</targetReference>
        </connector>
    </assignments>
    <assignments>
        <name>SetBusinessDayFlagFalse_0</name>
        <label>営業日フラグにFalseをセット</label>
        <locationX>754</locationX>
        <locationY>756</locationY>
        <assignmentItems>
            <assignToReference>BusinessDayFlag</assignToReference>
            <operator>Assign</operator>
            <value>
                <booleanValue>false</booleanValue>
            </value>
        </assignmentItems>
        <connector>
            <targetReference>LoopHolidayRecords</targetReference>
        </connector>
    </assignments>
    <decisions>
        <description>祝日判定処理</description>
        <name>ConditionJudgementHolidays</name>
        <label>祝日判定処理</label>
        <locationX>886</locationX>
        <locationY>636</locationY>
        <defaultConnector>
            <targetReference>LoopHolidayRecords</targetReference>
        </defaultConnector>
        <defaultConnectorLabel>営業日</defaultConnectorLabel>
        <rules>
            <name>IsHoliday</name>
            <conditionLogic>and</conditionLogic>
            <conditions>
                <leftValueReference>$Flow.CurrentDate</leftValueReference>
                <operator>EqualTo</operator>
                <rightValue>
                    <elementReference>LoopHolidayRecords.ActivityDate</elementReference>
                </rightValue>
            </conditions>
            <connector>
                <targetReference>SetBusinessDayFlagFalse_0</targetReference>
            </connector>
            <label>祝日</label>
        </rules>
    </decisions>
    <decisions>
        <description>週末(土日)判定処理
0:日曜日、6:土曜日</description>
        <name>ConditionJudgementIsWeekend</name>
        <label>週末(土日)判定処理</label>
        <locationX>358</locationX>
        <locationY>276</locationY>
        <defaultConnector>
            <targetReference>GetOrgHolidayRecords</targetReference>
        </defaultConnector>
        <defaultConnectorLabel>平日</defaultConnectorLabel>
        <rules>
            <name>IsWeekend</name>
            <conditionLogic>or</conditionLogic>
            <conditions>
                <leftValueReference>DayOfTheWeekDecimal</leftValueReference>
                <operator>NotEqualTo</operator>
                <rightValue>
                    <numberValue>0.0</numberValue>
                </rightValue>
            </conditions>
            <conditions>
                <leftValueReference>DayOfTheWeekDecimal</leftValueReference>
                <operator>NotEqualTo</operator>
                <rightValue>
                    <numberValue>6.0</numberValue>
                </rightValue>
            </conditions>
            <connector>
                <targetReference>SetBusinessDayFlagFalse</targetReference>
            </connector>
            <label>週末（土日）</label>
        </rules>
    </decisions>
    <formulas>
        <description>曜日判定のための変数</description>
        <name>DayOfTheWeekDecimal</name>
        <dataType>Number</dataType>
        <expression>MOD( {!$Flow.CurrentDate} - DATE(1900, 1, 7), 7)</expression>
        <scale>0</scale>
    </formulas>
    <interviewLabel>営業日判定フロー {!$Flow.CurrentDateTime}</interviewLabel>
    <label>営業日判定フロー</label>
    <loops>
        <name>LoopHolidayRecords</name>
        <label>祝日分繰り返し処理 (LoopHolidayRecords)</label>
        <locationX>666</locationX>
        <locationY>516</locationY>
        <collectionReference>GetOrgHolidayRecords</collectionReference>
        <iterationOrder>Asc</iterationOrder>
        <nextValueConnector>
            <targetReference>ConditionJudgementHolidays</targetReference>
        </nextValueConnector>
        <noMoreValuesConnector>
            <targetReference>DebugMemo</targetReference>
        </noMoreValuesConnector>
    </loops>
    <processMetadataValues>
        <name>BuilderType</name>
        <value>
            <stringValue>LightningFlowBuilder</stringValue>
        </value>
    </processMetadataValues>
    <processMetadataValues>
        <name>CanvasMode</name>
        <value>
            <stringValue>AUTO_LAYOUT_CANVAS</stringValue>
        </value>
    </processMetadataValues>
    <processMetadataValues>
        <name>OriginBuilderType</name>
        <value>
            <stringValue>LightningFlowBuilder</stringValue>
        </value>
    </processMetadataValues>
    <processType>AutoLaunchedFlow</processType>
    <recordLookups>
        <name>GetOrgHolidayRecords</name>
        <label>組織の休日レコード取得</label>
        <locationX>666</locationX>
        <locationY>396</locationY>
        <assignNullValuesIfNoRecordsFound>false</assignNullValuesIfNoRecordsFound>
        <connector>
            <targetReference>LoopHolidayRecords</targetReference>
        </connector>
        <getFirstRecordOnly>false</getFirstRecordOnly>
        <object>Holiday</object>
        <storeOutputAutomatically>true</storeOutputAutomatically>
    </recordLookups>
    <start>
        <locationX>232</locationX>
        <locationY>0</locationY>
        <connector>
            <targetReference>ConditionJudgementIsWeekend</targetReference>
        </connector>
        <schedule>
            <frequency>Once</frequency>
            <startDate>2021-02-14</startDate>
            <startTime>00:00:00.000Z</startTime>
        </schedule>
        <triggerType>Scheduled</triggerType>
    </start>
    <status>Active</status>
    <variables>
        <description>平日判定フラグ</description>
        <name>BusinessDayFlag</name>
        <dataType>Boolean</dataType>
        <isCollection>false</isCollection>
        <isInput>true</isInput>
        <isOutput>true</isOutput>
        <value>
            <booleanValue>true</booleanValue>
        </value>
    </variables>
</Flow>

上記、このソースの前半部分が平日判定の内容となります。

まとめ

いかがでしたでしょうか。説明した手順で設定はうまくいきましたか？

今回は、週末を判定するだけでしたが、週末及び祝日を判定して営業日だけ処理を実行する方法もあります。

そのやり方は、以下の記事で紹介していますので、興味があればご覧ください

この機能は、Apexのスケジュールバッチとほぼ同様の処理が設定だけでできてしまうという、かなり便利な機能（方法）となりますので、ぜひマスターしてください。

例えば、毎朝8時に商談の期日が切れているタスクがあるかチェックして、存在する場合には担当者へメール通知するなどの用途があります。

1.スケジュールトリガーフローでメールを送信してみよう

スケジュールトリガーフローを使って、メールを送信処理を設定してみましょう。

では、一つ一つ手順の内容を解説していきたいと思います。

1.組織のメールアドレスを設定

管理人

まずは組織のメールアドレスを設定しましょう

1.Salesforceにログインして、[設定] からクイック検索で[組織のメールアドレス]を検索して実行します。

組織のアドレス画面から、組織のメールアドレス[追加]を実行します。

画像をクリックすると拡大できます。

2.続いて、Salesforce組織から送信する際の送信メールアドレスと表示名を設定します。

また、この送信元アドレスの私用を許可するプロファイルを選択します。

※組織のメールアドレスを利用する処理を実行するプロファイルが選択されているかチェックしてください。

3.メールアドレスを登録すると、状況が[確認要求送信済]となります。

登録したメールアドレスに「Salesforce組織アドレス変更のお知らせ」が届いているか確認してください。

届かない場合は、メールアドレスが正しいかチェックして、再送を実行してください。

4.以下のメールが届いたら、メール内のURLリンクをクリックして、組織のメールアドレスを有効化します。

5.組織のメールアドレスが有効化されたら状況が「検証済み」となっていることを確認してください。

ここまでで組織のメールアドレス設定が完了となります。

※スケジュールトリガーフローでメールが届かないという場合は、組織のメールアドレスが未検証のままとなっていることが多いので、検証済みまで設定しておきましょう。

2.プロセスの自動化設定

続いて、プロセスの自動化設定を行います。

1.[設定] からクイック検索で[プロセスの自動化設定]を検索して実行します。

①デフォルトのワークフローユーザを選択します。（システム管理者権限を持っているユーザを推奨）

②自動化プロセスユーザのメールアドレスを設定します。フロー実行時に送信元のメールアドレスとして利用されます。

3.スケジュールトリガーフローの作成

メールの設定完了後はフローの設定に進みます。

1.[設定] からクイック検索で[フロー]を検索して実行します。

新規フローのボタンをクリックして、新規フロー作成画面を開きます。

2.新規フロー画面では、スケジュールトリガーフローを選択します。

作成方法で表示される自由形式と自由レイアウト(Beta)はどちらでもお好きなものを選択してください。

3.スケジュールを設定をクリックして、スケジュール設定画面を表示します。

①開始日と開始時間を入力します。指定された開始日、開始時間でスケジュールが起動します。

※開始時間は、組織のタイムゾーンの時間で実行されます。

組織のタイムゾーンが海外になっている場合、日本の時間で設定すると期待した時間に動作しないため注意が必要となります。

②頻度を指定します。1回だけの処理か、毎日同じ時間に処理を繰り返す、毎週同じ曜日、時間に処理を繰り返すのいずれかを選択

4.続いて、アクションを定義します。

5.新規アクションで、メールを送信を選択します。

6.メールを送信アクションでは、必須項目に必要な情報を登録します。以下参照

※実際のプロジェクトで作成する場合には件名や本文の項目については、事前に変数やテンプレートを用意しておきそれを指定するようにしてください。

このサンプルでは、直接文字列を設定しています。

7.最後にフローに名前を付けて保存します。

4.フローの有効化とスケジュール設定

1.作成したフローを保存した後、有効化ボタンをクリックしてください。

保存しただけで、有効化するのを忘れることが多いので気を付けてください。

以下のようなワーニングが表示される場合は、2.プロセスの自動化設定が正しく行われているか確認してください。

作成したフローにワーニングやエラーがある場合には、[デバッグ]実行をすることをお勧めします。

デバッグ実行することで、どのプロセスでどのような結果になっているのか、可視化できるため、素早く問題点を発見することができます。

問題が解決した場合には、フローを有効化し、スケジュール済みジョブに実行計画が登録されることを確認しましょう

例では、2月14日の21:45に次回実行される予定で登録されています。

※スケジュールを変更したい場合は、フローのスケジュールを変更して保存後、有効化することで新しいスケジュールに変更することができます。

3.指定時間になるとスケジュールが実行されメールが送信されます。

以下のようなメールがSalesforceから送信されます。

もし、メールが届かないという場合は、スケジュール済みジョブを確認して、開始のところに実行時間が表示されているか確認してください。

スケジュールの定義が間違っている可能性があります。もしくは組織のタイムゾーンの設定が日本以外になっている可能性があります。

5.メール送信設定の変更（Sandbox環境場合）

Sandbox環境でメール送信のテストを実施する場合に、メールが送信されないというお問い合わせがよくありますが、Sandbox環境は、デフォルトではシステムメール以外は通知されない設定になっています。※メール誤送信を防止する目的

1.[設定]からクイック検索で[送信]を検索し実行します。

メールを送信するためのアクセス権（すべてのメールサービス）のアクセス件を確認し、すべてのメールになっているか確認してください。

システムメールのみやアクセス権限なしになっている場合は、すべてのメールに変更して保存してください。

上記設定によって、Sandbox環境からワークフローなどを使ったメールの送信が可能となります。

サンプルフローのダウンロード

本記事でご紹介したフローのサンプルはGithubに公開しているので必要な方はダウンロードしてください。

まとめ

いかがでしたでしょうか。説明した手順で設定はうまくいきましたか？

メール送信を行う場合は、一日に送信可能な上限がありますので業務要件に見合うかどうか確認してから利用してくださいね。