テンプレートのアクションリンクを定義し、フィード要素を使用して投稿する
ステップ 1: アクションリンクテンプレートを作成する
ラジオボタンと同様に、アクションリンクはグループ内にネストする必要があります。グループ内のアクションリンクは、グループのプロパティを共有し、相互に排他的です (クリックできるのは、グループ内の 1 つのアクションリンクのみです)。1 つのアクションリンクを定義する場合でも、アクションリンクグループに含める必要があります。アクションリンクテンプレートおよびアクションリンクグループテンプレートでも同様です。
この例では、アクションリンクグループ内の 1 つのアクションリンクを使用します。ユーザーがこのアクションリンクをクリックすると、Connect REST API に対して HTTP POST 要求が実行され、フィード項目が Chatter に投稿されます。[HTTP リクエストボディ] 項目は、新しいフィード項目のテキストなど、[アクション URL] リソースのリクエストボディを保持します。この例では、新しいフィード項目にテキストしか含まれていませんが、添付ファイルやアンケートなどの他の機能やアクションリンクも含めることができます。
- [設定] から、[クイック検索] ボックスに「アクションリンクテンプレート」と入力し、[アクションリンクテンプレート] を選択します。
- 新しいアクションリンクグループテンプレートで次の値を使用します。
項目 値 名前 ドキュメントの例 開発者名 Doc_Example カテゴリ プライマリアクション 実行可 ユーザーごとに 1 回 - 新しいアクションリンクテンプレートで次の���を使用します。
項目 値 アクションリンクグループテンプレート ドキュメントの例 アクションの種類 Api アクション URL /services/data/{!Bindings.ApiVersion}/chatter/feed-elements ユーザー表示設定 全員に表示 HTTP リクエストボディ {"subjectId": "{!Bindings.SubjectId}","feedElementType": "FeedItem","body": {"messageSegments": [{"type": "Text","text": "{!Bindings.Text}"}]}} HTTP のヘッダー Content-Type: application/json 位置 0 表示ラベルキー 投稿 HTTP メソッド POST - アクションリンクグループテンプレートに戻り、[公開済み] を選択します。[保存] をクリックします。
���クションリンクグループテンプレート ID をメモし、ステップ 3 に進みます。
ステップ 2: アクションリンクグループテンプレート ID を取得する
[設定] でアクションリンクグループテンプレートへのアクセス権がある場合は、アクションリンググループテンプレート ID を取得してステップ 3 に進むことができます。
- リソース
-
- HTTP メソッド
- GET
- 要求のパラメーター
- q — SOQL クエリ文字列。
- 要求パラメーターの例
-
- cURL の例
-
- レスポンスボディ
- クエリ結果レコードの配列。
-
ステップ 3: アクションリンクグループをインスタンス化する
- リソース
- /connect/action-link-group-definitions
- HTTP メソッド
- POST
- リクエストボディ
-
Action Link Group Definition Input
この Action Link Group Definition Input リクエストボディには templateBindings プロパティがあり、これは Action Link Template Binding Input リクエストボディのコレクションです。この例では、Action Link Template Binding Input リクエストボディに 3 つのテンプレートバインドがあります。
- リクエストボディの例
-
- cURL を使用した要求の例
-
cURL を使用して要求を実行するには、次のように入力し、Developer Edition インスタンス名および OAuth 情報を置き換えます。
- レスポンスボディ
- Action Link Group Definition
ステップ 4: アクションリンクグループをフィード要素に関連付けて投稿する
- リソース
- /chatter/feed-elements
- HTTP メソッド
- POST
- リクエストボディ
-
Feed Item Input
この Feed Item Input リクエストボディには body プロパティがあり、これは Message Body Input リクエストボディです。この例では、Message Body Input リクエストボディには messageSegments プロパティがあり、これに 1 つの Message Segment Input: Text リクエストボディがあります。
この Feed Item Input リクエストボディには capabilities プロパティもあり、これは Feed Element Capabilities Input リクエストボディです。この例では、Feed Element Capabilities Input リクエストボディには associatedActions プロパティがあり、これは Associated Actions Capability Input リクエストボディです。
- リクエストボディの例
-
ステップ 3 の Action Link Group Definition レスポンスの id からアクションリンクグループ ID を取得します。
- cURL を使用した要求の例
-
cURL を使用して要求を実行するには、次のように入力し、ステップ 2 で返されたアクションリンクグループ ID、Developer Edition インスタンス名、および OAuth 情報を置き換えます。
- レスポンスボディ
- Feed Item