次の方法で共有

キャンバス アプリのソース コードを表示する

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 を使用して環境に接続し、以下のコマンドを使用します:

  1. 現在の環境の キャンバス アプリを一覧表示するには、コマンド pac canvas list を使用します。
  2. ソース コード ファイルを抽出するには、pac canvas download コマンドと パラメータ -dを使用します。

.msapp ファイルからソース コード ファイルを抽出します

.msapp ファイルからソース コード ファイルを抽出するには、2つのオプションがあります。

  1. .msapp ファイルを手動で解凍します。
  2. または、次のコマンドを使用できます。
 Expand-Archive -Path "C:\path\to\yourFile.msapp" -DestinationPath "C:\path\to\destination"

.msapp ファイルのファイル構造

\src フォルダーのない古い .msapp ファイルの場合、次の手順に従ってソース コード ファイルを生成します。

  1. 新しい .msapp を Power Apps Studio にダウンロードして再保存します。
  2. その後、ソースコード ファイルの抽出に進むことができます。

\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 で使用されます。

プレビュー中の形式は一時的なものであり、現在は使用されていません。 プレビュー形式からコードを貼り付けることができます。

実験的な形式から加えられた変更は次のとおりです。

  1. ZIndex プロパティの削除: ZIndex プロパティが削除されました。 代わりに、画面はコントロールの配列として表されます。 コントロールの順序によって、重なり順が決まります。 標準コントロールは昇順で並べ替えられ、レスポンシブ コントロールは降順で並べ替えられます。
  2. JSON オブジェクト表現の置換: "As" 構文は、コントロール型の定義に使用されなくなりました。 代わりに、コントロールの名前識別子の左側は一意のままです。 既定値と異なるプロパティのみがシリアル化されます。 次の 2 つの新しいプロパティで、コントロールの種類と既定値が定義されます。
  • コントロール: YAML のコントロールの種類を表します。
  • バリアント: 既定のプロパティ値の変更、プロパティの追加または削除、またはコントロールの動作やレイアウトの変更を行うコントロール型のバリアントを識別します。

これらのプロパティはコントロールをインスタンス化するために使用され、Power Fx 式は受け入れません。

ソースコード (*.pa.yaml)

重要

  • キャンバスアプリのYAMLソースコードは活発に開発されています。 内容は不完全であり、変更される場合があります。
  • .pa.yaml ファイルは読み取り専用であり、Power Apps Studio の変更内容を確認する場合にのみ使用してください。 これらのファイルは、アプリの読み込み中は使用されません。
  • 外部での編集、マージ、競合の解決はサポートされていません。

このスキーマはソース管理を目的として設計されており、1 つの YAML ファイルを使用できます。

以前の形式からの更新には、次のものが含まれます。

  1. トップレベルノード要素のグループ化:
    • 最上位のキーワード「App」と「Screens」は、要素が最上位ノードにグループ化されるようになった例です。
  2. コントロール バージョンの仕様:
    • コントロール キーワードに続いて @ 演算子を使用して、コントロールのバージョンを指定できるようになりました。 バージョンを指定しない場合は、最新バージョンのコントロールが使用されます。 バージョンは、ソース コードのプロパティを逆シリアル化するために使用されます。 コントロールのランタイム バージョンは、作成バージョンによって定義されます。
  3. 簡略化されたバリアント名:
    • すべてのコントロールにバリアントが必要なわけではありません。
  4. すべてのコントロールに対して一貫性のある ZIndex:
    • すべてのコントロールは、1 から始まる ZIndex 値を決定するために昇順を使用するようになりました。 この動作は、CSS 2 仕様に一致しています。