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

Action Link

アクションリンクの状況の情報取得や更新を行います。

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

メモ

この画像には 2 つのアクションリンクがあります。アクションリンクの status と Action Link Definition Input の labelKey の組み合わせにより、UI に表示されるテキストが決まります。この画像では、両方のアクションリンクの status が New です。 UI のアクションリンク

Pam Smith が [確認] をクリックすると、アクションリンク status が Successful に設定され、その結果、この画像のフィード項目が表示されます。 UI の状況メッセージ

さまざまな種別のアクションリンクのさまざまなワークフローで status が次のように設定されます。

Api: Api アクションリンクの Platform Action レスポンスボディには、Action Link Definition Input で指定された actionUrl は含まれていません。アプリケーションから Api アクションリンクを呼び出す場合は、PATCH 要求を実行してリンクを Pending としてマークします。Salesforce により、Action Link Definition Input で指定された actionUrl へのコールアウトが処理されます。Api アクションリンクの場合、Salesforce がサーバから返された HTTP 状況コードに基づいて status を Successful または Failed に設定します。
ApiAsync: ApiAsync アクションリンクの Platform Action レスポンスボディには、Action Link Definition Input で指定された actionUrl は含まれていません。アプリケーションからこのアクションを呼び出す場合は、PATCH 要求を実行してリンクを Pending としてマークします。Salesforce により、Action Link Definition Input で指定された actionUrl へのコールアウトが処理されます。ApiAsync アクションリンクの場合、コールアウトによってサーバでの非同期操作が開始されます。Salesforce により status が Pending に設定されます。ただし、コールでエラー状況コードが返された場合は、status は Failed に設定されます。非同期処理を終了したサーバは、アクションリンクをコールバックし、PATCH を実行してアクションリンクを Successful または Failed に設定します。
Download と Ui: Download および Ui アクションリンクの Platform Action レスポンスボディには、Action Link Definition Input で指定された actionUrl が含まれます。アプリケーションは、そのリンクからユーザにダウンロードや UI アクセスを行わせることができます。アプリケーションがそのリンクの表示を停止する場合は、PATCH 要求を実行して status を Successful に設定します。

次の場合、アクションリンクの status に対する PATCH 要求はできません。

別の status から New に戻す。
最終的な status (Failed または Successful) から New または Pending に変更する。
アクションリンクが属するアクションリンクグループの executionsAllowed プロパティが Unlimited である。

メモ

リソース

1/connect/action-links/actionLinkId

適用開始バージョン

31.0

Chatter が必要かどうか

いいえ

HTTP メソッド

GET、PATCH、HEAD

PATCH のリクエストボディ

ルート XML タグ

<actionLink>

JSON の例

1{  "status" : "Successful"  }

プロパティ

名前	型	説明	必須項目/省略可能	使用可能なバージョン
`status`	String	アクションの現在の実行状況。値は次のとおりです。 `Failed` — アクションリンクの実行に失敗しました。 `New` — アクションリンクの実行の準備が整っています。`Download` および `Ui` アクションリンクでのみ使用できます。 `Pending` — アクションリンクが実行されています。この値を選択すると、`Api` および `ApiAsync` アクションリンクの API コールがトリガされます。 `Successful` — アクションリンクが正常に実行されました。	必須項目	31.0

PATCH の要求パラメータ

名前	型	説明	使用可能なバージョン
`status`	String	値は次のとおりです。 `Failed` — アクションリンクの実行に失敗しました。 `New` — アクションリンクの実行の準備が整っています。`Download` および `Ui` アクションリンクでのみ使用できます。 `Pending` — アクションリンクが実行されています。この値を選択すると、`Api` および `ApiAsync` アクションリンクの API コールがトリガされます。 `Successful` — アクションリンクが正常に実行されました。	31.0

GET または PATCH のレスポンスボディ

Platform Action

PATCH の例

1PATCH /connect/action-links/0AnRR0000004CTS0A2?status=Failed

Chatter REST API 開発者ガイド

No Results

Action Link