アクションリンクの使用
アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定の Web ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。
Workflow
次のフィード項目には、[参加] という 1 つの表示アクションリンクを含む 1 つのアクションリンクグループがあります。![フィード項目の [参加] アクションリンク](https://developer.salesforce.com/docs/resources/img/ja-jp/202.0?doc_id=images%2Factionlinks_join.png&folder=apexcode)
フィード要素を使用してアクションリンクを作成および投稿するワークフローは、次のとおりです。
- (省略可能) アクションリンクテンプレートを作成します。
- ConnectApi.ActionLinks.createActionLinkGroupDefinition(communityId, actionLinkGroup) をコールして、少なくとも 1 つのアクションリンクを含むアクションリンクグループを定義します。
- ConnectApi.ChatterFeeds.postFeedElement(communityId, feedElement) をコールしてフィード要素を投稿し、アクションリンクを関連付けます。
アクションリンクを操作するには、次のメソッドを使用します。
| ConnectApi メソッド | タスク |
|---|---|
|
ActionLinks.createActionLinkGroupDefinition(communityId, actionLinkGroup) ActionLinks.deleteActionLinkGroupDefinition(communityId, actionLinkGroupId) ActionLinks.getActionLinkGroupDefinition(communityId, actionLinkGroupId) |
アクションリンクグループ定義を作成します。アクションリンクグループをフィード要素に関連付けるには、まずアクションリンクグループ定義を作成します。次に、関連付けられたアクション機能を含むフィード要素を投稿します。 |
| ChatterFeeds.postFeedElement(communityId, feedElement) | 関連付けられたアクション機能を含むフィード要素を投稿します。1 つのフィード要素に、最大 10 個のアクションリンクグループを関連付けます。 |
| ActionLinks.getActionLink(communityId, actionLinkId) | コンテキストユーザの状態を含む、アクションリンクに関する情報を取得します。 |
| ActionLinks.getActionLinkGroup(communityId, actionLinkGroupId) | コンテキストユーザの状態を含む、アクションリンクグループに関する情報を取得します。 |
| ActionLinks.getActionLinkDiagnosticInfo(communityId, actionLinkId) | アクションリンクが実行されたときに返された診断情報を取得します。診断情報は、アクションリンクにアクセスできるユーザに対してのみ提供されます。 |
| ChatterFeeds.getFeedElementsFromFeed() | 指定されたフィード種別からフィード要素を取得します。フィード要素にアクションリンクが関連付けられている場合、そのフィード要素の関連付けられたアクション機能でアクションリンクデータが返されます。 |