アクションリンクの使用事例

フィードから手順をダウンロードして部品を注文する

架空の 3D プリントショップ「BuildIt」が、アクションリンクを使用して Salesforce に統合される AppExchange アプリケーションを作成したとします。BuildIt の顧客は、このアプリケーションをインストールすると、BuildIt の Web サイトへのアクセス、アカウントの作成、BuildIt に部品を注文できるように特定のユーザーを招待する Salesforce へのアクションリンクを含む投稿の送信を行えます。このサンプルフィード要素は、BuildIt の顧客である Pam Jones からその部下の Jin Chang に投稿されたものです。[ダウンロード] アクションリンクをクリックすると、BuildIt Web サイトから部品情報を含むファイルがダウンロードされます。[注文] アクションリンクをクリックすると、Jin Chang に BuildIt Web サイトのページが表示されて部品を注文できます。

フィードから旅程を承認または却下する

架空の「Travel Example」という会社の開発者として勤務しているとします。「Travel Example for Salesforce」という AppExchange のアプリケーションを作成します。会社 A には「Travel Example for Salesforce」がインストールされています。会社 A の誰かが Travel Example Web サイトにアクセスし、旅程を予約します。Travel Example のサーバー側コードは、会社 A の Salesforce 組織に本文テキスト [Please approve this trip. (この出張を承認してください。)] を含むフィード項目を投稿する Connect REST API 要求を実行します。このフィード項目には、表示ラベル [承認] と [却下] のアクションリンクも含まれます。これらのアクションリンクは、旅程を承認または却下するために Travel Example サーバーの REST リソースに対して HTTP 要求を実行します。

「Travel Example for Salesforce」アプリケーションを作成するため、[設定] でこれらのアクションリンクおよび関連付けられたアクションリンクグループを定義するアクションリンクテンプレートを作成しました。サーバー側コードでは、テンプレートからアクションリンクグループをインスタンス化する Connect REST API 要求を実行します。また、アクションリンクグループをフィード項目に関連付けて投稿する、別の Connect REST API 要求を実行します。

[アクション URL]、[HTTP ヘッダー]、および [HTTP リクエストボディ] テンプレート項目には、コンテキスト変数とバインド変数を含めることができます。

[アクション URL] に {!userId} コンテキスト変数を含めます。これにより、ユーザーがフィードのアクションリンクをクリックしたときに、Salesforce がそのユーザーの ID をサーバー側コードに送信して誰がアクションリンクをクリックしたかを伝えます。アクションリンクでは、定義済みのコンテキスト変数のセットがサポートされています。詳細は、「アクションリンクテンプレートの設計」の「コンテキスト変数の使用」を参照してください。

アクションリンクテンプレートで必要な���インド変数を作成し、今後の変更に対応できる動的なコードにすることができます。詳細は、「アクションリンクテンプレートの設計」の「バインド変数の定義」を参照してください詳細情報。サーバー側コードでは、アクションリンクグループをインスタンス化するときにバインド変数の値を設定します。パッケージを更新することなく新しい API バージョンをリリースできるように、{!Bindings.apiVersion} を使用します。また、アクションリンクをクリックすることでユーザーが作成した旅程を承認または却下できるように、{!Bindings.tripId} も使用します。

アクションリンクが 1 人のユーザーのみに表示されるように、[ユーザー表示設定] 項目を設定します。[カスタムユーザー(別名)] 項目に値を入力します。これは、サーバー側コードがアクションリンクグループをインスタンス化するときに、ユーザーのマネージャーの ID に対して値が設定されるバインド変数でもあります。

[承認] アクションリンク用のアクションリンクテンプレートを次に示します。