---
title: Power AppsをディープにカスタマイズするPower Apps Component Framework！
tags: 
author: [masataka yonei](https://www.docswell.com/user/yone)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/VEP6GW9278.jpg?width=480
description: Japan Power Platform Dev User Group #2 PCFに関する勉強会の資料です。 セッションテーマは「Power Appsをディープにカスタマイズする、Power Apps Component Framework！」 コンポーネントを配置してとっても簡単にさまざまなアプリケーションが構築できるPowerAppsですが、実装したい機能が標準で用意されているコンポーネントではできないケースにぶつかった経験はありませんか？ そんなときの解決に役立つのがPower Apps Component Framework（以下 PCF）です。PCFは、JavaScriptをベースにしたフロントエンド技術を利用したフレームワークで、こちらを利用するとPower Apps上で利用が可能となるUIコンポーネント（コードコンポーネント）の作成が可能になります。 今回は、PCFでコンポーネントを作成する方法と、世に出ているJavaScriptライブラリや帳票ツール「ActiveReports」を利用して作成した、コードコンポーネント例をご紹介いたします。
published: October 05, 24
canonical: https://www.docswell.com/s/yone/5XEPGX-2024-10-05-205941
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/VEP6GW9278.jpg)

Power Appsをディープにカスタマイズする
Power Apps Component Framework！
2024/10/5（土） Japan Power Platform Dev User Group #2
yone@mescius


# Page. 2

