JSONの解析の基本【Power Automate】

何かと便利に使えるJSONの解析アクションですが、今回は基本的な使い方をシンプルに記載します。

どういうときに使うの？

フローの中でオブジェクト型のデータを作成し、後のアクションで値を参照したいときに使います。

JSONの解析をしないと、このようにオブジェクト内の値を参照することができません。

NoとかTitleとか指定（参照）したいのに出てきません。

これが、JSONの解析を行うと参照できるようになります。

以下に手順を記します。

簡易ステップ

ざっと以下のような手順です。

・解析したい元のデータ（JSON）を準備する

・実行して出力結果をコピーしておく

・JSONの解析アクションを追加する。

・解析したい元のデータ（JSON）をコンテンツに指定する。

・サンプルから生成にて、コピーして来た実行結果を使用してスキーマを自動生成する。

・完成！

手順詳細

解析したい元のデータ（JSON）を準備する

まずは解析したいJSONを用意します。

これは作成アクションで自分で定義したものだったり、アクションで取得したものを関数等を利用して加工した結果だったりするかと思います。

アクション結果を加工したものの場合、一度実行結果の出力をみたいので、作成アクションに解析したい数式を定義してください。

作成アクションを追加して・・・

自分で定義、もしくは解析したい結果がでる数式を指定します。

（下記はアクション名をわかりやすく変更しています。）

実行して出力結果をコピーしておく

上記の例では不要ですが、数式の結果を解析したい場合、結果がどうなるかよくわかりませんよね。

なので、一度実行して出力結果をコピーしておきます。

実行結果の以下の部分をコピーしておきます。

JSONの解析アクションを追加する

編集に戻って、JSONの解析アクションを追加します。

解析したい元のデータ（JSON）をコンテンツに指定する

コンテンツには先程の作成アクションを指定します。

OnePoint： コンテンツには、オブジェクトや数式をそのまま記載しても大丈夫です。）

サンプルから生成にて、コピーして来た実行結果を使用してスキーマを自動生成する

スキーマは、サンプルから生成します。

先程コピーしておいた出力結果をペーストして、完了を押下します。

すると、スキーマが自動生成されます。

完成！

これで後のアクションで値を指定できるようになりました。

first()で Apply to each ループ回避する【Power Automate】

Power Automate クラウドフロー で SharePoint コネクタの [ 複数の項目の取得 ] アクションを使用したとき、対象が1件のみのユニークなキーで取得した場合でも、Apply to each が自動で作成されてしまいます。

結果は１件だけだとわかっているとき、Apply to each が入ってくるのはうざいです。

解消方法

Apply to each を使わずに最初の１件だけ取得したい、扱いたい場合、first()関数を使用します。

以前の手順から出力を選択 の部分をコピーします。

すると、このようになっています。

@{outputs('複数の項目の取得')?['body/value']}

上記の、@{}の中を利用します。

outputs('複数の項目の取得')?['body/value']

これを、first()の中に入れれば、配列の1つ目の要素を指定する（取得する）ことができます。

first(outputs('複数の項目の取得')?['body/value'])

抜き出すこと自体は作成アクションでもできますが、のちの手順で動的な値を使いたい場合は、JSONの解析アクションが適しています。

適切なスキーマを指定して利用しましょう。

補足

ちなみに、レコードが取得できなかった場合、null が入ってきます。

レコードがない状態で[ JSONの解析 ]に入るとエラーが出てしまうので（書き方によっては回避できるかもですが）値が取得できない可能性がある場合は、条件分岐で null かどうか判定してから処理していきましょう。

Power Apps モデル駆動型のよいところ【初級編】

みなさん Power Apps のモデル駆動型、使ってますか？作ってますか？

コミュニティ界隈ではキャンバスアプリの情報は目につくのですが、そちらと比べるとモデル駆動型の情報は少なく感じます。理由としては、モデル駆動型を利用するには Power Apps のスタンドアロンライセンスが必要だから、うちでは使えないんだよね。という方が多いのかなと思います。

それはまぁ仕方ない。でも、モデル駆動型も含めて Power Apps ですから、やはりモデル駆動型も盛り上がってほしい。ということで、今回はモデル駆動型もいいぞという内容を少しお伝えできればと思います。

Power Apps モデル駆動型とは？

今回の本筋ではないので本当にざっくり言ってしまうんですが、Dataverse をデータソースとした、データ一覧と入力フォームをメイン要素とした Power Apps のアプリケーション構築方法です。もう一つの方法として、 Power Apps キャンバスアプリがあります。

