Power Apps Studio のキャンバス アプリ のソース コードを使用して、作成者が行った変更を確認します。 生成された キャンバス アプリ YAML コードは読み取り専用であり、変更できません。 ファイルに対する変更はすべて無視され、失われる可能性があります。
- YAML スキーマは活発に開発されており、コンテンツが不完全である可能性があります。
- *.pa.yaml ファイルの現在の静的スキーマは、こちら で入手できます。
Power Fx と YAML は、Power Apps ソースコードに使用される言語です。 YAML は、人間が判読できる形式で評価されており、操作用のさまざまなエディター、ツール、ライブラリの恩恵を受けています。
ソース コード ファイルにアクセスする
Dataverse Git 統合を使用している場合はソース コード ファイルにアクセスできるため、.msapp ファイルは不要になります。
Power Apps Studio はキャンバス アプリのソース コードを作成し、.msapp ファイル内に *.pa.yaml ファイルとして保存します。 .msapp ファイルは、ソース コードを含む一連のファイルを含むバイナリ ファイルです。
チップ
アプリケーション ライフサイクル管理 (ALM) を効果的に使用するには、ソリューションの使用をお勧めします。 キャンバス アプリ パッケージは ALM をサポートしていないため、Dataverse が利用できないときには、基本的なインポートおよびエクスポート機能に使用してください。
ソース コード ファイルは、.msapp ファイルから、または Power Platform CLI を使用して取得することもできます。
*.pa.yaml ファイルは、抽出された .msapp の \Src フォルダーにあります。
重要
抽出された .msapp の \Src ディレクトリにあるファイルのみが、ソース管理で使用することを目的としています。 .msapp 内の JSON ファイルは、保存サイクルと読み込みサイクルの間で安定していないため、ソース コードとして使用しないでください。
Power Platform CLI を使用して pa.yaml ファイルをダウンロードして抽出します
Power Platform CLI を使用して環境に接続し、以下のコマンドを使用します:
- 現在の環境の キャンバス アプリを一覧表示するには、コマンド pac canvas list を使用します。
- ソース コード ファイルを抽出するには、pac canvas download コマンドと パラメータ -dを使用します。
.msapp ファイルからソース コード ファイルを抽出します
.msapp ファイルからソース コード ファイルを抽出するには、2つのオプションがあります。
- .msapp ファイルを手動で解凍します。
- または、次のコマンドを使用できます。
Expand-Archive -Path "C:\path\to\yourFile.msapp" -DestinationPath "C:\path\to\destination"
.msapp ファイルのファイル構造
\src フォルダーのない古い .msapp ファイルの場合、次の手順に従ってソース コード ファイルを生成します。
- 新しい .msapp を Power Apps Studio にダウンロードして再保存します。
- その後、ソースコード ファイルの抽出に進むことができます。
\src フォルダには、次のファイルとフォルダがあります。
- App.pa.yaml: アプリを表します。
- [画面名].pa.yaml: 画面ごとに 1 つのファイルがあり、画面を表します。
- \Component: 各コンポーネントごとに 1 つのファイルが含まれるフォルダーで、[コンポーネント名].pa.yaml として表されます。
\src フォルダー内の .pa.yaml ファイルのみが、ソースコードとして使用できます。 その他のファイルはソース コードとして使用しないでください。
Power Apps YAML スキーマ バージョン
現在、Power Apps ソースコードには 3 つのスキーマのバージョンがあります:
形式名 | ファイル拡張子 | プロパティ |
---|---|---|
試験段階 | *.fx.yaml | 実験的な Power Apps Git バージョン コントロール、pac キャンバス アンパック で使用されるバージョン (開発停止) です。 |
早期プレビュー | - | コードの表示、コードのコピー、およびコードの貼り付けで使用されるバージョン。 このスキーマにはバージョン情報がないため、バージョン管理には適していません。 コード ビューが一般提供 (GA) されると、ソース コード プレビュー形式に切り替わります。 |
ソース コード | *.pa.yaml ファイル | ソース管理の拡張機能とバージョンの詳細が含まれており、現在開発中です。 |
実験的な形式 (*.fx.yaml)
このスキーマでは、キャンバス アプリを処理してソース コード形式に変換するために Power Platform CLI で使用される実験的な形式について説明します。 この形式は、もう積極的に開発されていません。
*.fx.yaml ファイルを新しい形式に直接変換することはできません。 古いアプリを変換するには、キャンバス アプリを .msapp ファイルとしてパッケージ化し、 Power Apps Studio にインポートします。
プレビュー
このバージョンは、プレビュー 期間中の コード ビュー によって使用されます。 Power Apps Studioで キャンバス アプリを作成するように設計されており、コントロールを簡単にコピーして貼り付けることができます。 このバージョンでは、ソースコードは (実験的なフォーマットなどのように) 変換されるのではなく、Power Apps Studio で使用されます。
プレビュー中の形式は一時的なものであり、現在は使用されていません。 プレビュー形式からコードを貼り付けることができます。
実験的な形式から加えられた変更は次のとおりです。
- ZIndex プロパティの削除: ZIndex プロパティが削除されました。 代わりに、画面はコントロールの配列として表されます。 コントロールの順序によって、重なり順が決まります。 標準コントロールは昇順で並べ替えられ、レスポンシブ コントロールは降順で並べ替えられます。
- JSON オブジェクト表現の置換: "As" 構文は、コントロール型の定義に使用されなくなりました。 代わりに、コントロールの名前識別子の左側は一意のままです。 既定値と異なるプロパティのみがシリアル化されます。 次の 2 つの新しいプロパティで、コントロールの種類と既定値が定義されます。
- コントロール: YAML のコントロールの種類を表します。
- バリアント: 既定のプロパティ値の変更、プロパティの追加または削除、またはコントロールの動作やレイアウトの変更を行うコントロール型のバリアントを識別します。
これらのプロパティはコントロールをインスタンス化するために使用され、Power Fx 式は受け入れません。
ソースコード (*.pa.yaml)
重要
- キャンバスアプリのYAMLソースコードは活発に開発されています。 内容は不完全であり、変更される場合があります。
- .pa.yaml ファイルは読み取り専用であり、Power Apps Studio の変更内容を確認する場合にのみ使用してください。 これらのファイルは、アプリの読み込み中は使用されません。
- 外部での編集、マージ、競合の解決はサポートされていません。
このスキーマはソース管理を目的として設計されており、1 つの YAML ファイルを使用できます。
以前の形式からの更新には、次のものが含まれます。
- トップレベルノード要素のグループ化:
- 最上位のキーワード「App」と「Screens」は、要素が最上位ノードにグループ化されるようになった例です。
- コントロール バージョンの仕様:
- コントロール キーワードに続いて @ 演算子を使用して、コントロールのバージョンを指定できるようになりました。 バージョンを指定しない場合は、最新バージョンのコントロールが使用されます。 バージョンは、ソース コードのプロパティを逆シリアル化するために使用されます。 コントロールのランタイム バージョンは、作成バージョンによって定義されます。
- 簡略化されたバリアント名:
- すべてのコントロールにバリアントが必要なわけではありません。
- すべてのコントロールに対して一貫性のある ZIndex:
- すべてのコントロールは、1 から始まる ZIndex 値を決定するために昇順を使用するようになりました。 この動作は、CSS 2 仕様に一致しています。