![Page Image](https://bcdn.docswell.com/page/27V368MXJQ.jpg)

自己紹介
名前
yone
仕事
プロダクトマーケティング
これまで
at メシウス（旧グレープシティ）
• 業務システム開発(.NET)
• 農業IT研究＋Power Platform
ブログ
• https://devlog.mescius.jp/category/power-apps/
GitHub
• https://github.com/masataka-yonei/PCF/
• Power Platform App Maker
• Power Platform Developer Associate
• Azure AI Engineer Associate
• Azure Developer Associate
• Power Platform Fundamentals
• Azure AI Fundamentals
• Azure Fundamentals
2


# Page. 3

![Page Image](https://bcdn.docswell.com/page/5JG3N5GREL.jpg)

3


# Page. 4

![Page Image](https://bcdn.docswell.com/page/47Q5QZXYEP.jpg)

農業とITの研究プロジェクトをやっていました
4


# Page. 5

![Page Image](https://bcdn.docswell.com/page/KE49N36ZJ1.jpg)

プロジェクトでやりたかったこと
分析
データ管理
経路生成
5


# Page. 6

![Page Image](https://bcdn.docswell.com/page/L71K51VDEG.jpg)

Power Platformで出来るかも？
6


# Page. 7

![Page Image](https://bcdn.docswell.com/page/G7WD58L8E2.jpg)

大枠は完成
コネクタ
7


# Page. 8

![Page Image](https://bcdn.docswell.com/page/4JZGN8M973.jpg)

苦労したところ、出来なかったこと
苦労したところ ： 地図まわりのドラッグドロップ処理
◼ 静的地図（BingMap）＆スライダー・タイマーを利用して
ドラッグドロップ処理実装
◼ 経路生成用の位置座標取得
【参考にさせていただいたブログ】
◆ Power Appsでまだ利用できないドラッグ&amp;ドロップを実装する方法
◆ 地図上でポイントの緯度経度を補正する(Power Apps ＆ BingMaps)
出来なかったこと ： 印刷機能
◼ Print関数がまだなかった…
◼ List形式でデータをQRコードを印刷したかった
8


# Page. 9

![Page Image](https://bcdn.docswell.com/page/YE6Y8PNDJV.jpg)

コンポーネントだけでいろいろ
出来るといいな
9


# Page. 10

![Page Image](https://bcdn.docswell.com/page/GE5G9K58E4.jpg)

1. Power Apps Component Framework とは？
2. PCFでコードコンポーネントを
本日お話しする
内容
つくってみよう
3. JSライブラリを使って機能アップ
4. PCF帳票ビューワと外部Webサーバー
帳票機能を作成
5. まとめ
10


# Page. 11

![Page Image](https://bcdn.docswell.com/page/972Y2WNV7R.jpg)

Power Apps Component Framework とは？
11


# Page. 12

![Page Image](https://bcdn.docswell.com/page/DJYGYLPQJM.jpg)

Power Apps Component Framework
Power Appsをディープにカスタマイズできるツール
12


# Page. 13

![Page Image](https://bcdn.docswell.com/page/V7NGP452E8.jpg)

Power Apps Component Framework とは？
◼ キャンバスアプリ・モデル駆動型アプリで利用可能な
UIコンポーネント（コードコンポーネント）を作成する為のフレームワーク
◼ TypeScript(JavaScript拡張言語）、CSSなどをWebフロントエンド技術を用いて開発すること
が可能
◼ React や Angular などのJSフロントエンドフレームワークをサポート
◼ Power Apps コミュニティによってつくられたコンポーネントがPCF Galleryで公開


# Page. 14

![Page Image](https://bcdn.docswell.com/page/YJ9W3QYDJ3.jpg)

今回扱う内容
Reactコンポーネント
（プレビュー）
キャンバスアプリ
◼ コンポーネントの実装を別ファイルにわけて実装
できるため、より簡単に開発できる
◼ Webフロントエンド開発でUIフレームワークとして
高いシェアがありさまざまなライブラリが用意され
ている
◼ コンポーネントの配置やイベント動作など自由度
が高いキャンバスアプリで解説
14


# Page. 15

![Page Image](https://bcdn.docswell.com/page/GJ8NMG65ED.jpg)

開発に必要なツール
Webフロントエンド開発に必要なツール
＋
Power Platform CLI＆ビルドツール
◼ Visual Studio Code（VSCode）
⚫ コードエディタ（統合開発ツール）
◼ Node.JS （LTS (長期サポート) バージョンのご利用をお勧め）
⚫ バックエンドJavaScript実行環境とJavaScriptパッケージ管理ツール（Npm）
⚫ デバッグ実行や、主にJavaScriptパッケージライブラリのインストールに使用
◼ Power Platform CLI （VSCode拡張機能でのインストールのほか、インストーラーも）
⚫ Power Apps Component Frameworkを利用する為のコマンドラインインターフェイス
⚫ 開発プロジェクトの作成・デバックの他、ソリューションパッケージ化、環境へのアップロードも行える
ツール
◼ .NET ビルド ツール（Visual Studio 2022 用ビルド ツールなど）
⚫ ソリューションパッケージをビルド時に使用
15


# Page. 16

![Page Image](https://bcdn.docswell.com/page/LJLP3G93ER.jpg)

PCFでコードコンポーネントを
つくってみよう
•
•
•
•
•
•
プロジェクトの作成
プロパティの作成
ボタンコンポーネントを追加
イベントの作成
データセットプロパティの追加
環境へのアップ
16


# Page. 17

![Page Image](https://bcdn.docswell.com/page/47M4DQZMEW.jpg)

プロジェクトの作成


# Page. 18

![Page Image](https://bcdn.docswell.com/page/P7RW486LE9.jpg)

プロジェクトの作成 - ディレクトリ作成
まずは、任意のフォルダを作成します。
作成したフォルダ内をVSCodeで開きます。
VSCode開いた後ターミナルを起動しておきます。
18


# Page. 19

![Page Image](https://bcdn.docswell.com/page/PJXP28D6EX.jpg)

プロジェクトの作成 - “pac pcf init” コマンド実行
pcf init
：PCF プロジェクトの作成しディレクトリを初期化
◼ -n(--name)
： コンポーネントの名前
◼ -ns(--name)
： コンポーネントの名前空間
◼ -t(--template)
： コンポーネントのテンプレートを選択します（field or dataset)
◼ -fw(--framework)
： コンポーネントのレンダリング フレームワークを選択します（none or react)
◼ -npm(--run-npm-install ) ： プロジェクト作成後に “npm install” を自動実行します（必要なパッケージをインストール）
• ターミナルでpac コマンド（Power Platform CLIコマンド）の“pcf init”コマンドを実行しPCFプロ
ジェクト作成
19


# Page. 20

![Page Image](https://bcdn.docswell.com/page/3JKDMKXG7D.jpg)

プロジェクトの作成 - プロジェクト完成
• “pcf init”コマンド実行後、プロジェクトが作成され、コンポーネント作成のテンプ
レートとして自動的にファイルが生成
20


# Page. 21

![Page Image](https://bcdn.docswell.com/page/LE3RYZ5575.jpg)

プロジェクトの作成 - ファイルの役割
ControlManifest.Input.xml
（マニフェストファイル）
プロパティ定義・イベント定義・外部リソース（CSSなど）の参照設定を行うファ
イル
index.ts
処理の実装本体（通常テンプレートの場合は、このファイルのみが作成される）
HelloWorld.tsx
コンポーネントの実装部分を分割したファイル（Reactテンプレートのみ作成される）
index.tsから呼び出され使用する
21


# Page. 22

![Page Image](https://bcdn.docswell.com/page/8EDY5RDYEG.jpg)

プロジェクトの作成 - 処理実装の基本
init：コンポーネント インスタンスの初期化 ※必須
コンポーネントのインスタンス時に、コンポーネント内で使用
する各種オブジェクトなどの初期化、事前処理などを行いま
す。
getOutputs：コンポーネントが外部にデータを渡す際の処理
コンポーネント内部で変更された値を、外部のプロパティな
どへ出力する際に使用します。外部出力プロパティを実装し
ている場合は必須となります。
updateView：コンポーネントの見た目や表示内容を更新時処理 ※必須
プロパティ値や、テキスト入力値、データの値などの表示状態が変わ
る際に行う処理です。
destroy：コンポーネントがウェブページから取り除かれる際に行われる
コンポーネントが使用しているリソース（例えば、イベントリス
ナーやタイマーなど）をクリーンナップする際に利用します。
メモリの開放などもこのタイミングで実装します。
22


# Page. 23

![Page Image](https://bcdn.docswell.com/page/V7P6GWX2J8.jpg)

プロジェクトの作成 – プロジェクトのデバック実行
•
•
•
•
初期状態では、HelloWorldを表示するコンポーネントが実装済み
まずはこの状態デバック実行してみます。
デバック実行には、”npm start“で行います
実行すると、PCF コントロールを表示してテストできるように、ブラウザーで コントロール サンドボッ
クスが表示されます
23


# Page. 24

![Page Image](https://bcdn.docswell.com/page/2JV368LXEQ.jpg)

プロパティの作成


# Page. 25

![Page Image](https://bcdn.docswell.com/page/5EG3N5XR7L.jpg)

プロパティの追加 - プロパティ定義
プロパティの名前
プロパティ名の説明文字列
プロパティの説明を記述する文字列
データ型
使い方 input:入力だけ、bound:入力と出力
必須にするかどうか
初期値
初期値（PowerFX式）
• プロパティは、ControlManifest.Input.xmlで定義
• 定義後のターミナル上で”npm run build”すると、型定義ファイルが作成される
• 型定義ファイルが作成されると、コード上でプロパティの操作が可能
25


# Page. 26

![Page Image](https://bcdn.docswell.com/page/4JQ5QZ8Y7P.jpg)

ボタンコンポーネントの追加


# Page. 27

![Page Image](https://bcdn.docswell.com/page/K749N32ZE1.jpg)

ボタンコンポーネントの追加
• プロジェクト作成時に組み込まれているReactライブラリ”@fluentui”のコマンドボタ
ンを追加
• デバックするとボタンが追加される
27


# Page. 28

![Page Image](https://bcdn.docswell.com/page/LJ1K51MD7G.jpg)

ボタンコンポーネントの追加 - 追加したプロパティを使う
•
•
•
•
•
追加したプロパティを使う為、型定義をimport設定
コンポーネント描画の引数にプロパティを追加
追加したプロパティをボタンの表示名に設定
ボタンサイズを調整
最初に呼び出される、index.tsからcontext（PCFで用意されている外部パラメータ）を渡す
28


# Page. 29

![Page Image](https://bcdn.docswell.com/page/GJWD583872.jpg)

ボタンコンポーネントの追加 - プロパティ動作の確認
29


# Page. 30

![Page Image](https://bcdn.docswell.com/page/4EZGN8V9J3.jpg)

イベントの作成


# Page. 31

![Page Image](https://bcdn.docswell.com/page/Y76Y8P5DEV.jpg)

イベントの作成 - イベント定義
イベントの名前
イベント名を説明文字列
イベントの説明を記述する文字列
コンポーネントに提供される既定の Power Fx 式の値。
• イベント定義も「ControlManifest.Input.xml 」で定義
31


# Page. 32

![Page Image](https://bcdn.docswell.com/page/G75G9KY874.jpg)

イベントの作成 - イベント定義②
IEventBag はイベントの登録、解除、および発生
を行うためのメソッドを提供
プロパティしかない！！
• イベントの場合、ビルドしても型定義ファイルが作成されない
• 自分で型定義を拡張する必要がある
• 「ContextExtended.ts」でparameter として渡ってくる型にイベントを追加
32


# Page. 33

![Page Image](https://bcdn.docswell.com/page/9J2Y2WGVJR.jpg)

イベントの作成 - イベント実装①
• 拡張した型タイプを追加
• クリックイベントハンドラをうけとるプロパティを追加
• クリック時にイベントをプロパティへ渡す
33


# Page. 34

![Page Image](https://bcdn.docswell.com/page/DEYGYLVQEM.jpg)

イベントの作成 - イベント実装②
• contextの型を拡張したものに書き換える
• イベントを実装し、作成したクリックイベントと変更状態を通知する
• コンポーネント側のプロパティに追加したイベントハンドラプロパティに自分のイベ
ントを設定する
34


# Page. 35

![Page Image](https://bcdn.docswell.com/page/VJNGP4M278.jpg)

イベントの作成 – 動作確認
35


# Page. 36

![Page Image](https://bcdn.docswell.com/page/YE9W3QNDE3.jpg)

イベントの作成 – 動作確認2
• デフォルトで設定していた、PFXが初期状態でただしく設定される
• クリックしたら変数に、指定の文字列が設定される
36


# Page. 37

![Page Image](https://bcdn.docswell.com/page/GE8NMGK57D.jpg)

データセットプロパティの追加


# Page. 38

![Page Image](https://bcdn.docswell.com/page/LELP3GZ37R.jpg)

データセットプロパティの作成 - プロパティ定義
プロパティの名前
プロパティ名の説明文字列
プロパティの説明を記述する文字列
コンポーネントに提供される既定の Power Fx 式の値。
• データセットプロパティも「ControlManifest.Input.xml 」で定義
• データセットの場合、子ノードにもプロパティ設定が可能
38


# Page. 39

![Page Image](https://bcdn.docswell.com/page/4JM4DQVM7W.jpg)

データセットプロパティの作成 – 動作確認①
• Itemsに設定される
• コンポーネントにつき、ひとつ？
• 子ノードのプロパティセットは、フィールドの編集時に、使えるコントロールの種類に
なる
39


# Page. 40

![Page Image](https://bcdn.docswell.com/page/PJRW482L79.jpg)

データセットプロパティの作成 – 動作確認②
画面描画は、コンポーネント内でテーブルタグで実装
40


# Page. 41

![Page Image](https://bcdn.docswell.com/page/PEXP28P67X.jpg)

環境へのアップ


# Page. 42

![Page Image](https://bcdn.docswell.com/page/3EKDMKDGJD.jpg)

環境へのアップ
コンポーネントをZipファイルにパッケージ化
ソリューションインポート
Power Platform CLI コマンド
「pcf push」を使い環境へデプロイ
• 作成したコンポーネントの環境へのアップは２つ
• 今回は、pcf pushを使う方法を紹介
※Zipファイルにパッケージ化する方法はこちらで紹介中
42


# Page. 43

![Page Image](https://bcdn.docswell.com/page/L73RYZR5J5.jpg)

環境へのアップ - 認証プロファイルの作成
• “pac auth create --environment https://example.com/”コマンドで
デプロイ環境の認証プロファイル作成
43


# Page. 44

![Page Image](https://bcdn.docswell.com/page/87DY5RYY7G.jpg)

環境へのアップ - 認証プロファイルの確認
• “pac auth list”で認証プロファイルを確認
• 複数プロファイルがある場合、デプロイ先に「＊」が設定されていればOK
44


# Page. 45

![Page Image](https://bcdn.docswell.com/page/VJP6GW62E8.jpg)

環境へのアップ - 認証プロファイルの切替
• プロファイルを切り替える場合は、 “pac auth select --index 指定環境のindex”
45


# Page. 46

![Page Image](https://bcdn.docswell.com/page/2EV3683X7Q.jpg)

環境へのアップ - 環境へデプロイ①
“jdc”は公開者の接頭辞、任意の名
称が設定可能
ローカルのビルド出力先を初期化
事前にインストール済みのビルド
ツール“MsBuild” を使用
46


# Page. 47

![Page Image](https://bcdn.docswell.com/page/57G3N53RJL.jpg)

環境へのアップ - 環境へデプロイ②
パッケージビルド完了
ソリューションインポート
47


# Page. 48

![Page Image](https://bcdn.docswell.com/page/4EQ5QZ5YJP.jpg)

JSライブラリを使って機能アップ
48


# Page. 49

![Page Image](https://bcdn.docswell.com/page/KJ49N39Z71.jpg)

JSライブラリを使って機能アップ
• 数式表示を行う為のJavaScriptライブラリ「KaTeX（カテフ）」を利用して
• 入力した文字列を数式化するコンポーネント作成
49


# Page. 50

![Page Image](https://bcdn.docswell.com/page/LE1K51KDJG.jpg)

JSライブラリを使って機能アップ - ライブラリのインストール
npm install react-katex --save-dev @types/react-katex
• ライブラリのインストールには、npmを使用
50


# Page. 51

![Page Image](https://bcdn.docswell.com/page/GEWD58D8J2.jpg)

JSライブラリを使って機能アップ – CSSのインポート
• CSSは「ControlManifest.Input.xml 」で設定
• &lt;resources&gt;内で対象CSSを設定
51


# Page. 52

![Page Image](https://bcdn.docswell.com/page/47ZGN8G9E3.jpg)

JSライブラリを使って機能アップ – コード実装
ライブラリのインポート
使っていなかった「sampleProperty」の値を
ライブラリを利用して数式表示
52


# Page. 53

![Page Image](https://bcdn.docswell.com/page/YJ6Y8PYD7V.jpg)

JSライブラリを使って機能アップ – 動作確認
53


# Page. 54

![Page Image](https://bcdn.docswell.com/page/GJ5G9KG8J4.jpg)

JSライブラリを使って機能アップ – 他ライブラリ使用例
Reactライブラリとして有名なMaterial UIを使用すると
ダイアログもコンポーネント化できる
https://mui.com/material-ui/react-dialog/
54


# Page. 55

![Page Image](https://bcdn.docswell.com/page/LE3RYZRG75.jpg)

PCF帳票ビューワと外部Webサーバー
帳票機能を作成
55


# Page. 56

![Page Image](https://bcdn.docswell.com/page/8EDY5RYNEG.jpg)

.NETアプリケーション開発の”帳票”をトータルで支援する
コンポーネント
56


# Page. 57

![Page Image](https://bcdn.docswell.com/page/V7P6GW6NJ8.jpg)

いろいろな帳票がつくれます
57


# Page. 58

![Page Image](https://bcdn.docswell.com/page/2JV3683YEQ.jpg)

帳票機能の構成
Power Appsキャンバスアプリ
on premises server
リクエスト
ASP.NET Core
Webアプリ
帳票生成
（html、pdf..）
フロントエンド（PCF帳票ビューワ）
Web API
58


# Page. 59

![Page Image](https://bcdn.docswell.com/page/5EG3N53W7L.jpg)

帳票ビューワの追加プロパティ
プロパティ
設定値
Server_Url
「AcitveReports ASP.NET Core Webアプリ」のホスト名を指定します。
例：「https://任意のアプリケーション名.azurewebsites.net/”」
Reports_ID
表示するレポートを指定します。（Webサーバー上に配置しているレポートファイル名を指定）
Reports_Loading
Reports_Parameter
レポートの読み込みを行うかどうかの設定。
レポート設定が行われていない場合に読込を行うとエラーとなる動作の抑制を行います。
キャンバスアプリケーション上から、制御できるように切替コンポネントにて操作可能なように以下を設定し
ます。
レポートへパラメータを設定します。
JSONデータなどを渡すことで、キャンバスアプリのデータをレポートデータソースに使用できます。
Style_Width
ビューワのスタイル設定（幅）です。
Style_Height
ビューワのスタイル設定（高さ）です。
59


# Page. 60

![Page Image](https://bcdn.docswell.com/page/4JQ5QZ5Q7P.jpg)

帳票ビューワの実装 -マニフェストファイルの更新
• 外部ドメイン設定
• プロパティ追加
• 帳票ビューワライブラリで使用する、CSSファイルの参照設定
60


# Page. 61

![Page Image](https://bcdn.docswell.com/page/K749N39YE1.jpg)

帳票ビューワの実装 – CSSファイル作成
ビューワ内部で利用しているCSSファイル
• App.cssを新規追加（ビューワに対する設定）
• ビューワー内部で利用しているCSSファイルをコピーし配置
61


# Page. 62

![Page Image](https://bcdn.docswell.com/page/LJ1K51KN7G.jpg)

帳票ビューワの実装 – コンポーネント実装
• プロパティ定義した外部Webサーバー指定
• レポートIDとレポートへのパラメータを設定
62


# Page. 63

![Page Image](https://bcdn.docswell.com/page/GJWD58PM72.jpg)

Webアプリの実装
•
•
•
Webアプリ（サーバー）上にレポートファイルを配置
サーバー上で帳票（html、pdfなど）を生成
Power Appsからのリクエストを処理する為にキャンバスアプリが実行されているPower Appsの
オリジンを登録しておく
※ブラウザの異なるオリジン（Cross-origin）間へのリソースへのアクセスを制限回避の為
63


# Page. 64

![Page Image](https://bcdn.docswell.com/page/4EZGN8KMJ3.jpg)

デモ1
64


# Page. 65

![Page Image](https://bcdn.docswell.com/page/Y76Y8PQ5EV.jpg)

デモ2
65


# Page. 66

![Page Image](https://bcdn.docswell.com/page/G75G9KRG74.jpg)

まとめ
66


# Page. 67

![Page Image](https://bcdn.docswell.com/page/9J2Y2WDDJR.jpg)

まとめ
• PCFを利用すれば、より高機能なコンポーネントをつくれる
• OSSをはじめ、PCFで利用できそうな、JSライブラリはたくさんありそう
• コンポーネントの要件にはよるが、プロ開発者であれば、開発の敷居
はそこまで高くない
67


# Page. 68

![Page Image](https://bcdn.docswell.com/page/DEYGYL2MEM.jpg)

さいごに
これからやりたいこと
•
Power AppsユーザーにもっとPCFを知ってもらいたい
•
サーバーがいらない帳票PCFコンポーネントを実現したい
•
もっといろいろなJavaScriptライブラリと組み合わせPCF
作ってみたい
68


# Page. 69

![Page Image](https://bcdn.docswell.com/page/VJNGP48378.jpg)

Thank you
#JPPDevUG
セッション内容についてのおことわり
•
本セッションでは、Power Platformに関連する内容について、公式ドキュメントなどの公開済みの情報を基に登壇者が調査し、理解した内容をお伝
えしています。
•
本セッションの情報は正確性を期しておりますが、プレビュー機能や、誤りや最新の情報と異なる場合があることをご了承ください。
•
本セッションの内容に基づいて行動する前に、必ず公式ドキュメントを参照してください。
•
本セッションの情報に基づくいかなる損害についても、登壇者および主催者は一切の責任を負いかねます。
69


