この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

ActionLinkTemplate

アクションリンクテンプレートを使用すると、アクションリンク定義を再利用して、アクションリンクをパッケージ化および配布することができます。アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを別の Web ページに移動したり、ファイルダウンロードを開始したり、外部サーバまたは Salesforce への API コールを呼び出したりできます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合できます。すべてのアクションリンクテンプレートは、アクションリンクグループテンプレートに属します。アクションリンクグループがテンプレートに基づいて作成された場合、アクションリンクはそのアクションリンクテンプレートに基づいて作成されます。グループ内に同じアクションリンクを含めることはできません。このオブジェクトは、API バージョ��� 33.0 以降で使用できます。

サポートされているコール

create()delete()describeLayout()describeSObjects()query()retrieve()update()upsert()

特別なアクセスルール

「アプリケーションのカスタマイズ」権限を持つユーザのみがこのオブジェクトを変更または削除できます。

項目

項目名 詳細
ActionLinkGroupTemplateId
reference
プロパティ
CreateFilterGroupSort
説明
このアクションリンクテンプレートが関連付けられている ActionLinkGroupTemplate のID。
ActionUrl
textarea
プロパティ
CreateUpdate
説明
アクションリンクの URL。たとえば、Ui アクションリンクの場合、URL は Web ページなどになります。Download アクションリンクの場合、URL は、ダウンロードするファイルへのリンクになります。Ui および Download アクションリンク URL がクライアントに提供されます。Api または ApiAsync アクションリンクの場合、URL は REST リソースなどになります。Api および ApiAsync アクションリンク URL はクライアントに提供されません。

Salesforce サーバでホストされるリソースへのリンクは、 / で開始する相対リンクにすることができます。他のすべてのリンクは、https:// で始まる絶対リンクにする必要があります。この項目には、コンテキスト変数とバインド変数を {!Bindings.key} 形式で含めることができます (https://www.example.com/{!Bindings.itemId} など)。バインド変数の値は、テンプレートからアクションリンクグループをインスタンス化するときに設定します。

Headers
textarea
プロパティ
CreateNillableUpdate
説明
対応するアクションリンクが呼び出されときに送信される HTTP ヘッダーのテンプレート。この項目は、Api および ApiAsync アクションリンクでのみ使用できます。この項目には、コンテキスト変数とバインド変数を {!Bindings.key} 形式で含めることができます。
IsConfirmationRequired
boolean
プロパティ
CreateDefaulted on createFilterGroupSortUpdate
説明
true の場合、アクションの実行前に確認ダイアログが表示されます。
IsGroupDefault
boolean
プロパティ
CreateDefaulted on createFilterGroupSortUpdate
説明
true の場合、このテンプレートから派生するアクションリンクが、そのアクショングループのデフォルトアクションまたはプライマリアクションになります。各アクショングループに含めることができるデフォルトアクションは 1 つのみです。
LabelKey
string
プロパティ
CreateFilterGroupSortUpdate
説明
新規、待機中、成功、失敗の状態を示す表示ラベルのセットのキー。たとえば、[承認] セットには、[承認]、[待機中]、[承認済み]、[失敗] の表示ラベルが含まれます。キーおよび表示ラベルの完全なリストは、『Chatter REST API 開発者ガイド』の「アクションリンクの表示ラベル」を参照してください。
LinkType
picklist
プロパティ
CreateFilterGroupRestricted picklistSortUpdate
説明
アクションリンクの種別。次のいずれかの値にします。
  • Api — アクションリンクは、アクション URL で同期 API をコールします。Salesforce は、サーバから返された HTTP 状況コードに基づいて状況を SuccessfulStatus または FailedStatus に設定します。
  • ApiAsync — アクションリンクは、アクション URL で非同期 API をコールします。アクションは、非同期操作の完了時にサードパーティが /connect/action-links/actionLinkId への要求を行って状況を SuccessfulStatus または FailedStatus に設定するまで、PendingStatus 状態のままになります。
  • Download — アクションリンクは、アクション URL からファイルをダウンロードします。
  • Ui — アクションリンクは、アクション URL で Web ページをユーザに表示します。
Method
picklist
プロパティ
CreateFilterGroupRestricted picklistSortUpdate
説明
アクション URL の HTTP メソッド。次のいずれかの値にします。
  • HttpDelete — 成功した場合は HTTP 204 を返します。レスポンスボディまたは出力クラスは空です。
  • HttpGet — 成功した場合は HTTP 200 を返します。
  • HttpHead — 成功した場合は HTTP 200 を返します。レスポンスボディまたは出力クラスは空です。
  • HttpPatch — 成功した場合は HTTP 200 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。
  • HttpPost — 成功した場合は HTTP 201 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。例外は、成功時に HTTP 200 を返すバッチ投稿リソースおよびメソッドです。
  • HttpPut — 成功した場合は HTTP 200 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。

Ui および Download アクションリンクでは、HttpGet を使用する必要があります。

Position
int
プロパティ
CreateFilterGroupSortUpdate
説明
グループ内の他のアクションリンクに関連するアクションリンクテンプレートの位置を指定する整数。0 は最初の位置です。
RequestBody
textarea
プロパティ
CreateNillableUpdate
説明
対応するアクションリンクが呼び出されときに送信される HTTP リクエストボディのテンプレート。この項目は、Api および ApiAsync アクションリンクでのみ使用できます。この項目には、コンテキスト変数とバインド変数を {!Bindings.key} 形式で含めることができます。
UserAlias
string
プロパティ
CreateFilterGroupNillableSortUpdate
説明
UserVisibility に対して CustomUser または CustomExcludedUser を選択した場合、これがカスタムユーザの別名になります。テンプレートを使用してアクションリンクグループを作成する場合、カスタムユーザを指定するにはテンプレートバインドで別名を使用します。
UserVisibility
picklist
プロパティ
CreateFilterGroupRestricted picklistSortUpdate
説明
アクションリンクを表示できるユーザ。この値は、アクションリンクグループごとではなく、アクションリンクごとに設定されます。次のいずれかの値にします。
  • Creator — アクションリンクの作成者のみがアクションリンクを表示できます。
  • Everyone — すべてのユーザがアクションリンクを表示できます。
  • EveryoneButCreator — アクションリンクの作成者を除くすべてのユーザがアクションリンクを表示できます。
  • Manager — アクションリンクの作成者のマネージャのみがアクションリンクを表示できます。
  • CustomUser — カスタムユーザのみがアクションリンクを表示できます。
  • CustomExcludedUser — カスタムユーザを除くすべてのユーザがアクションリンクを表示できます。

使用方法

アクションリンクテンプレートでは、バインド変数がサポートされます。バインド変数は、アクションリンクがテンプレートから作成されるときに変数データを取り込めるようにするプレースホルダです。テンプレートにバインド変数を指定し、そのテンプレートからアクションリンクグループをインスタンス化するときに変数の値を設定します。たとえば、API バージョン番号、ユーザ ID、または OAuth トークンにバインド変数を使用します。アクションリンクテンプレートでは、コンテキスト変数もサポートされます。コンテキスト変数は、アクションリンクを実行したユーザとアクションリンクが呼び出されたコンテキストに関する情報をサーバ側のコードに渡すために、Salesforce によって入力されるプレースホルダです。

[設定] でアクションリンクテンプレートを定義し、Apex または Chatter REST APIConnectApi を使用してテンプレートからアクションリンクをインスタンス化し、アクションリンクを含むフィード要素を投稿します。