インタラクション

概要

インタラクションは、動的コンポーネントのロジックと動作を定義します。ボタンのクリック、行の選択、ページの読み込みなど、ユーザーがインターフェイスとやり取りしたときにアプリがどのように反応するかを決定します。

ノーコードビルダーを使用すると、シンプルなイベント駆動パターンに従って複雑な動作を定義できます：

トリガー （例：クリック時） $\rightarrow$ アクション （例：ナビゲート） $\rightarrow$ 結果 （例：ページを開く）

---

インタラクションの設定方法

1. コンポーネントを選択： 動的コンポーネントを開き、インタラクティブにしたい特定の要素（例：ボタン、データテーブル）をクリックします。

2. インタラクションにアクセス： 右側のプロパティパネルのインタラクションタブに移動します。

3. トリガーを選択： シーケンスを開始するイベントを選択します（例： クリック時, 行アクション時, 読み込み時).

4. アクションを追加： 「アクションを追加」をクリックし、下のライブラリから目的のインタラクションタイプを選択します。

5. アクションを連鎖 （オプション）： 1つのトリガーに複数のアクションを追加できます。これらは順次実行されます（例： レコードを更新 $\rightarrow$ トーストを表示 $\rightarrow$ モーダルを閉じる).

💡 ヒント： 1つのトリガーに複数のアクションを連結します。順番に実行されるので、フロー実行 → トースト表示 → ナビゲートのようなシーケンスを作成できます。

---

インタラクション参照

ナビゲーションとフィードバック

ユーザーを別ページへ誘導し、操作に対して視覚的なフィードバックを提供します。

アクション	説明
ナビゲート	ユーザーをレコードページ、オブジェクトホーム、外部URL、または別のアプリへリダイレクトします。
トーストを表示	画面上部に一時的な通知バナー（成功、警告、エラー、情報）を表示します。
アラートモーダルを開く	続行するためにユーザーの確認が必要な重要なメッセージでワークフローを中断します。
確認ダイアログを開く	ユーザーに操作の確認またはキャンセルを求めます（「削除」や「送信」のシナリオに最適）。

動的コンポーネント

現在のページ内で他の動的コンポーネントを開き、階層化されたワークフローを実現します。

アクション	説明
コンポーネントダイアログを開く	別の動的コンポーネントをモーダルオーバーレイで開きます。ウィザードや複雑なフォームに最適です。
コンポーネントパネルを開く	別の動的コンポーネントをスライドするサイドパネルで開きます。

フロー

Salesforceフローを統合してビジネスロジックを実行し、ガイド付きプロセスを表示します。

アクション	説明
フローを実行	バックグラウンドで自動起動フローを実行し、計算やデータ操作を行います。
フロードイアログを開く	現在のページ上にモーダルウィンドウ（ポップアップ）で画面フローを起動します。
フローパネルを開く	主要コンテンツを表示したまま、スライディングサイドパネル内で画面フローを起動します。

レコードとデータ

Salesforceレコードを管理し、コンポーネントから直接データをエクスポートします。

アクション	説明
レコードを作成	レコード変数に格納された値を使用してSalesforceに新しいレコードを作成します。
レコードを更新	レコード変数に加えた変更をSalesforceにコミットします。
レコードを削除	現在のレコード変数に関連するレコードを完全に削除します。
レコードを取得	特定のレコード変数について、最新データをデータベースから更新または取得します。
レコードをコピー	（データテーブルヘッダーのみ） 選択した行をクリップボードにコピーし、Excelやメールに貼り付けられる形式にします。
ダウンロード	データテーブルのコンテンツから直接ファイルをダウンロードできるようにします。

変数とAI

コンポーネント内で情報を保存し、AI機能を活用します。

アクション	説明
代入	変数の値を変更します（例：設定、加算、トグル）。状態管理や計算に使用します。
AgentForceを呼び出す	推奨、要約、または自動意思決定などのタスクを実行するAIエージェントをトリガーします。

その他のアクション

