Power Apps ParseJSONの地獄から抜け出す！「ユーザー定義型（UDT）」でAPI連携を劇的にラクにする

Power Appsで外部APIを叩いたり、複雑なJSONデータを扱うとき、

みたいに感じることがよくある。

今回は、そんなPower AppsでのJSON地獄から抜け出せる最強の機能「ユーザー定義型（UDT：User Defined Types）」を使ったアプローチを紹介。

これを使えば、冗長だったコードが劇的にスッキリして、後から見返しても「きれいなコード」を保てるようになるので、ぜひチェックしてみてもらえれば！

※注意：2026年現在、この機能は「試験段階」の機能です。

事前設定

ユーザー定義関数と同様に、ユーザー定義型を使用するには設定の変更が必要。
[設定]→[更新]→[試験段階]→[ユーザー定義型]をONにする。
※設定を変えた後、保存してPower Apps Studioを再起動する必要あり。

ユーザー定義型は、App.Formulas内で定義することができる。

【定義する型名】 := Type({プロパティ1の名前:プロパティ1の型, プロパティ2の名前:プロパティ2の型 ...})

// 例：型「ねこ」を作る場合（名前、年齢、誕生日がプロパティ）
Cat := Type({name:Text, age:Number, birthday:Date});

ちなみにプロパティの型を配列にしたい場合は、[]で配列にする型を囲む。

するとこんな感じで指定した型の配列をプロパティに設定できるようになり（ねこカフェの猫たち）

配列なので、ギャラリーに表示することができる。

基本的な使い方は以上。

ここから「型が定義できると何ができるのか」を解説。

1つ目の使い道は、ParseJSON関数と組み合わて（WebAPIなどから返された）JSONを簡単に解析できるようになること。

※今回、例としてこちらの「郵便番号から住所を検索できるAPI」を利用させていただく。

まずは上記APIを呼び出して、レスポンスをそのまま返すPower Automateを作成、

Power Apps側のボタン押下でこのPower Automateの戻り値を変数に代入する。

このPower Automateから（郵便番号APIから）受け取ったJSONテキストをPower Appsで扱うときを考える。

これまでJSONの中身をキャンバス側で使いたい場合は、画像のようにParseJSONを使って中身を解析する必要があって、このParseJSONを書くのが結構大変だった。

今回ユーザー定義型が追加されたことにより、このようにAPIから受け取るJSONの形式を事前に定義することができるようになって、

この「JSONの定義」とParseJSONを組み合わせると、画像のように簡単にJSONを解析することができる。
※ParseJSONの「第一引数にJSON文字列」「第二引数に定義した型」を指定

型を定義しているので中身に「.」でアクセスできて、使う側の式もシンプル。

今までは「カスタムコネクタの作成」または「Power Automate側でJSONの解析をして応答する」または「Power Apps側でParseJSONを頑張って書く」しかなかったので、とても嬉しい。

続いての使い道は、半構造化データを簡単に扱えるようにすること。

例えば以下のような商品テーブルを使うときを考える。
「名前」や「価格」といった共通の属性は列として持たせればいいんだけど、各商品特有の属性（本であればページ数、音楽であれば再生時間）をどのように定義するか、は結構悩ましい。

「カテゴリごとにテーブルを分ける」とか「Nullを許容して全ての列を追加する（本の再生時間はNull）」とか、解決方法はケースバイケースだけど、解決策の一つとして「列に半構造化データ（JSON）を持たせる」といった方法がある。

この解決策とユーザー定義型は非常に相性が良くて、こんな感じで各カテゴリごとのAttributeを定義してあげることで、

画像のように「各商品特有の属性を使った説明文を作成する」関数を作ることができ、

使う側（ギャラリー側）は、If文不要で説明文を表示することができる。

他にもいろいろと使い道はありそうなので、ユーザー定義関数に並んで今後が楽しみな機能。