フロー画面へのレコード項目の追加
Salesforce オブジェクトから直接項目を追加して、フロー画面をすばやく作成できます。フロー画面にレコード項目を追加すると、その名前、データ型、ヘルプテキスト、必須設定、場合によっては既存の値が自動的に設定されます。レコード項目は、レコード変数を使用して、フロー画面に配置できる項目とその設定を決定します。
必要なエディション
| サポートされているエディションを表示する。 |
| 必要なユーザー権限 | |
|---|---|
| Einstein for Flow や Agentforce for Flow など、Flow Builder で使用できるすべてのフロー タイプ、要素、機能を使用してフローを開く、編集、作成、有効化、または無効化する | 「フローの管理」 |
フロー画面でのレコード項目の直接配置
レコード項目を画面フローに追加する手順は、次のとおりです。
- 画面要素を作成または編集します。
-
[項目] タブで、レコード変数を選択するか、レコードデータ型と、目的の項目が含まれるオブジェクトを使用して変数を作成します。
または、[レコードを取得] 要素によって自動的に作成されたレコード変数や、ループ要素を選択します。
- 表示された項目のリストから、項目を画面のキャンバスにドラッグします。
- レコード項目の既存の値を使用するには、レコード変数の [レコードを取得] 要素を使用します。
フロー画面のレコード項目に関する考慮事項
Salesforce オブジェクトの項目をフロー画面に直接追加する前に、レコード項目の動作を考慮してください。
取引先ティッカー項目
画面の取引先レコードに標準ティッカーシンボル項目を配置すると、フローを保存できなくなります。
レコードの作成と更新
画面の他の項目と同様に、レコード項目のデータは自動的に保存されません。レコード項目データを保存するには、[レコードを作成] 要素または [レコードを更新] 要素で関連付けられたレコード変数を使用します。
デフォルト値
レコード項目では、ソース項目のデフォルト値はサポートされません。レコード項目のソース項目にデフォルト値がある場合、そのレコード項目は空白になります。
項目にレコード変数の値が含まれている場合、その値は実行時の画面でデフォルト値として設定されます。
行動および ToDo レコード項目
一部の行動および ToDo レコード項目はサポートされていません。サポートされるデータ型は、日付、日付/時間、チェックボックス、数値、テキスト、テキストエリア、ロングテキストエリアです。
実行時、行動レコード項目と ToDo レコード項目の動作は、画面の他のタイプのレコード項目とは異なります。
- チェックボックス項目の表示ラベルは、チェックボックスに合わせて表示されません。チェックボックスの上または下に表示されます。
- 編集すると、レコード項目の背景が黄色にならず、[元に戻す] ボタンは表示されません。
参照関係
- ルックアップからのレコードの作成は、URL から起動されるフロー (リスト ボタンなど)、フロー デバッガ、Lightning Out、デジタル エクスペリエンス (LWR)、組み込みサービス フローの環境ではサポートされません。
- 参照項目はモバイルデバイスと互換性がありません。
- 既存のレコードの主従関係の値を表示または変更するには、その項目の [親の変更を許可] 設定を有効にする必要があります。
- 検索条件が適用された参照項目では、フローを実行しているユーザーがレコードを作成しようとしても、フローランタイムのエラーはすぐに表示されません。エラーは、新規作成されたレコードを参照するレコードを作成または更新するときにのみ表示されます。
- UI API は、ルックアップが存在するオブジェクトをサポートしている必要があります。
ルックアップ検索条件
ルックアップ検索条件がフローの現在のレコードの項目値に依存している場合、ルックアップ検索条件で使用される項目は同じ画面に追加する必要があります。フローでユーザーが実行したアクションに基づいてルックアップで使用できるレコードを制限する必要がある場合は、選択肢ルックアップコンポーネントを使用します。
複数選択リスト
割り当てで [項目を追加] 演算子を使用すると、複数選択リスト項目で重複する値を使用できます。
名前項目
実行時に [名前] サブ項目の値が変更されると、新しい値が設定され、サブ項目に新しい値が表示されます。ただし、[氏名] レコードの [氏名] 項目には元の値が表示されます。
権限
システムコンテキストはレコード項目には適用されません。ユーザーがレコード項目へのアクセス権を持っていない場合、そのレコード項目はフローで表示されません。
レコード変数に ID が設定されていない場合、実行ユーザーがレコード項目値を変更するには、Read アクセス権と Create アクセス権の両方が必要です。
ID が設定されている場合、実行ユーザーがレコード項目値を変更するには、Read アクセス権と Edit アクセス権の両方が必要です。
レコード項目の詳細では、[Update Compatible (互換を更新)] および [Create Compatible (互換を作成)] の値に項目のプロパティと権限が反映されます。この値は、フローを実行しているユーザーの権限を反映していません。
画面フローには、オブジェクトレベルで参照のみに設定されたレコード項目は表示されません。
個人取引先
PersonAccount が有効になっていて、取引先レコード項目が画面に追加されている場合:
- レコードタイプが個人取引先の場合、個人* 項目と共通項目のみが表示されます。
- レコードタイプが法人取引先の場合、法人取引先項目と共通項目のみが表示されます。
すべての取引先レコード項目が表示され、レコードタイプは無視されます。
Account.Nameは、レコードタイプが個人取引先の場合はPersonName項目として表示され、法人取引先の場合はテキスト項目として表示されます。Account.Name はテキストフィールドとして表示されます。
選択リスト
レコード項目では、連動項目が制御項目と同じ画面にある場合にのみ連動選択リストがサポートされます。
画面に入ったときにレコード項目にレコードタイプ ID が設定されている場合、その値はレコードタイプで絞り込まれます。レコードタイプ ID が設定されていない場合、すべての値が表示されます。
レコード項目の参照
数式、決定、条件付き表示など、フローの他の領域のレコード項目を参照することはできません。代わりに、レコード項目の作成に使用したレコード変数を参照します。
ランタイム環境
レコード フィールドは、Lightning Web Runtime(LWR)を使用する Experience Cloud サイトの画面フローではサポートされません。
サポートされる項目データ型
レコード項目では、住所、チェックボックス、日付、日時、メール、参照、名前、数値、電話、選択リスト、テキスト、テキストエリア、ロングテキストエリアのデータ型がサポートされます。
その他の考慮事項
- レコード項目では、ユーザーインターフェース (UI) API でサポートされるオブジェクト項目がサポートされます。
- レコード項目では、ユーザーインターフェース (UI) API から返された表示ラベルが使用されます。これは、レコードページやオブジェクトマネージャーに表示される表示ラベルとは異なる場合があります。名前データ型のレコード項目の場合、ほとんどのオブジェクトで表示ラベルが [名前] ではなく [氏名] として表示されます。
- 繰り返し画面コンポーネントでは、レコード項目はサポートされていません。
- ユーザー入力の検証はサポートされていません。