本記事ではモデル駆動型の紹介はしていないので、もし全然わからない方はお調べになってから読まれたほうがいいかもしれません。

モデル駆動型を利用する前提条件

モデル駆動型を利用するには、Power Apps のスタンドアロンライセンスが必要です。

・Power Apps per user

・Power Apps per app

・従量課金

などです。

ただ、お試しで実験したいということであれば、Power Apps の開発者プランというもので試してみることができますし、試用版ライセンスでもお試しすることができます。

Power Apps 開発者向けプラン | Microsoft Power Apps

また、作成するアプリのデータソースは Dataverse である必要があります。

こんな人にはモデル駆動型がおすすめ

キャンバスアプリでアプリを作ってみたい方、作ってみた方の中には以下のような悩みをお持ちの方も多いと思います。

・アプリを自分で作るなんて不安。

・覚えることが多くて難しい。

・どのようにアプリを構成すればいいのかわからない。

・デザインセンスがなくてUIをどうすればいいかわからない。

・不具合がないか心配。テストもどうすればいいかわからない。

こういった方には、モデル駆動型を利用することでのメリットを感じられるはずです。

モデル駆動型のメリット（初級編）

基本機能だけでも、以下のようなメリットを享受することができます。本当はほかにも山ほどいいことがありますが、それはまた今度で。

メーカー目線のメリット

・入力フォームとデータ一覧の項目の設定するだけで、アプリが自動生成される。

・ノーコードで作成でき、覚えることがキャンバスと比較して少ない。

・コントロールのプロパティや関数を使った数式の実装方法の理解等が不要。

・画面設計、デザインがほぼ不要。

・エラーや不具合なく構築できる。

ユーザー目線のメリット

・統一されたUI/UXで使いやすい。

・エラーや不具合がなくスムーズに業務を進められる。

・レスポンシブでPC、スマホ対応。

モデル駆動型はデータの一覧であるビューと、データの登録及び編集を行うフォームで構成されるアプリを作るのに適しています。逆に、そういった構成にできないアプリは作ることができません。※

とはいえ、多くのビジネスアプリケーションはビューとフォームで構成されているはずです。キャンバスでもモデル駆動型でも作成が可能な場合は、モデル駆動型での構築を強くお勧めします。

※キャンバスアプリをモデル駆動型に埋め込むことで一応実現可能です。

どんなときにモデル駆動型が使える？

以下のようなときには、モデル駆動型アプリが適しています。

・データ一覧と入力フォームで構成できるアプリを作成するとき

・キャンバスかモデル駆動型か迷ったとき

・多数のテーブルを持った大きなソリューションが必要なとき

逆に以下のようなときには、キャンバスアプリが適しています。

・自由なUIで作りたいとき

・外部データソースと接続するとき

・データ接続がないとき

・１つか２つのボタン操作のみのシンプルな構成のとき

・入力フォームとデータ一覧以外の要素で構成するとき

・明確にキャンバスアプリを採用する理由があるとき

まとめ

どこまでを目指すかにもよりますし、用途は多少限定されてしまいますが、モデル駆動型もキャンバスに負けず劣らず手軽に始めることができます。

もし興味が出てきたら、一度触ってみて、是非その良さを感じてもらえれば幸いです。

そのうちさらに高度な利用とメリットについても書いてみる予定です。

Dataverse サービス保護のAPI制限について

市民開発者の方へ

今回の内容は主にプロ開発者向けの内容です。市民開発者レベルの利用用途ではまず発生しないと思われますので、ご安心ください。もしそれっぽいことが発生したら、お近くのプロ開発者に相談してみましょう。

権利の制限とサービス保護のAPI制限について

よく Power Platform の利用可能な制限について話題に上がるのは、24時間で要求可能な Power Platform 要求の数についてかとおもいます。こちらは、ライセンスごとに付与された権利の制限になります。

API 制限の概要 (Microsoft Dataverse) - Power Apps | Microsoft Learn

今回話題に挙げているのは権利の制限とは異なるもので、ライセンスを買えば解決！というような類のものではありません。

サービス保護のAPI制限と呼ばれるもので、文字通り一部のユーザーによる異常なリクエストを制御し、全体の利用を妨げないようにするための制限となっています。

API 制限の概要 (Microsoft Dataverse) - Power Apps | Microsoft Learn