特定のユースケース向けの追加の特殊なインタラクションです。

アクション	説明
クイックアクションを開く	標準のSalesforceクイックアクション（例：通話ログ、新しいタスク）を起動します。
位置情報を更新	デバイスの現在の座標を取得し、位置ベースのデータフィールドを更新します。

---

一般的なパターン

データを更新した後： 最新情報を表示するために常に「クエリを更新」アクションを追加してください。

削除する前に： 誤った削除を防ぐために「確認ダイアログを開く」を使用してください。

複雑なワークフロー： フロー実行 → 代入 → トースト表示 → ナビゲートのようにアクションを連鎖させます。

ユーザーへのフィードバック： 重要な操作の後にトーストを含めて、成功を確認したりエラーを説明したりしてください。

---

トラブルシューティング

⚠️ クリックしてもインタラクションが何も起こらない

インタラクションはコンポーネントビルダーのプレビューでは機能しません。実際のページでテストする必要があります。

インタラクションを正しくテストする方法は次のとおりです：

1. 動的コンポーネントを保存 ビルダー内で

2. Lightningページに移動 このコンポーネントを追加したページ（例：アカウントページやホームページ）へ移動します

3. ページをリフレッシュ 最新の変更を読み込むために

4. インタラクションを試す − ボタンをクリックしたり、行を選択したりします。

まだページにコンポーネントを追加していない場合：

1. セットアップ → Lightning App Builder に移動します

2. ページを編集（または新規作成）します

3. 動的コンポーネントをページにドラッグします

4. ページを保存して有効化します

5. そのページを表示してインタラクションをテストします

それでも動作しない場合： キーボードでF12を押してブラウザのコンソールを開きます。赤いエラーメッセージを探してください — 何が問題かを教えてくれます。

↕️ アクションが間違った順序で発生する

1つのインタラクションに複数のアクションを追加すると、リストの上から下へ実行されます。

順序を変更するには：

1. インタラクションパネルに移動します

2. アクションのリストを見つけます

3. ドラッグ＆ドロップで 左側のハンドルを掴んで正しい順序に並べ替えます

4. コンポーネントを保存します

アクションがまだ同期していないように見える場合、実行が速すぎる可能性があります。各アクションの間に短い遅延を追加してみてください。

↻ アクション後に古い情報が表示される

レコードを更新、作成、または削除しても、コンポーネントは表示内容を自動的にリフレッシュすることはありません。

対処法：

1. インタラクションを開きます

2. 更新／作成／削除アクションの後に、クリックします 「アクションを追加」

3. を選択します 「クエリを更新」

4. リフレッシュが必要なデータテーブルやコンポーネントを選択します

5. 保存します

これで変更後にコンポーネントがデータを再読み込みし、ユーザーは更新された情報をすぐに確認できます。

→ ナビゲーションボタンが間違った場所に移動する

ナビゲートアクションにはどこへ移動するかを指定する設定があります。そのうちの1つが正しくない可能性があります：

これらの設定を確認してください：

• ページ参照タイプ： 「レコードページ」に移動しようとしているのに「オブジェクトホーム」を選択していませんか？

• レコードID： 特定のレコードに移動する場合、これが正しいレコードのIDですか？（別のフィールドから取得している可能性があります）

• オブジェクトAPI名： 「Contact」のつもりが「Account」と入力していませんか？

確認方法：

1. インタラクションパネルで該当のインタラクションをクリックします

2. ナビゲート設定内の各フィールドを確認します

3. レコードIDには正しい変数やフィールド名を使っているか確認します

4. 存在が確認できるレコードでテストします

それでも問題がある場合は、まず単純なテストレコードにナビゲートして、ナビゲートアクション自体が機能するか確認してみてください。

---

次のステップ

まずはナビゲートやトースト表示などの単純なインタラクションから始め、慣れてきたら複雑なシーケンスを構築してください。各インタラクションタイプには、具体例と設定オプションを含む詳細なドキュメントがあります。