Power Apps カスタムコネクタを使用しないGraph API #2

普段の業務で開発を行う方は、おなじみの開発環境を使って編集することをお勧めしますが、今回はVisual Studio CodeにPac CLIを組み込んで編集環境として利用しますので、その設定手順をご説明します。

Visual Studio Codeの設定

Visual Studio Code(以降VSCodeと呼称）をまだインストールしていない方はこちら(Visual Studio Code 公式)からインストールを行ってください。

拡張機能の追加

コネクタを拡張するには、エクスポートしたパッケージを編集可能なソースとして取り出す機能を備えたPac CLIが必要です。VSCodeでは、Power Platform Toolsという名前の拡張機能で利用できます。以下の手順に従って、VSCodeに追加してください。

1. 左側のアイコン群（初期設定レイアウト時）から、拡張機能のアイコンをクリックするか、ショートカットキー（Ctrl+Shift+X）を使用してMarketplaceを開きます。
2. 検索ボックスに「Power Platform Tools」と入力します。
3. 検索結果から「Power Platform Tools」をインストールします。

Power Platform Tools[PREVIEW]と間違えないよう注意してください。

必須ではありませんが、以下の拡張機能もお勧めします。

• 日本語化ツール（Japanese Language Pack for Visusal Studio Code）
• XML Tools （JSONテキストを読みやすい形式にフォーマットしてくれるツール）

XML Toolsには、XMLスキーマ編集中にタブを閉じるのを忘れた場合などに警告するなど、多くの便利な機能が含まれています。

拡張機能の追加が終わったらVSCodeを再起動します。
以上でVSCodeの準備は完了しました。

先ほど解凍したフォルダをVSCodeで開きます。

フォルダを開くと画像のように1つのフォルダと1つのファイルがあります。

Power Automate Flowを追加した場合はさらに「Microsoft.Flow」というフォルダが存在します。

Microsoft.PowerAppsフォルダを展開すると画像のようになります。
表示されているファイル名は都度変化します。

ここで重要なのは数値フォルダ内にある「GUID-document.msapp」ファイルです

appsフォルダ直下の数値フォルダを右クリックしてターミナルで表示します。

次のコマンドをターミナル上で実行します。

pac canvas unpack --sources '<出力するフォルダのパス>' --msapp '<msappファイル>'

<出力するフォルダのパス>及び<msappファイル>は統合ターミナルのカレントフォルダから見た相対パスも含めて指定します。もちろん絶対パスでの指定も有効です。

実際にunpackを行った結果が↑の画像です。
出力フォルダ>pkgs>wadlの下に「GraphEndPoint_MyProf.xml」という名前のファイルがあります。このファイルはコネクタの本体であり、コネクタを拡張するにはこのファイルを編集します。

HttpRequest Resourceの内容を確認する

今回拡張する対象は[Office365グループ.HttpRequest]メソッドです、HttpRequestメソッドはResouceブロックで定義されています。
Resourcesブロックには、複数のResourceブロックが存在します。その中からHttpRequest Resourceを見つけて展開し、内容を確認してください。

Responseとして「ObjectWithoutType」というサービスが定義されています。このサービスが前回確認したUntypedObjectの正体です。その定義はさらに上部にあるjsonTypesブロック内にあります。

空白になった「jsonTypesブロック」に前回の記事で定義したレスポンススキーマを追加します。

今回は駆け足でコネクタの拡張(改造)を行いました。今回の拡張は、標準コネクタで得られる結果を別の方法で実現したもので、必ずしも必要ではないものでした。しかし、標準コネクタでは解決できない問題、特に重要な「委任問題」を解決するには、これが最も効果的な手段です。複数のカスタムフィールドを持つリストを扱う必要があるアプリ開発には非常に役立つため、積極的に採用することを推奨します。