制限があることによって不便に感じるかもしれませんが、この制限がないと、例えば１人のユーザーによる異常なリクエストによって、テナントの Dataverse の負荷が過剰に上がってしまい、最終的にテナント全体が停止する、なんてことになってしまうかもしれません。

この制限があることによって、多くのユーザーが快適にサービスを利用できるようにしているわけです。ありがたや。

サービス保護のAPI制限ってどんな制限があるの？

サービス保護のAPI制限には、以下の3つがあります。

・５分間の中で要求しすぎると制限される。

・５分間の中で時間のかかる処理を要求しすぎると制限される。

・同時実行の要求をしすぎると制限される。

どの程度要求すると制限されるか数値を出したいところですが、この辺りは環境により異なるようです。ただ、普通にしていればそうそう制限にかかることはないと思われます。のちに記載するページに参考値が記載されていますが、許容値の変動要素としては

・環境に割り当てられたサーバーの数により許容値が変動する

・サーバーの数は購入したライセンス数や、その他の要因で変動する

・試用版環境は１つのサーバーが割り当てられている

・制限の内容は変更される可能性がある

などが記載されています。

注意点としては、検証で利用することの多いであろう試用版環境はWebサーバーの割り当ては１つ固定であることです。実際の運用時と制限内容が異なる可能性があるので、留意しておきましょう。

参考値として、サーバー1台当たりの制限を記載します。

制限項目	サーバ1台当たりの許容値
要求数の制限	6000回 / 5分
実行時間の制限	合計20分かかる処理 / ５分
同時実行数の制限	52の処理まで

※環境のサーバーの数やその他の要因により、制限は変動します。最新の情報は下記のページを参照してください。

サービス保護 API の制限 (Microsoft Dataverse) - Power Apps | Microsoft Learn

制限されるとどうなる？

しばらくの間、新しい要求ができなくなります。制限解除までの時間は429エラーメッセージに含まれていますが、どの程度制限を超過したかにより異なるようです。一般的な対策ではありますが、その時間分待機を挟んで再度要求を投げるように実装しましょう。

また、制限を超過したときに影響を受けるのは、超過したユーザーのみです。他のユーザーには影響しないので、やらかしてしまった場合でもテナント全体への影響は少なそうです。

 

API要求数の制限への対策

バッチを使って一度に複数の処理を要求する

バッチを使うと、最大で1000の操作を1度に要求できます。これにより、API要求数を減らすことが可能です。

※ちなみに、残念ながら権利の制限はバッチで回避できません。

毎月から毎日、毎時、リアルタイム実行へ

ため込んで処理を行うと、1度に多くの処理をしなくてはなりません。なるべくリアルタイムで処理できるのであればリアルタイムで処理するようにしましょう。

UIを持つアプリで発生する場合には、アプリの作りを改善する

リストの表示数を減らしたり、データをキャッシュするなど要求数をなるべく減らすように作り替えることで、回避できるはずです。

実行時間の制限への対策

重いバッチ処理を同時実行しない

そもそも重い処理ということがわかっている場合には、制限を考慮して構築しましょう。

プラグインやリアルタイムワークフローを軽量化したり、データ移行のため一時的に無効化する

1つ1つの処理を軽くすることで、処理時間の低減を図りましょう。

同時実行数の制限への対策

52を超えて同時実行しないようにする

軽い処理であっても、同時実行数を増やしすぎないようにしましょう。10程度から始めて、ほかの要素を加味しながら制限を超えない値を探っていく方法が推奨されています。

まとめ

以上、サービス保護のためのAPI制限についてでした。あまりこの制限に引っかかることはないかもしれませんが、存在だけでも知っておくと何かあった時に気が付きやすいかと思います。

プロ開発者の方は、処理の重いバッチやデータ処理が無造作に実行されないよう気を付けましょう。

今回は実際にエラーを出すとこまで書けなかったので、そのうち実験してみたものを記事にしようと思います。

参考リンク

サービス保護 API の制限 (Microsoft Dataverse) - Power Apps | Microsoft Learn

API 制限の概要 (Microsoft Dataverse) - Power Apps | Microsoft Learn

Web APIを使用したバッチ処理の実行 (Microsoft Dataverse) - Power Apps | Microsoft Learn

この記事は Microsoft Power Automateのカレンダー | Advent Calendar 2022 - Qiita に参加しています。

【ハンズオン】そうだ、Power Apps でブロック崩しを作ろう。

