参照関数について -動的なコンテンツの裏側を見る-

参照関数について -動的なコンテンツの裏側を見る- Koh 気ままに勉強会 #105 2025/1/25 (土) 2025/1/25 参照関数について 1

アジェンダ 参照関数について学び、動的なコンテンツに対する理解を深めましょう。 今回学ぶ参照関数はこちらです。 • trigger 関数 • triggerOutputs 関数 • triggerBody 関数 • actions 関数 • outputs 関数 • body 関数 検索 パスによるファイルコンテンツの取得 ファイル コンテンツ ファイルのコンテンツ。 ファイルが作成されたとき (プ... 表示数を増やす (57 件) ID リスト アイテムの ID です。他のリスト関連操作で操作対象のアイテ... タイトル 更新日時 このアイテムが最後に変更された日時です。 更新者 Claims このアイテムを最後に変更したユーザーの内部識別子です。 更新者 DisplayName このアイテムを最後に変更したユーザーの名前です。 更新者 Email このアイテムを最後に変更したユーザーのメールアドレスです。 図：動的なコンテンツ 2025/1/25 参照関数について 2

自己紹介 名前 : Koh 職業 : Power Platform エンジニア 資格 : Power Platform Fundamentals : 応用情報技術者 : 基本情報技術者 ブログ (Zenn) : https://zenn.dev/ksh365 2025/1/25 参照関数について 3

注意事項 • 発表にあたっては正確な情報の提供につとめましたが、発表者は発表内容に関していかなる保証をするものではありません。 • 発表内容は2025年1月時点の情報であり、今後のアップデート後の情報とは異なる場合があります。 • 発表内容は個人の見解に基づくものであり、発表者が所属する組織の公式見解ではありません。 2025/1/25 参照関数について 4

謝辞 この度は発表の機会をいただきありがとうございます。 主催、運営の皆様に感謝申し上げます。 2025/1/25 参照関数について 5

動的なコンテンツの中身 動的なコンテンツにマウスを重ねると．．． 入力 * 完全パス x triggerBody()?[‘{FullPath}’] triggerBody()?[‘{FullPath}’] 2025/1/25 参照関数について 6

始めにトリガー/アクションの入力・出力について復習しましょう
トリガー/アクションの入力・出力は階層構造になっています。
例：「パスによるファイルコンテンツの取得」アクション
出力 未加工の出力を表示する
statusCode
200
headers
{
"Cache-Control": "max-age=0, private",
"Vary": "Origin",
"X-NetworkStatistics": "0,525568,0,137,549,0,115346,67",
"X-SharePointHealthScore": "1",
"X-MS-SPConnector": "1",
"X-SP-SERVERSTATE": "Readonly=0",
"DATASERVICEVERSION": "3.0",
"SPClientServiceRequestDuration": "83",
body
{
"$content-type": "image/png",
"$content":
"iVBORw0KGgoAAAANSUhEUgAAAHYCAYAAABAWIAAAABAHNSVQICAgIfahk1AAAAF96\"
}
パスによるファイルコンテンツの取得
outputs
statusCode
headers
...
$content-type
body
$content
2025/1/25 参照関数について 7

「ファイルが作成されたとき（プロパティのみ）」トリガーの入力/出力 ファイルが作成されたとき(プロパティのみ) name host ... inputs parameters ... headers ... outputs ID body {Name} ... 2025/1/25 参照関数について 8

トリガーの入力・出力を参照するには．．． トリガーの入力・出力を参照するには、次の3つの関数のいずれかを使用します。 • trigger 関数 : trigger() • triggerOutputs 関数 : triggerOutputs() • triggerBody 関数 : triggerBody() 2025/1/25 参照関数について 9

trigger 関数の出力 - ファイルが作成されたとき（プロパティのみ） ファイルが作成されたとき(プロパティのみ) name host ... inputs parameters ... headers ... outputs ID body {Name} ... 2025/1/25 参照関数について 10

triggerOutputs 関数の出力 - ファイルが作成されたとき（プロパティのみ） ファイルが作成されたとき(プロパティのみ) name host ... inputs parameters ... headers ... outputs ID body {Name} ... 2025/1/25 参照関数について 11

triggerBody 関数の出力 - ファイルが作成されたとき（プロパティのみ） ファイルが作成されたとき(プロパティのみ) name host ... inputs parameters ... headers ... outputs ID body {Name} ... 2025/1/25 参照関数について 12

trigger, triggerOutputs, triggerBody の相互関係 outputs の値を参照する trigger().outputs = triggerOutputs() body の値を参照する trigger().outputs.body = triggerOutputs().body = triggerBody() ファイルが作成されたとき(プロパティのみ) name host ... inputs parameters ... headers ... outputs ID body {Name} ... 2025/1/25 参照関数について 13

「パスによるファイルコンテンツの取得」アクションの入社/出力 パスによるファイルコンテンツの取得 name host ... inputs parameters ... statusCode outputs headers ... $content-type body $content 2025/1/25 参照関数について 14

アクションの入力・出力を参照するには．．． アクションの入力・出力を参照するには、次の3つの関数のいずれかを使用します。 • actions 関数 : actions('<actionName>') • outputs 関数 : outputs('<actionName>') • body 関数 : body('<actionName>') 2025/1/25 参照関数について 15

actions 関数の出力 - パスによるファイルコンテンツの取得 パスによるファイルコンテンツの取得 name host ... inputs parameters ... statusCode outputs headers ... $content-type body $content 2025/1/25 参照関数について 16

outputs 関数の出力 - パスによるファイルコンテンツの取得 パスによるファイルコンテンツの取得 name host ... inputs parameters ... statusCode outputs headers ... $content-type body $content 2025/1/25 参照関数について 17

body 関数の出力 - パスによるファイルコンテンツの取得 パスによるファイルコンテンツの取得 name host ... inputs parameters ... statusCode outputs headers ... $content-type body $content 2025/1/25 参照関数について 18

actions, outputs, body の相互関係 outputs の値を参照する actions('<actionName>').outputs = outputs('<actionName>') body の値を参照する actions('<actionName>').outputs.body = outputs('<actionName>').body = body('<actionName>') パスによるファイルコンテンツの取得 name host ... inputs parameters ... statusCode outputs headers ... $content-type body $content 2025/1/25 参照関数について 19

入力・出力の中から特定の値を参照する方法 参照する値のプロパティまでの経路に存在するプロパティを、以下のように上位階層から順番に記述します。 • property1.property3.property6 • ['property1']['property3']['property6'] • ['property1/property3/property6'] property6 の値を参照する property1 property3 property6 property4 property2 property5 2025/1/25 参照関数について 20

(例) トリガーの値の参照方法 - ファイルが作成されたとき（プロパティのみ）
<ファイルが作成されたとき>トリガーの{Name}の値を参照する
outputs
header
ID
body
{Name}
...
• trigger()['outputs']['body']['{Name}']
• triggerOutputs()['body']['{Name}']
• triggerBody()['{Name}']
2025/1/25 参照関数について 21

(例) アクションの値の参照方法 - パスによるファイルコンテンツの取得 <パスによるファイルコンテンツの取得>アクションの $content の値を参照する outputs statusCode header $content-type body $content • actions('パスによるファイル_コンテンツの取得')['outputs']['body']['$content'] • outputs('パスによるファイル_コンテンツの取得') ['body']['$content'] • body('パスによるファイル_コンテンツの取得')['$content'] 2025/1/25 参照関数について 22

(まとめ) 動的なコンテンツと参照関数 完全パス x triggerBody()?[‘{FullPath}’] トリガー/アクション名 フォルダーのパス アイテムが存在するフォルダーへのパスで、相対サイト アドレス... 完全パス アイテムまたはフォルダーまたはファイルの完全パス コンテンツの承認状態 コンテンツの承認状態です。下書き、保留中、承認済み、または... このリスト アイテムのコンテンツの承認に関連付けられているコ... リスト アイテムのモデレーションに関連付けられているコメント チェックアウト先 ドライブ ID MS Graph のドキュメント ライブラリの一意識別子 トリガー/アクションの出力 triggerBody()?[‘{FullPath}’] Copilot で式を作成する 機能 動的なコンテンツ 検索 関数を参照します triggerOutputs() triggerOutputs.outputs の短縮系 triggerBody() triggerOutputs.outputs.body の短縮系 適用 動的なコンテンツから選択しても、参照関数を使用しても値は同じです。 動的なコンテンツの裏側では参照関数が使用されているというお話でした。 2025/1/25 参照関数について 23

(参考) 参照関数を使えばトリガー/アクションの入力を参照することができる <パスによるファイルコンテンツの取得>アクションの dataset の値を参照する inputs host connectionReferenceName operationId parameters dataset path inferContentType 動作なコンテンツでは参照できないトリガー/アクションの入力を参照することができます。 例：パスによるファイルコンテンツの取得アクションの dataset の値を参照する • actions('パスによるファイル_コンテンツの取得')['inputs']['parameters']['dataset'] 2025/1/25 参照関数について 24

おわりに ご清聴ありがとうございました。 2025/1/25 参照関数について 25