クイックアクションを開く
概要
「Open Quick Action」インタラクションは、Avonniダイナミックコンポーネント内から直接Salesforceのクイックアクションを起動できる機能です。これにより、レコード詳細ページに移動する必要なく、標準またはカスタムのクイックアクションを実行でき、ワークフローの効率化やより迅速なデータ入力が可能になります。
設定
「Open Quick Action」インタラクションは、ユーザーの操作(ボタンクリックなど)をSalesforceのクイックアクションに接続します。設定するとクイックアクションのモーダルを開き、必要に応じてフォームフィールドを事前入力し、レコードIDなどのコンテキストを渡します。
このインタラクションは、コンポーネントのプロパティパネル内の「Interactions」セクションから、対応するAvonniコンポーネントに追加できます。インタラクションタイプとして「Open Quick Action」を選択してください。
ターゲット名
ここでは、コンポーネント上のどのアクションがクイックアクションをトリガーするかを選択します。コンポーネントにアクション(データテーブルのヘッダーアクションや行アクションなど)を追加すると、このドロップダウンに表示されるようになります。
仕組み
まず、コンポーネントにアクションを作成します(例:データテーブルの行アクションとしての「Send Email」)
そのアクション名がターゲット名ドロップダウンのオプションとして表示されます
このクイックアクションインタラクションに接続したいアクションを選択します
例: データテーブルに「Send Email」という行アクションを追加した場合、ターゲット名ドロップダウンから「Send Email」を選択して、そのアクションをクイックアクションにリンクします。
ソースエンティティ
これはクイックアクションのオブジェクトコンテキストを指定します:
オブジェクト固有のクイックアクションの場合: 標準またはカスタムオブジェクトのAPI名を入力します(例:
Contact,Account,Opportunity,Custom_Object__c)グローバルクイックアクションの場合: このフィールドを空のままにしてください
なぜ重要か: オブジェクト固有のクイックアクションは特定のオブジェクトに紐づき、そのオブジェクトのアクションメニューに表示されます。グローバルクイックアクションは組織全体で機能し、特定のオブジェクトに紐づきません。
クイックアクションAPI名
起動したいクイックアクションのAPI名です。オブジェクト固有かグローバルかによって形式が異なります:
オブジェクト固有のクイックアクションの場合: オブジェクト固有の場合は、クイックアクションのAPI名の前にオブジェクトのAPI名とドット(.)を付けてください。
形式: ObjectAPIName.QuickActionAPIName
例:
Contact.SendEmail- ContactオブジェクトのSend EmailアクションAccount.LogACall- AccountオブジェクトのLog a CallアクションOpportunity.NewTask- Opportunityオブジェクトのタスク作成アクションCustom_Object__c.Custom_Action__c- カスタムオブジェクトのカスタムアクション
グローバルクイックアクションの場合: オブジェクト接頭辞なしで、クイックアクションのAPI名のみを使用してください。
例:
NewContact- 連絡先を作成するグローバルアクションNewTask- タスクを作成するグローバルアクションLogACall- 通話を記録するグローバルアクションSendEmail- メールを送信するグローバルアクション
API名の見つけ方:
設定 → オブジェクトマネージャ → [対象オブジェクト] → Buttons, Links, and Actions に移動してください
または 設定 → Global Actions(グローバルアクションの場合)
対象のアクションを見つけ、そのAPI名を確認してください
レコードID (任意)
クイックアクションが関連付ける、またはコンテキストとして使用するレコードを指定します。レコードIDを含むフィールドや変数への参照を入力してください。
一般的な使用例:
record:Id- (レコードページにいる場合の)現在表示中のレコード{!Datatable1.selectedRowsKeyValue}- データテーブルで選択されたレコード{!variableName}- レコードIDを格納する変数
レコードIDを使用するタイミング:
クイックアクションがどのレコードに対して動作するかを知る必要がある場合
「Send Email」のように関連レコードが必要なアクションの場合
関連レコードを作成する場合(例:Accountに関連するTaskを作成する場合)
事前入力値 (任意)
クイックアクションのフォームが開く前にフィールドを自動的に入力できるようにし、ユーザーの手間を省きデータの一貫性を確保します。
各事前入力値について:
フィールドAPI名: 事前入力したいクイックアクション内のフィールドのAPI名(例:
Subject,Status,Priority)値: 入力したい内容 - 以下のいずれかが可能です:
静的な値(例:「Follow-up Call」)
コンポーネントからの動的な値(例:
{!accountName.value})リソース変数(例:
{!selectedStatus})
利用例:
タスクのSubjectフィールドを「Follow-up: 」+アカウント名で事前入力する
新規ケースのStatusを「New」に設定する
Related Toフィールドに現在のアカウントIDを入力する
優先度を緊急アクション用に「High」にデフォルト設定する
トラブルシューティング
クイックアクションが開かない
クイックアクションのAPI名が正しいか(大文字小文字を区別)確認してください
クイックアクションが組織内に存在し、有効になっていることを確認してください
正しい形式を使用していることを確認してください(オブジェクト固有は Object.Action、グローバルはActionのみ)
ユーザーがクイックアクションにアクセスする権限を持っていることを確認してください
「Quick Action not found」エラー
設定でAPI名を再確認してください
オブジェクト固有のアクションにはオブジェクト名を含めていることを確認してください(例:
Contact.SendEmail)グローバルアクションの場合はオブジェクト接頭辞を含めていないことを確認してください
レコードIDが正しく渡らない
データテーブルのAPI名が式で使用したものと一致しているか確認してください
テーブルで実際に行が選択されているか確認してください
正しい属性を使用してください(
.selectedRowsKeyValue(単一選択の場合))
事前入力値が表示されない
フィールドAPI名がクイックアクションのフィールド名と完全に一致しているか確認してください
フィールドがクイックアクションのレイアウトに実際に含まれているか確認してください
値の式が有効で正しいデータ型を返していることを確認してください
ユーザーがクイックアクション送信時にエラーを見る
これは通常、設定の問題ではなくSalesforceのバリデーションエラーです
Salesforceのバリデーションルールと必須フィールドを確認してください
事前入力値がフィールド要件を満たしていることを確認してください
さらにサポートが必要ですか?
特定のユースケースでのクイックアクションインタラクションの実装について質問がある場合、またはクイックアクションの設定で問題が発生した場合は、 お気軽にお問い合わせください。Avonniコンポーネントで効率的なワークフローを作成するお手伝いをいたします
最終更新
役に立ちましたか?
