背景
最低限一つの Trigger と Action から構成されるフローですが
Trigger/Action 関連の関数ってあまり馴染みがないので、初めての人に教える為にちょっと整理
概要
基本、以下を知ってれば大丈夫
- body
- triggerOutputs
慣れてきて設定値再利用したい！とかになったら以下も
- actions
- trigger
関連関数一覧
| Name | 説明 | 補足 | 主観 |
|---|---|---|---|
| action | 実行時に現在のアクションの出力を返すか、または他の JSON の名前と値のペアの値を返します。 actions もご覧ください。 | 一定の条件下なので通常は使わない | |
| actionBody | 実行時のアクションの body 出力を返します。 body もご覧ください。 | body と同一。長いし body 使うから使わなくても | |
| actionOutputs | 実行時のアクションの出力を返します。 outputs と actions を参照してください。 |
outputs() を使う。すでに使えない？
|
|
| actions | 実行時にアクションの出力を返すか、または他の JSON の名前と値のペアの値を返します。 action もご覧ください。 | アクション自体の Name, Inputs, Outputs を保持。 引数を動的に使いまわす時は、inputs/parameters を使う outputs/status とかはもう使わないかな？ |
推奨 |
| body | 実行時のアクションの body 出力を返します。 actionBody もご覧ください。 | Action の実行結果部分があるので一番使うんじゃないかな、と。actions/body から利用してもいいけど | 必須 |
| formDataMultiValues | form-data または form-encoded アクション出力内のキー名と一致する値を含む配列を作成します。 | ||
| formDataValue | アクションの form-data 出力または form-encoded 出力内のキー名と一致する単一の値を返します。 | ||
| multipartBody | 複数の部分を持つアクションの出力の特定の部分に対する本文を返します。 | ||
| outputs | 実行時のアクションの出力を返します。 | body + header 的なもの。あまり使う機会はないけど、API の結果とかみたい場合には使うかも | |
| parameters | ワークフローの定義で記述されているパラメーターの値を返します。 | $connections 取れるけど・・使い道が思いつかない | |
| trigger | 実行時に、または他の JSON の名前と値のペアから、トリガーの出力を返します。 triggerOutputs および triggerBody もご覧ください。 | トリガーの設定再利用とかに利用可能 | 推奨 |
| triggerBody | 実行時にトリガーの body 出力を返します。 trigger をご覧ください。 | ||
| triggerFormDataValue | form-data または form-encoded トリガー出力のキー名と一致する単一の値を返します。 | ||
| triggerMultipartBody | トリガーの複数部分からなる出力内の特定の部分の本文を返します。 | ||
| triggerFormDataMultiValues | form-data または form-encoded トリガー出力内のキー名と一致する値を含む配列を作成します。 | ||
| triggerOutputs | 実行時のトリガーの出力を返すか、または他の JSON の名前と値のペアの値を返します。 trigger をご覧ください。 | トリガーの結果概要とかがあるのでまずはこっからアクションへ | 必須 |
| workflow | 実行時にワークフロー自体に関するすべての詳細を返します。 | フロー名称とか現在環境情報とか取れる |
取得例とか
どんな感じで取れるか見ることで、イメージが沸いて、ああこれだけ知っておけばいいのねって理解の助けへ
Body vs Outputs vs Actions
通常は以下ぐらい
- 結果取得に Body() を
- 設定値再利用で Actions() を
Actionsでの取得例
actions('Post_adaptive_card_and_wait_for_a_response')?.outputs.body.submitActionId
Actions paramters の利用例
actions('Post_adaptive_card_in_a_chat_or_channel_2').inputs.parameters.folderId
TriggerBody vs TriggerOutputs vs Trigger
Actions と似たような感じ。
- トリガーの情報取得に triggerBody or triggerOutputs() を
- トリガーの設定再利用に trigger() を
Trigger()での取得例（Teamsの新しい投稿Triggerでの場合）
trigger().inputs.parameters.groupId
parameters
$connections を取得した例。他に取れるものは不明
workflow
自フロー自体の情報取得
あとがき
初心者ってより、中級者向けかも・・ 
参考
keyword
4 functions for Trigger/Actions you should know: triggerOutputs, body, trigger and actions