かなり前にブロック崩しを Power Apps で作ってみたんですが、それの作成方法をまとめてみようと思います。（今度コミュニティの方でハンズオンでも出来たらなーとかも思ってたり。）

アプリはゲーム的ですが、楽しみながらPower Apps アプリ作成に役に立つTIPSが学べると思いますので、是非トライしてみてください。

どんなアプリを作るの？

こんな感じのアプリを作ります。

Power Apps でブロック崩し

何の変哲もないブロック崩しですね。

ざっくり作成の流れ

• ボールを動かす
• ボールが壁に反射するようにする
• ボールをバーで跳ね返せるようにする
• ブロックを設置する
• ブロックに当たった時の処理を実装する

以下、作成手順です。

ボールを動かす

まずはボールを設置して、動くようにしてみましょう。

変数初期化用のボタンを設置

ボタンコントロールを追加し、各プロパティを以下の通りに設定しましょう。

コントロール名	ButtonInitBall
Text	InitBall
OnSelect	UpdateContext(     {         locBallPoint: {             X: App.Width/2,             Y: App.Height/2         },         locAcceleration:{             X: 30,             Y: -30             }     } )

OnePoint locBallPoint：ボールのXY座標の情報を保持しておくための変数です。のちの手順でボール用コントロールのXYプロパティに入れ込んでいきます。 locAcceleration：加速度情報の変数です。壁やブロックに当たって反射する際には、-1をかけて反転させています。描画更新のたびに locBallPoint に加算して、ボールを動いているように見せています。

ボタンの配置は適当でいいです。私はこんな感じにしました。

ボール用の円アイコンを設置

続いてボールを設置します。

円アイコンコントロールを追加し、各プロパティを以下の通りに設定しましょう。

コントロール名	Ball
X	locBallPoint.X-(Ball.Width/2)
Y	locBallPoint.Y-(Ball.Height/2)
Width	20
Height	20

こんな感じになっていれば、OKです。

描画更新用のタイマーを設置

さらに、ボールを動かすためにlocBallPoint変数の更新が必要です。なので、短いタイマーを使って描画を更新させようと思います。

タイマーコントロールを追加し、各プロパティを以下の通りに設定しましょう。

コントロール名	Timer
Duration	20
Repeat	true
AutoStart	true
Visible	false
OnTimerStart	//加速度に従いボールが移動する UpdateContext(     {         locBallPoint:{             X:locBallPoint.X+locAcceleration.X,             Y:locBallPoint.Y+locAcceleration.Y         }     } );

これでボールが動くようになりました！ただ、ボールが突き抜けてどこかへ行ってしまいます。

※タイマーを動かすには再生モードにします。編集モードではタイマーが動きませんので注意！

OnePoint ここではボールの位置情報を持っているlocBallPointに加速度情報のlocAccelerationを加算しています。もっと早くしたい場合や遅くしたい場合は、locAccelerationを初期化している箇所の数値をいじってみましょう。 ちなみに、処理速度を上回るほどDurationを短くしても早くはならないようです。

再生モードにして、ボールが動くのを確認出来たら次に進みましょう！

ボールが壁に反射するようにする

天井と左右の壁に当たったら跳ね返す

続いて、ボールが突き抜けていかないように、天井や壁で跳ね返るようにしてみましょう。

先ほど設定した Timer コントロールの OnTimerStart に下記の処理を追加しましょう。

OnTimerStart

//壁当たり判定 天井にあたったら跳ね返る If(locBallPoint.Y<0,UpdateContext({locAcceleration:{X:locAcceleration.X, Y:locAcceleration.Y*-1}})); //壁当たり判定 左の壁にあたったら跳ね返る If(locBallPoint.X<0,UpdateContext({locAcceleration:{X:locAcceleration.X*-1, Y:locAcceleration.Y}})); //壁当たり判定 右の壁にあたったら跳ね返る If(locBallPoint.X>App.Width,UpdateContext({locAcceleration:{X:locAcceleration.X*-1, Y:locAcceleration.Y}}));

これでボールが跳ね返ってくれるようになりました。ただし、画面下に行ってしまうと相変わらずどこかへ行ってしまいます。このままではなすすべがありません。

ボールが壁と天井に反射するのを確認出来たら、次に進みます。

ボールをバーで跳ね返せるようにする

バーと連動させる用のスライダーを設置する

続いて、バーを使ってボールを跳ね返せるようにしましょう。まずは後の手順でバーと連動させるためのスライダーを準備します。

