PAC キャンバス

[アーティクル]
10/16/2024

Power Apps .msapp ファイルを使用して操作しています

[この記事はプレリリースドキュメントであり、変更されることがあります。]

重要

コマンド pack と unpack はパブリックプレビュー中です。
プレビュー機能は運用環境での使用を想定しておらず、機能が制限される可能性があります。これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
create コマンドは一般提供です。

コマンド

command	説明設定
pacキャンバス作成	カスタムコネクタからキャンバスアプリを生成する
pacキャンバスダウンロード	キャンバスアプリを .msapp ファイルとしてダウンロードする
PACキャンバスリスト	キャンバスアプリの一覧表示
パックキャンバスパック	(プレビュー) ソースを msapp ファイルにパックします
パックキャンバスの開梱	(プレビュー) msapp ファイルをソースに解凍する
pacキャンバス検証	(プレビュー) 解凍されたmsappファイルの .pa.yamlソースを検証する

pac canvas create

カスタムコネクタからキャンバスアプリを生成する

このコマンドは、既存のカスタムコネクタの OpenAPI 定義に基づいて、.msapp キャンバスアプリを生成します。このアプリは、カスタムコネクタのアクションの定義方法に基づいて生成された画面、コントロールレイアウト、Power Fx コードに加え、定義済みの外観を含みます。このアプリを使用して、カスタムコネクタで定義したアクションを直接実行できます。

作成者は、生成した .msapp を Power Apps Studio にインポートして、アプリの実行、編集、追加のカスタマイズを実行できます。 Studio で ファイル>開く>参照の順に移動し、生成されたアプリを Power Apps Studio にインポートします。

使用例

次の例は、pac canvas create コマンドの使用を示します。

表示名によるオープンAPI定義に基づいてキャンバスアプリを作成する
IDによるOpen API定義に基づいてキャンバスアプリを作成する

表示名による Open API 定義に基づいてキャンバスアプリを作成する

この例では、コネクタの表示名を使用して、Open API 定義に基づいて (*.msapp ファイルとして) キャンバスアプリを作成します。

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

ID による Open API 定義に基づいてキャンバスアプリを作成する

この例では、コネクタの ID を使用して、Open API 定義に基づいて (*.msapp ファイルとして) キャンバスアプリを作成します。

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

connector-display-name または connector-id は必須です。

キャンバス作成で必須のパラメーター

`--msapp`

生成される .msapp ファイルへのパス

キャンバス作成でオプションのパラメーター

`--connector-display-name`

Power App の生成元であるコネクタの表示名。

`--connector-id`

Power App の生成元であるコネクタの ID。

`--environment`

ターゲット環境の ID または URL。既定値は、現在アクティブな Dataverse 認証プロファイルの環境です。

注釈

考慮事項と制限:

connector-display-name または connector-id のパラメーターで参照するカスタムコネクタは、ソリューションの一部である必要があります。
アプリを Studio にインポートした後は、カスタムコネクタへの関連付けはありません。アプリを実行する前に、作成者はアプリを生成したカスタムコネクタへの参照を手動で追加する必要があります。手順についてはキャンバスアプリにデータ接続を追加するを参照してください。これが完了するまでは、コネクタ参照の追加によって解決する数式エラーがアプリに表示される場合があります。アプリに追加するカスタムコネクタの名前は、canvas create コマンドで参照するカスタムコネクタの表示名と一致する必要があります。
アプリは、コネクタが定義する POST と GET のアクションごとに 1 つの画面を含みます。
- カスタムコネクタで使用できるその他の動詞には対応していません。
各アクションの画面に表示されるコントロールは、各アクションの入力と出力のタイプの定義方法に基づいて動的に生成されます。 canvas create は、カスタムコネクタで定義した特定のタイプの入力と出力に対応していません。これらが発生すると、コマンドがコンソールで警告を生成します。特定の場合:
- オブジェクトの配列と、配列の配列には、入力として対応していません
- 階層が 20 を超えるオブジェクトやネストされた配列に対しては、コントロールが生成されません
- "ファイル" と "バイナリ形式" のタイプには、入力や出力として対応していません。

パックキャンバスのダウンロード

キャンバスアプリを .msapp ファイルとしてダウンロードする

キャンバスのダウンロードに必要なパラメーター

`--name-n`

キャンバスアプリの完全な名前、部分的な名前、またはアプリ ID

キャンバスのダウンロードで使用するオプションのパラメーター

`--environment-env`

ターゲット Dataverse を指定します。値は、Guid または絶対 https URL にすることができます。指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

