レコードを取得要素
[レコードを取得] 要素では、検索条件と並び替え条件を満たすすべての Salesforce レコードを検索し、取得したレコードの値を変数に保存します。[レコードを取得] 要素を使用して、Salesforce 標準およびカスタムオブジェクトレコードを取得できます。
必要なエディション
この動画では、[レコードを取得] 要素の概要と、フローで使用する理由について説明します。
この動画は別のタブでご覧ください。
このトランスクリプトでは、テキストベースのバージョンの動画コンテンツが提供されます。
フローがデータに接続されていないことをご存知ですか?フローは Salesforce 組織で何が起こっているかを認識していません。では、フローにデータを取り込むにはどうすればよいのでしょうか?フローにデータを取り込むのに役立つデータ要素があれば?待って、あります。情報をフローに取り込むために、レコードを取得データ要素を使用します。[レコードを取得] では、レコードを取得するオブジェクトを選択したり、取得するレコードを決定する条件を設定したりできます。1 つ以上のレコードを操作できます。レコード内で、すべての項目を取得するか、必要な項目のみを選択できます。レコードがフローに取り込まれると、いくつかの方法で情報を操作できます。決定の通知、フローに取り込んだレコードの更新、他のレコードの更新などを行うことができます。これらのすべての決定や更新は一時的であり、情報が Salesforce 組織に送信されるまでフローにのみ存在します。これは、レコードの作成、削除、および更新データ要素を使用して実行できます。[レコードを取得] では、フローに情報が取り込まれ、レコードの作成、削除、更新要素でその情報が Salesforce 組織に戻されます。
関連レコードの取得 (ベータ)
[レコードを取得] 要素の関連レコードは、自動起動フローで使用できます。「フローからの関連 Salesforce レコードの取得 (ベータ)」を参照してください。
保存するレコード数
検索するレコードでオブジェクトを識別します。検索条件と並び替え順を指定して、返されるレコードのリストを絞り込みます。
![取引先オブジェクトの [レコードを取得] 要素 ([保存するレコード数] で [すべてのレコード、指定した制限まで] が選択されている)](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-platform_automation-262-0-0-production-jajp/8ed0bfc5-eabc-4d20-96b5-17a87da341e6/platform_automation/images/flow/flow_ref_get_records.png)
| 選択するオプション | 実行する処理 |
|---|---|
| 最初のレコードのみ | 指定された条件を満たす最初のレコードのみを保存します。 たとえば、このオプションを使用して、通話者の電話番号に一致する最初のレコードを検索し、通話者の詳細を取得します。 |
| すべてのレコード | 指定された条件を満たすすべてのレコードを保存します。 たとえば、マーケティングキャンペーンで特定の取引先に関連付けられたすべての取引先責任者を収集する場合にこのオプションを使用します。 |
| すべてのレコード、指定された制限まで | 指定された上限まですべてのレコードを保存します。 上限として 2 ～ 20,000 の数値を指定します。[保存するレコードの最大数] 項目では、数値データ型のリテラル、変数、定数、または数式を使用できます。 たとえば、このオプションを使用して最初の 50 件のレコードを取得すると、大規模なデータセットからサンプルを分析できます。 |
レコードデータの保存方法
画面フローまたは自動起動フローに [レコードを取得] 要素を追加すると、すべてのレコード値が自動的にフロー変数に保存されます。フローが次の要素に移動すると、これらの値が変数に割り当てられます。
| 選択するオプション | 実行する処理 |
|---|---|
| すべての項目を自動的に保存する | 指定された検索条件を満たすレコードのすべての項目を自動的に保存します。取得されたレコードのすべての項目がフロー変数に保存されます。このオプションは、レコードの複数の項目を操作する必要があり、各項目を個別に指定せずにすべてのデータを使用できるようにする場合に便利です。 たとえば、パイプラインのすべての商談を分析するときに、このオプションを使用してすべての商談項目を保存します。その後、項目を詳細な分析に使用したり、後続のフローで使用したりできます。 |
| 項目を選択して後は Salesforce に任せる | 取得されたレコードから保存する項目を手動で指定します。このオプションを使用すると、保存するデータを選択できるため、特定の項目のみが必要な場合に効率が向上します。 たとえば、このオプションは、カスタマーサービス担当者が自分に割り当てられたすべてのオープンケースの優先度と状況のみを更新する必要がある場合に使用します。レコードから必要な項目のみを取得することで、複雑さを軽減し、パフォーマンスを向上させることができます。 |
| 項目を選択して変数を割り当てる (高度) | 画面フローまたは自動起動フローでレコード値を手動で保存します。 たとえば、特定のキャンペーンのすべての成立商談の合計金額を計算するには、金額項目を特定の変数に割り当てます。項目を選択して変数を割り当てると、フローでこれらの値を簡単に追加したり、合計金額に基づいて他の計算を実行したりできます。「項目の選択と変数の割り当て (高度な)」を参照してください。 |
項目を選択して変数を割り当てる (高度)
| 希望する動作 | 処理 |
|---|---|
| 最初のレコードのみの項目値を手動で保存する |
|
| 複数のレコードの項目値を手動で保存する | 値をレコードコレクション変数に保存します。レコードコレクション変数を使用して一度に複数のレコードを作成、更新、または削除すると、フロー内の DML 要求数が削減されます。組織の制限を超えない可能性が高くなります。「トランザクションでのフローの一括処理」を参照してください。 次に、いくつか例を示します。
|
取得したレコードの並び替え
選択した項目に基づいて、取得したレコードを昇順または降順に並び替えます。並び替え順は、特定の順序でレコードを処理する場合に便利です。日付項目でレコードを並び替えて昇順を選択すると、最も古い日付が最初に表示されます。降順を選択した場合、最新の日付が最初に表示されます。数値項目でレコードを並び替えて昇順を選択すると、最小値が最初に表示されます。降順を選択した場合、最も高い値が最初に表示されます。
レコードを昇順で並び替える場合、null 値は可能な最小値とみなされるため、null 値はリストの先頭に表示されます。逆に、レコードを降順で並び替えると、null 値がリストの最後に表示されます。
取得されたレコード数の確認
[レコードを取得] 要素で返されるレコード数を確認するには、まず数値変数を作成します。次に、割り当て要素と [次の文字列と一致する] 演算子を使用して、[レコードを取得] 要素のレコードコレクション変数の値を数値変数に割り当てます。フローをデバッグすると、number 変数の値によって取得されたレコード数がわかります。
返されたレコードがない場合のエラー処理
[レコードを取得] 要素が [項目を選択して変数を割り当てる (詳細)] に設定されていて、検索条件に一致するレコードがない場合、フローはレコードを取得しません。項目値の保存に使用する変数が空または null である。つまり、これらの変数に依存するフローロジックでは、データが存在しない場合を処理する必要があります。取得したデータに依存するアクションに進む前に、決定要素を使用して変数が空かどうかを確認します。フローがユーザー向けの場合は、一致するレコードが見つからなかったことを示すフィードバックをユーザーに提供します。このフィードバックにより、特定のアクションやデータが使用できない理由が明確になり、ユーザーエクスペリエンスが向上します。
検索条件の定義に関する考慮事項
-
通常、複数の検索条件を定義する場合、検索条件ロジックはデフォルトの AND になります。ただし、複数の検索条件で同じ項目が選択され、「次の文字列と一致する」演算子が使用されている場合、検索条件は OR で結合されます。
たとえば、「種別 次の文字列に一致する 問題」 (1)、「種別 次の文字列に一致する 機能要求」 (2)、および「エスカレーション済み 次の文字列に一致する true」 (3) のケースかどうかを検索条件でチェックします。実行時に、検索条件は
(1 OR 2) AND 3のように結合されます。 - 使用可能な検索条件の演算子は、選択した項目のデータ型によって異なります。詳細は、「データ要素とレコード選択肢セットのフロー演算子」を参照してください。
- Data Cloud オブジェクトをデータソースとして使用するには、組織にオブジェクトのデータマッピングが含まれている必要があります。データマッピングは、データレークオブジェクト (DLO) 項目をデータモデルオブジェクト (DMO) 項目に関連付けます。組織にマッピングが含まれていない場合、[レコードを取得] 要素で Data Cloud データスペースまたはオブジェクトを選択できません。
