20251213_JSON_Dictionaryを活用してPower_Automateフロー作成をちょっとスマートにするお話

JSON Dictionaryを活用して Power Automate フロー作成をちょっとスマートにするお話気ままに勉強会 #131 気ままになんでもLT会～第10回～ 2025/12/13 1

自己紹介 • 名前： • 活動場所わたるふ • ブログ（主な活動場所）ルドルフもわたるふもいろいろあってな https://wataruf.hatenablog.com • こんなひとです • SharePoint Server 2007 からお仕事でMicrosoft 製品に関わる • PowerShell が好き • 公開している登壇資料 https://www.docswell.com/user/wataruf01 • Microsoft Teams が好き • Power Automate が特に好き • マシュマロ（質問を受け付けています） • 活動内容 • 調査・検証したことなどをブログで解説しています • 開発したもの（主にPower Automate のクラウドフロー）をGitHubで公開しています https://marshmallowqa.com/wataruf01?utm_medium=url_text&utm_ source=promotion Microsoft MVP for Business Applications （2023/4～） 2

3.

注意事項 • 解説する内容は私の個人的な見解が含まれています • 内容に明らかな誤りがある場合はご指摘をいただけると助かります 3

4.

背景 2023年5月20日開催の気ままに勉強会で Power Automate におけるJSON Dictionary の活用方法についてお話しました。まずはそのときの登壇内容を振り返りを行います当時の登壇内容を次のスライド以降で説明します 4

5.

2023年5月20日開催の気ままに勉強会登壇内容「Power Automateによる配列操作でハマったこと・解決した方法」当時の表紙スライド 5

6.