スライダーコントロールを追加し、各プロパティを以下の通りに設定しましょう。

コントロール名	SliderForHitBar
X	0
Y	500
Width	App.Width
Height	200
HandleSize	200
RailThickness	0
ShowValue	False
ValueFill	RGBA(0, 0, 0, 0)
HandleFill	RGBA(0, 0, 0, 0)
BorderStyle	BorderStyle.None
Max	App.Width
Default	App.Width/2

OnePoint Widthには、横幅いっぱいにするためApp.Widthを指定しています。 HandleSizeはつかみやすくするため、200を指定しています。 見えないようにしたいので、５つの項目を設定しています。のちの手順で何をしているかわかりにくいので、後で理解してから設定してもいいかもしれません。 Maxはのちの手順でValueをバーと連動させるため、App.Widthにしています。

上にも書いていますが、非表示にする項目は後で設定してもかまいません。

設定出来たら、次に進みましょう。（スケスケなのでスクショは割愛します。）

跳ね返すバー用の四角形アイコンを設置する

続いて、実際に跳ね返すバーを追加します。先ほどのスライドと連動させていきます。

四角形アイコンコントロールを追加し、各プロパティを以下の通りに設定しましょう。

コントロール名	HitBar
X	SliderForHitBar.Value - (HitBar.Width/2)
Y	650
Width	200
Height	20

OnePoint Xプロパティがキーです。ここで先ほどのスライダーの値と連動させています。 スライダーを動かせば横の位置が連動して動くのが確認できるはずです。

バーにかぶっているとスライダーがつかめないので、スライダーを前面に持ってくるようにしましょう。ツリービューから設定できます。

これでバーを動かすことができるようになりましたね。ただ、これだけではまだボールを跳ね返すことはできません。

バーで跳ね返す処理を追加する

続いて、ボールを跳ね返せるようにしていきましょう。

ボールを跳ね返すようにするには、Timer.OnTimerStartに下記の処理を追加しましょう。

コントロール名	Timer
OnTimerStart	//バーの当たり判定 If(     And(         // ボールのY座標がヒットバーの内側かつ         locBallPoint.Y+(Ball.Height/2)>HitBar.Y && locBallPoint.Y < HitBar.Y+HitBar.Height,         // ボールのX座標がヒットバーの内側のとき         locBallPoint.X>HitBar.X&&locBallPoint.X<HitBar.X+HitBar.Width     ),     // Y加速度を反転してボールを上方へ跳ね返す     UpdateContext({locAcceleration:{X:locAcceleration.X, Y:locAcceleration.Y*-1}}) );

※既存の処理に追加します。既にあった数式を消さないように注意してください。

OnePoint 内容としては、ボールがバーにかぶったら（当たったら）、Y方向の変数に-1をかけて跳ね返すようにしています。

これでバーでボールを跳ね返せるようになります。やっとゲームっぽくなってきた気がしますね。

あとはブロックを設置して、ボールに当たったらブロックが消える処理を実装していけば完成です。

ブロックを設置する

ブロックの情報を準備する用のボタンを設置する

ブロックを設置していきますが、ブロックの情報はコレクションに保持しておこうと思います。

ということで、準備としてコレクションを初期化するためのボタンを作っていきます。

ボタンコントロールを追加し、各プロパティを以下の通りに設定しましょう。

コントロール名	ButtonInitBlocks
Text	InitBlocks
OnSelect	Clear(colBlocks); ForAll(     Sequence(6,0,1) As Y,     ForAll(         Sequence(10,0,1) As X,         Collect(colBlocks,         {             XIndex:X.Value,             YIndex:Y.Value,             Hit:false         })     ) );

OnePoint Sequence()で生成したテーブルにAsで名前を付けています。こうすると、改装になっていても参照できますし、明示的に指定できるのでわかりやすくなりますので個人的におすすめです。

これで、次の手順で使用するコレクションの準備ができました。

作成出来たら、一度ボタンを押してコレクションを生成しておいてくださいね。

ブロック用ギャラリーを設置する

続けて、表示用のギャラリーとその中に四角アイコンを設置していきましょう。

空の垂直ギャラリーコントロールを追加し、各プロパティを以下の通りに設定しましょう。

コントロール名	GalleryBlocks
Items	colBlocks
X	0
Y	0
Width	App.Width
Height	300
WrapCount	10
TemplateSize	44

OnePoint ギャラリーは空にしておいてください。 垂直方向のギャラリーを追加することに注意。