`--extract-to-directory-d`

キャンバスアプリを抽出する先のディレクトリ名

`--file-name-f`

ファイル名 (通常は .msapp 拡張子を含む)。指定されていないファイルが "appname".msapp という名前で現在のディレクトリに保存されている場合

`--overwrite-o`

ファイルの上書きを許可する

このパラメーターには値が必要ありません。それはスイッチです。

パックキャンバスリスト

キャンバスアプリの一覧表示

キャンバスリストで必要なオプションのパラメーター

`--environment-env`

pac canvas pack

(プレビュー) ソースを msapp ファイルにパックします

例

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

キャンバスパックで必須のパラメーター

`--msapp`

.msapp ファイルへのパス

`--sources`

パックするソースへのディレクトリ

注釈

以前にアンパックされたソースファイルから .msapp ファイルを作成します。 ファイル>開く>ブラウズ へとナビゲートすることで、この結果は Power Apps Studio で開くことができます。

アンパック後、このソースファイルは、Visual Studio Code や GitHub などの外部ツールを使用して編集および管理できます。

pac canvas unpack

(プレビュー) msapp ファイルをソースに解凍する

例

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

既定ディレクトリ HelloWorld_src に展開します。

キャンバスの展開で必須のパラメーター

`--msapp`

.msapp ファイルへのパス

キャンバスの展開で必要なオプションのパラメーター

`--sources`

アンパックするソースへのディレクトリ

注釈

.msapp ソースファイルを展開します。

ファイル>名前を付けて保存>このコンピュータ の順にナビゲートして、Power Apps Studio から .msapp ファイルをダウンロードします。

sources パラメータが指定されていない場合は、.msapp ファイルと同じ名前と場所のディレクトリは _src 接尾辞で使用されます。

フォルダー構造

アンパックとパックの機能には、次のフォルダー構造を使用します。

\src - 制御ファイルとコンポーネントファイル。これにはソースが含まれています。
- *.fx.yaml - ファイルから抽出された数式。 control.json
  
  Note
  
  これは、数式を編集する場所です。
- CanvasManifest.json - ヘッダー、プロパティ、およびpublishInfoに通常含まれる情報が含まれるマニフェストファイル。
- *.json - 生の control.json ファイル。
- \EditorState*.editorstate.json - 使用するためのキャッシュされた情報。 Power Apps Studio
\DataSources - アプリで使用されるすべてのデータソース。
\Connections - アプリに保存され、 Power Apps Studio に再ロードするときに使用される接続インスタンス。
\Assets - アプリに埋め込まれたメディアファイル。
\pkgs - テンプレート、API定義ファイル、コンポーネントライブラリなどの外部参照のダウンロードされたコピー。これらは NuGet/NPM 参照に似ています。
\other - .msapp を再作成するために必要なその他のファイルすべて。
- entropy.json - 揮発性要素 (タイムスタンプなど) がこのファイルに抽出されます。これにより、他のファイルのノイズの違いを減らしながら、往復できるようになります。
- \references の内容などの msapp からのその他のファイルを保持します。

ファイル形式

.fx.yaml ファイルは YAML のサブセットを使用します。 Excel と同様に、すべての式は = 等号で始まる必要があります。詳細: Power Fx YAML 式の文法

Power Apps Studio での変更のマージ

変更をマージする場合、それは 2 つの異なる Power Apps Studio セッションで行われます。

すべてのコントロール名が一意であることを確認してください。たとえば、2 つの異なるセッションにボタンを挿入すると、Button1 コントロールにある 2 つのセッションになる可能性があります。コントロールを作成したらすぐに名前を付けることをお勧めします。このツールは、同じ名前の 2 つのコントロールを受け入れません。
これらのファイルについては、通常どおりにマージします:
- \src*.fx.yaml
競合またはエラーがある場合は、次のファイルを削除できます:
- \src\editorstate*.json - これらのファイルには、Power Apps Studio のオプション情報が含まれています。
- \other\entropy.json
これらのファイルで競合が発生した場合は、最新バージョンを受け入れてもかまいません:
- \checksum.json
これらのパスの下にマージの競合がある場合、マージするのは安全ではありません。これが頻繁に発生する場合はお知らせください。競合を回避するためにファイル形式の再構築に取り組みます。
- \Connections*
- \DataSources*
- \pkgs*
- CanvasManifest.json

オープンソース

Microsoft Power Platform CLI のキャンバスコマンドはオープンソースです。改善について議論し、問題を提起し、Power Apps 言語ツールリポジトリからコードにアクセスします。