Force.com Apex コード開発者ガイド
j
No Results
Search Tips:
- Please consider misspellings
- Try different search keywords
ConnectApi.ActionLinkDefinitionInput クラス
アクションリンクの定義。アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを別の Web ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。
使用方法
コンテキスト変数は、actionUrl、headers、および requestBody プロパティで使用できます。コンテキスト変数を使用して、アクションリンクを実行したユーザに関する情報をサーバ側のコードに渡すことができます。アクションリンクが実行されたときに、Salesforce によって値が代入されます。
使用可能なコンテキスト変数は次のとおりです。
| コンテキスト変数 | 説明 |
|---|---|
| {!actionLinkId} | ユーザが実行したアクションリンクの ID。 |
| {!actionLinkGroupId} | ユーザが実行したアクションリンクが含まれるアクションリンクグループの ID。 |
| {!communityId} | ユーザがアクションリンクを実行したコミュニティの ID。内部組織の場合、値は空のキー "000000000000000000" になります。 |
| {!communityUrl} | ユーザがアクションリンクを実行したコミュニティの URL。内部組織の場合、値は空の文字列 "" になります。 |
| {!orgId} | ユーザがアクションリンクを実行した組織の ID。 |
| {!userId} | アクションリンクを実行したユーザの ID。 |
| プロパティ | 型 | 説明 | 必須項目/省略可能 | 使用可能なバージョン |
|---|---|---|---|---|
| actionType | ConnectApi.ActionLinkType | アクションリンクの種別を定義します。値は次のとおりです。
ユーザがアクションを実行する前にページを読み込む必要がある場合、Ui を使用します。たとえば、アクションの実行前にユーザが入力を行う場合やユーザに情報を表示したりする場合などです。 |
必須項目 アクションリンクテンプレートに定義できます。 |
33.0 |
| actionUrl | String | アクションリンクの URL。たとえば、Ui アクションリンクの場合、URL は Web ページなどになります。Download アクションリンクの場合、URL は、ダウンロードするファイルへのリンクになります。Ui および Download アクションリンク URL がクライアントに提供されます。Api または ApiAsync アクションリンクの場合、URL は REST リソースなどになります。Api および ApiAsync アクションリンク URL はクライアントに提供されません。Salesforce へのリンクは、相対リンクにすることができます。他のすべてのリンクは、https:// で始まる絶対リンクにする必要があります。 | 必須項目 アクションリンクテンプレートに定義できます。 |
33.0 |
| excludedUserId | String | アクションの実行から除外する単一ユーザの ID。excludedUserId を指定した場合、userId を指定できません。 | 省略可能 [ユーザ表示設定] および [カスタムユーザ(別名)] 項目を使用してアクションリンクテンプレートに定義できます。 |
33.0 |
| groupDefault | Boolean | このアクションがアクションリンクグループのデフォルトアクションリンクである場合は true、それ以外の場合は false。各アクションリンクグループに含めることができるデフォルトアクションリンクは 1 つだけです。Salesforce UI では、デフォルトアクションリンクには区別しやすいスタイルが適用されます。 | 省略可能 アクションリンクテンプレートに定義できます。 |
33.0 |
| headers | List<ConnectApi.RequestHeaderInput> | Api および ApiAsync アクションリンク種別の要求ヘッダー。 アクションリンクの概要、認証、およびセキュリティを参照してください。 |
省略可能 アクションリンクテンプレートに定義できます。 |
33.0 |
| labelKey | String | ユーザインターフェースに表示される表示ラベルのセットのキー。セットには、新規、待機中、成功、失敗の状態の表示ラベルが含まれます。たとえば、Approve キーを使用する場合、[承認]、[待機中]、[承認済み]、[失敗] の表示ラベルが含まれます。
キーおよび表示ラベルの完全なリストについては、アクションリンクの表示ラベルを参照してください。 |
必須項目 アクションリンクテンプレートに定義できます。 |
33.0 |
| method | ConnectApi.HttpRequestMethod | 次のいずれかの HTTP メソッド。
|
必須項目 アクションリンクテンプレートに定義できます。 |
33.0 |
| requestBody | String | Api アクションリンクのリクエストボディ。 | 省略可能 アクションリンクテンプレートに定義できます。 |
33.0 |
| requiresConfirmation | Boolean | 確認を必要とするアクション (削除など) の場合は true、それ以外の場合は false。 | 必須項目 アクションリンクテンプレートに定義できます。 |
33.0 |
| userId | String | アクションを実行できるユーザの ID。指定しない場合や null の場合、すべてのユーザがアクションを実行できます。userId を指定した場合、excludedUserId を指定できません。 | 省略可能 [ユーザ表示設定] および [カスタムユーザ(別名)] 項目を使用してアクションリンクテンプレートに定義できます。 |
33.0 |