主旨再掲(2023年5月20日登壇資料）簡易版 JSON Dictionary という手法をあみだしたらフローの設計・実装の効率がぐっと上がりました 6

7.

フローの基本パターンについて（1/4）再掲(2023年5月20日登壇資料） Power Automate のフローは 1つのトリガーと 1つ以上のアクションで構成されています。トリガーフローの開始条件であるイベント ➢ 「イベント」とはアクションA ユーザー操作、システム処理、または状態の変化自動化された個々の処理アクションB ➢ 例：メール送信、ファイル更新アクションC … 7

8.

フローの基本パターンについて（2/4）再掲(2023年5月20日登壇資料）フローの基本パターンと入出力情報はこうなります・【入力】フローを開始するきっかけなった操作にともなうコンテキスト情報トリガー・【出力】入力情報、および、トリガーの処理の結果として生成された情報中間アクションA ・【入力】トリガーの出力、または先に実行された中間アクションの出力中間アクションB 最終アクション・【出力】アクションの結果として生成された情報・【入力】中間アクションの出力・【出力】このフローの最終的な目的である処理 8

9.

フローの基本パターンについて（3/4）再掲(2023年5月20日登壇資料）「先に実行された処理の出力」が「後続のアクションの入力」になっていることがポイントです。・【入力】フローを開始するきっかけなった操作にともなうコンテキスト情報トリガー・【出力】入力情報、および、トリガーの処理の結果として生成された情報中間アクションA ・【入力】トリガーの出力、または先に実行された中間アクションの出力中間アクションB 最終アクション・【出力】アクションの結果として生成された情報・【入力】中間アクションの出力・【出力】このフローの最終的な目的である処理 9

10.

フローの基本パターンについて（4/4）再掲(2023年5月20日登壇資料）この数珠つなぎの入出力をいかに無駄なくスマートに行うかがフローつくりのポイントですトリガー・【入力】・【出力】中間アクションA 例： • 必要な情報のみを抽出 • データの変換（例：タイムゾーンをUTCから日本時間にする）・【入力】・【出力】例：中間アクションB • 最終アクションの入力として使えるようにデータを整形（例：配列を作成）最終アクション・【入力】・【出力】 10

11.

ここからがハマったことのお話。。そのときの課題再掲(2023年5月20日登壇資料） SharePointサイトのライブラリにアップロードされたファイルに対して権限を自動付与するフローを実現したい使用する権限は既定で存在するすべてのアクセス許可レベルであるさあトリガー、中間アクション、最終アクションをそれぞれどうつくる？ 11

12.

まずは基本パターンのフロー図に当てはめる再掲(2023年5月20日登壇資料）下図の通りになりますトリガー【フローの開始条件】ファイルがアップロードされたとき中間アクションA 中間アクションB そのサイトにあるアクセス許可レベルをすべて取得既定で存在するアクセス許可レベルのIDをそれぞれ取得する最終アクショントリガーの起点となったファイルに権限を設定 12

13.

ポイントになるのは「中間アクション」再掲(2023年5月20日登壇資料）最終アクションの入力情報を提供するアクションの組み方がポイントトリガー【フローの開始条件】ファイルがアップロードされたとき中間アクションA 中間アクションB そのサイトにあるアクセス許可レベルをすべて取得既定で存在するアクセス許可レベルのIDをそれぞれ取得する最終アクショントリガーの起点となったファイルに権限を設定 13

14.

中間アクションにフォーカスして見てみる（1/5) 再掲(2023年5月20日登壇資料）まずは必要なデータの取得中間アクションA そのサイトにあるアクセス許可レベルをすべて取得 HTTP要求でアクセス許可レベルを JSON形式で取得します 14

15.

中間アクションにフォーカスして見てみる（2/5) 再掲(2023年5月20日登壇資料）アクセス許可レベルがJSONで取得できました中間アクションA そのサイトにあるアクセス許可レベルをすべて取得はい。ここまでは何の問題もないです 15

16.

中間アクションにフォーカスして見てみる（3/5) 再掲(2023年5月20日登壇資料）権限付与で使うためにアクセス許可レベルのIDを取得します既定で存在するアクセス許可レベルのIDを中間アクションB それぞれ取得する「アレイのフィルター処理」を使って対象の要素を取得します 16

17.

中間アクションにフォーカスして見てみる（4/5) 再掲(2023年5月20日登壇資料）フィルタ処理で対象のアクセス許可レベルの要素を取得することができます既定で存在するアクセス許可レベルのIDを中間アクションB それぞれ取得する 17

18.

中間アクションにフォーカスして見てみる（5/5) 再掲(2023年5月20日登壇資料）アクセス許可レベルひとつひとつにフィルタのアクションが必要中間アクションB 既定で存在するアクセス許可レベルのIDをそれぞれ取得する権限付与アクションで使用する対象が増減すると ←フィルタのアクションこのアクションの必要個数も変わってしまいます ←フィルタのアクション ←フィルタのアクション ←フィルタのアクション ←フィルタのアクション 18

19.

ハマったポイントとは何か？再掲(2023年5月20日登壇資料）設計・実装に悩まされたポイントはここトリガー最終的に実現したいことつまり、ファイルの権限設定で使用するアクセス許可レベルに中間アクションA 増減があると、、、中間アクションB その入力情報を提供する中間アクションの設計・実装に影響が及んでしまう最終アクションこの依存関係を回避したい 19

20.

それを解決するためにあみだした手法があります再掲(2023年5月20日登壇資料）それが「簡易版 JSON Dictionary」です。 20

21.

「簡易版 JSON Dictionary」とは再掲(2023年5月20日登壇資料） Key-Value形式で情報を検索できる配列をつくる手法です 21

22.

「簡易版 JSON Dictionary」はどうやって使う？再掲(2023年5月20日登壇資料）基本パターンのフロー図に当てはめると下図の通りになりますトリガー【フローの開始条件】ファイルがアップロードされたとき中間アクションA 中間アクションB そのサイトにあるアクセス許可レベルをすべて取得アクセス許可レベルの配列を JSON Dictionary に変換する最終アクショントリガーの起点となったファイルに権限を設定 22

23.

「簡易版 JSON Dictionary」はどうやって使う？再掲(2023年5月20日登壇資料）基本パターンのフロー図に当てはめると下図の通りになりますトリガー【フローの開始条件】ファイルがアップロードされたとき中間アクションA 中間アクションB そのサイトにあるアクセス許可レベルをすべて取得アクセス許可レベルの配列を JSON Dictionary に変換する最終アクショントリガーの起点となったファイルに権限を設定 23

24.

この手法は様々なフローの作成で活用しています Microsoft Teamsで投稿に「いいね」をしていないひとに対してスケジュール実行でメンションする Microsoft Formsのフォームに回答していないひとに対して自動でメンションする URLのクエリストリングを配列として取得する Power Automate でCSVのデータを配列に変換する再掲(2023年5月20日登壇資料） 1から100まで自然数から「3の倍数」「4の倍数」「3の倍数、かつ、4の倍数」を見つける ExcelテーブルでIDが同じ行の内容欄を結合する ExcelのテーブルをClearCollect関数の実行文に変換する 24

25.

今日の主旨 25

26.

今回のお話 JSON Dictionaryを活用して Power Automate フロー作成をちょっとスマートにするお話 26

27.

そもそもJSONとは JSONとはデータを「名前（キー）」と「値」の組み合わせで表現するデータ形式です。人間が読んでも直観的に理解しやすいシンプルな構造であることが特徴です。例 27

28.

次に、Dictionaryとは DictionaryもJSONとおなじく、データを「キー（名前）」と「値」の組み合わせで扱う考え方です。 JSONが「データをどう書くか」という表現形式を指すのに対し、Dictionaryは「キーを指定して値を取り出す」ことを目的としたデータの使い方・構造を指します。例 28

29.

つまり、JSON Dictionaryとは「辞書」とは本来、言葉を引くとその意味が1つ決まって返ってくるものです。 JSON Dictionaryも同じ考え方で、名前（キー）を指定すると、対応する値が1つ返るように作られています。つまり、JSON Dictionaryとは「キー（Key)を指定すると対応する値(Value)を取り出せるデータ（辞書）」をJSON形式で表現したものです。例 29

30.

JSON Dictionaryを使うとどう便利なの？ 2つの例題を使って説明します • 例題1：勘定科目を債権債務区分に置き換える • 例題2：自動送信メールにおける本文テンプレートの多言語対応 30

31.

JSON Dictionaryを使うとどう便利なの？ 2つの例題を使って説明します • 例題1：勘定科目を債権債務区分に置き換える • 例題2：自動送信メールにおける本文テンプレートの多言語対応 31

32.

例題1：勘定科目を債権債務区分に置き換える【課題】表「取引先別残高」の列「勘定科目」を別表のルールをもとに列「債権債務区分」に置き換える取引先別残高収支先名勘定科目金額株式会社AAA 売掛金 100 取引先別残高株式会社BBB 買掛金 30 収支先名勘定科目 ⇒ 債権債務区分株式会社CCC 未払金 450 株式会社AAA 売掛金 ⇒ 債権 100 株式会社DDD 売掛金 600 株式会社BBB 買掛金 ⇒ 債務 30 株式会社CCC 未払金 ⇒ 債務 450 株式会社DDD 売掛金 ⇒ 債権 600 【別表】勘定科目ごとの債権債務区分勘定科目債権債務区分売掛金債権未収入金債権買掛金債務未払金債務金額 32

33.

例題1：勘定科目を債権債務区分に置き換える条件：２つの表をそれぞれSharePointリストにする取引先別残高収支先名勘定科目金額株式会社AAA 売掛金 100 株式会社BBB 買掛金 30 株式会社CCC 未払金 450 株式会社DDD 売掛金 600 SharePointリストで表す【別表】勘定科目ごとの債権債務区分勘定科目債権債務区分売掛金債権未収入金債権買掛金債務未払金債務 SharePointリストで表す 33

34.

例題1：勘定科目を債権債務区分に置き換える条件：それぞれの表にあるアイテムを「複数の項目」で取得する 34

35.

例題1：勘定科目を債権債務区分に置き換える【課題】下図の出力を得るには最低限どんなアクションを追加ればよいか出力必要なだけアクションを追加する（複数の場合あり）最後はこのアクション！ 35

36.

例題1：勘定科目を債権債務区分に置き換える正解：「選択」アクションと「作成」アクションだけで実現できます 36

37.

例題1：勘定科目を債権債務区分に置き換える出力ここでJSON Dictionaryを作ります 37

38.

例題1：勘定科目を債権債務区分に置き換えるここでJSON Dictionaryを使います ※詳しくは次スライドでお見せします出力 38

39.

例題1：勘定科目を債権債務区分に置き換える処理後の「取引先別残高」入力情報は「取引別残高」のアイテム一覧＝収支先名勘定科目 ⇒ 債権債務区分金額株式会社AAA 売掛金 ⇒ 債権 100 株式会社BBB 買掛金 ⇒ 債務 30 株式会社CCC 未払金 ⇒ 債務 450 株式会社DDD 売掛金 ⇒ 債権 600 item()?['AccountTitle’]] outputs('作成:勘定科目を債権債務区分に変換-JSON_Dictionary')?[ ＝ JSON Dictionaryで勘定科目（AccountTitle）というKeyを指定して債権債務区分というValueを取得します例題1 完了 39

40.

JSON Dictionaryを使うとどう便利なの？ 2つの例題を使って説明します • 例題1：勘定科目を債権債務区分に置き換える • 例題2：自動送信メールにおける本文テンプレートの多言語対応 40

41.

例題2：自動送信メールにおける本文テンプレートの多言語対応【課題】選択された言語の本文テンプレートを使ってメールを送信する日本語ver 英語ver 41

42.

例題2：自動送信メールにおける本文テンプレートの多言語対応【課題】テンプレートで満たすべき要件は下記の4つ日本語ver ① 件名が、指定された言語であること ③ 宛名をいれること ② 本文が、指定された言語であること英語ver ④ 回答フォームURLを指定できること 42

43.

例題2：自動送信メールにおける本文テンプレートの多言語対応【条件】下記の通りメールの件名・本文・回答フォームURLを定義したSharePointリストを用意する（JSON Dicitionary の元ネタ用） 43

44.

例題2：自動送信メールにおける本文テンプレートの多言語対応【条件】下記の通りJSON Dictionary とSharePointリストの1件分の情報を取得します出力出力 44

45.

例題2：自動送信メールにおける本文テンプレートの多言語対応【課題】要件をすべて満たすメールを送信するためには最低限どんなアクションを追加ればよいか日本語ver 出力必要なだけアクションを追加する（複数の場合あり）最後はこのアクション！ 45

46.

例題2：自動送信メールにおける本文テンプレートの多言語対応回答：「メールの送信」アクションだけで実現できます 46

47.

[beta]

例題2：自動送信メールにおける本文テンプレートの多言語対応
▼宛先
outputs('作成:台帳の1件目')?['メールアドレス']

▼件名
outputs('作成-SystemSettings-JSON_Dictionary')?[concat('情報提供依頼メール_件名_',
outputs('作成:台帳の1件目')?['言語'])]

▼本文
replace(
replace(
replace(
outputs('作成-SystemSettings-JSON_Dictionary')?[
concat(
'情報提供依頼メール_本文_',
outputs('作成:1件目')?['言語']
)
],
'{% 本人氏名 %}',
outputs('作成:1件目')?['本人氏名']
),
'{% 回答フォームURL %}',
concat(
'<a href="',
outputs('作成-SystemSettings-JSON_Dictionary')?['情報提供依頼_回答フォームURL'],
'">',
outputs('作成-SystemSettings-JSON_Dictionary')?['情報提供依頼_回答フォームURL'],
'</a>'
)
),
decodeUriComponent('%0A'),
'<br/>'
)

47

48.

[beta]

例題2：自動送信メールにおける本文テンプレートの多言語対応
▼宛先
outputs('作成:台帳の1件目')?['メールアドレス']

▼件名
outputs('作成-SystemSettings-JSON_Dictionary')?[concat('情報提供依頼メール_件名_',
outputs('作成:台帳の1件目')?['言語'])]

▼本文
replace(
replace(
replace(
outputs('作成-SystemSettings-JSON_Dictionary')?[
concat(
'情報提供依頼メール_本文_',
outputs('作成:1件目')?['言語']
)
],
'{% 本人氏名 %}',
outputs('作成:1件目')?['本人氏名']
),
'{% 回答フォームURL %}',
concat(
'<a href="',
outputs('作成-SystemSettings-JSON_Dictionary')?['情報提供依頼_回答フォームURL'],
'">',
outputs('作成-SystemSettings-JSON_Dictionary')?['情報提供依頼_回答フォームURL'],
'</a>'
)
),
decodeUriComponent('%0A'),
'<br/>'
)

余談ですが・・・

ここまで複雑な式は
可読性とメンテナンス性を
考慮した方法に
置き換えることを推奨します。

例題2 完了

48

49.

つまりJSON Dictionaryの便利さとは • 「何らかの値」を「別の値に置き換える」という処理を簡単に行うことができる（繰り返し処理を省略できるケースが多い） • 置き換えのマッピング表に変更があった場合でも JSON Dictionaryの作成処理は何も手を加えなくてOK 49

50.

JSON Dictionaryの使いどころ例題2で解説したSystemSettingsリストはフローの用途に限らず活用できる方法なのでおすすめします。（※下図は活用例です）フローフロー子フローとして使用 System Settingsリストに子フローとして使用登録されているアイテム一覧を JSON Dictionaryに変換するフロー参照フロー子フローとして使用フローの設定値を定義しているSharePointリスト (System Settings） 50

51.

JSON Dictionary の作り方（1/4）：選択アクションアクセス許可レベルのJSONを「選択」アクションを使って下記のKeyとValueを持つ配列に配列に変換します例 • Keyとして使いたい列・・・「SettingKey」列 • Valueとして使いたい列・・・「SettingValue」列 51

52.

JSON Dictionary の作り方（2/4）：選択アクション選択アクションの出力は下図の通りです。この構成ではまだ KeyでValueを取得することができませんもうひと手間を加えます 52

53.

JSON Dictionary の作り方（3/4）：式を使って変換選択アクションの出力を Dictionary 形式に変換する手順 ①string 関数 json( replace( substring( string( body('選択-Key（Settingkey）とValue（SettingValue）の配列を作成') ), 1, sub( length( string( body('選択-Key（Settingkey）とValue（SettingValue）の配列を作成') ) ), 2 ) ), '},{', ※2023年5月20日開催 ',' 気ままに勉強会で解説した式を ) 改良しました ) 選択アクションの出力（JSON 配列）を文字列に変換する ②substring 関数先頭の [ と末尾の ] を削除する ③replace 関数 },{ を , に置き換え、複数オブジェクトを1つにまとめる ④json 関数整形した文字列を JSON に再変換し、 Dictionary として扱えるようにする 53

54.

JSON Dictionary の作り方（4/4）：完成これで完成ですこれなら KeyでValueを検索できます 54

55.

解説は以上です今後ブログでより詳しい内容を掲載する予定です。 55

56.

Power AutomateのフローやTIPSをブログで公開しています • 興味を持っていただけたかたは下記のURLからいらしてください https://wataruf.hatenablog.com 56