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

Action Link Definition Input

アクションリンクの定義。アクションリンクは、API、Web ページ、またはファイルを指し示すフィード要素上のインジケータで、Salesforce Chatter フィード UI ではボタンで表されます。アクションリンクには、HTTP メソッドが含まれ、認証用ベアラートークンなどのヘッダー情報を含めることができます。アクションリンクを使用して Salesforce およびサードパーティシステムをフィードに統合します。

アクションリンクは現在、パイロットプログラムを通じて一部のお客様が使用できます。このパイロットプログラムに参加する方法については、salesforce.com にお問い合わせください。パイロットプログラムへの参加には、追加の契約条件が適用される場合があります。パイロットプログラムは変更される可能性があるため、このパイロットプログラムへの参加や、特定の期間にこの機能を有効化することは保証できません。このドキュメント、プレスリリース、または公式声明で参照されている未リリースのサービスまたは機能は、現在利用できず、提供が遅れたり中止されたりする可能性があります。サービスのご購入をご検討中のお客様は、現在利用可能な機能に基づいて購入をご決定ください。

メモ

ルート XML タグ
<actionLinkDefinition>
JSON の例
1{
2   "actionType":"Api",
3   "actionUrl":"/services/data/v32.0/chatter/feed-elements",
4   "groupDefault":"true",
5   "labelKey":"Post",
6   "method":"Post",
7   "requiresConfirmation":"true",
8   "requestBody":"{\"subjectId\": \"me\",\"feedElementType\": \"FeedItem\",\"body\": {\"messageSegments\": [{\"type\": \"Text\",\"text\": \"Testing a post created via an API action link.\"}]}}",
9   "headers":[
10   {
11      "name":"Content-Type", "value":"application/json"
12   }]
13}
プロパ��ィ
名前 説明 必須項目/省略可能 使用可能なバージョン
actionType String アクションリンクの種別を定義します。値は次のとおりです。
  • Api — アクションリンクは同期 API をコールします。
  • ApiAsync — アクションリンクは非同期 API をコールします。
  • Download — アクションリンクはファイルをダウンロードします。
  • Ui — アクションリンクはユーザインターフェースをユーザに表示します。

ユーザがアクションを実行する前にページを読み込む必要がある場合、Ui を使用します。たとえば、アクションの実行前にユーザが入力を行う場合やユーザに情報を表示したりする場合などです。

必須項目 31.0
actionUrl String アクションリンクの URL。たとえば、Ui アクションリンクの場合、URL は Web ページなどになります。Download アクションリンクの場合、URL は、ダウンロードするファイルへのリンクになります。Ui および Download アクションリンク URL がクライアントに提供されます。Api または ApiAsync アクションリンクの場合、URL は REST リソースなどになります。Api および ApiAsync アクションリンク URL はクライアントに提供されません。Salesforce へのリンクは、相対リンクにすることができます。他のすべてのリンクは、https:// で始まる絶対リンクにする必要があります。

API のアップグレードや機能変更が原因の問題を回避するために、actionUrl にはバージョン管理された API を使用することをお勧めします (https://www.example.com/api/v1/exampleResource など)。API がバージョン管理されていない場合、Action Link Group Definition Input の expirationDate プロパティを使用して API のアップグレードや機能変更による問題を避けることができます。

ヒント

必須項目 31.0
excludedUserId String アクションの実行から除外する単一ユーザの ID。excludedUserId を指定した場合、userId を指定できません。 省略可能 31.0
groupDefault Boolean このアクションがアクションリンクグループのデフォルトまたはプライマリアクションリンクである場合は true、それ以外の場合は false。各アクションリンクグループに含めることができるデフォルトアクションリンクは 1 つだけです。 必須項目 31.0
headers Request Header Input[] Api および ApiAsync アクションリンク種別の要求ヘッダー。 省略可能 31.0
labelKey String ユーザインターフェースに表示される表示ラベルのセットのキー。セットには、新規、待機中、成功、失敗の状態の表示ラベルが含まれます。たとえば、Approve キーを使用する場合、[承認]、[待機中]、[承認済み]、[失敗] の表示ラベルが含まれます。

キーおよび表示ラベルの完全なリストについては、アクションリンクの表示ラベルを参照してください。

必須項目 31.0
method String 次のいずれかの HTTP メソッド。
  • Delete — 成功した場合は HTTP 204 を返します。レスポンスボディは空です。
  • Get — 成功した場合は HTTP 200 を返します。
  • Head — 成功した場合は HTTP 200 を返します。レスポンスボディは空です。
  • Patch — 成功した場合は HTTP 200 を返し、レスポンスボディが空の場合は HTTP 204 を返します。
  • Post — 成功した場合は HTTP 201 を返し、レスポンスボディが空の場合は HTTP 204 を返します。例外は、成功時に HTTP 200 を返すバッチ投稿リソースです。
  • Put — 成功した場合は HTTP 200 を返し、レスポンスボディが空の場合は HTTP 204 を返します。
必須項目 31.0
requestBody String Api および ApiAsync アクションリンク種別のリクエストボディ。

requestBody 値の疑問符文字をエスケープする必要があります。

メモ

省略可能 31.0
requires​Confirmation Boolean 確認を必要とするアクション (削除など) の場合は true、それ以外の場合は false 必須項目 31.0
userId String アクションを実行できるユーザの ID。指定しない場合や null の場合、すべてのユーザがアクションを実行できます。userId を指定した場合、excludedUserId を指定できません。 省略可能 31.0