次の方法で共有


Git バージョン管理を使用してキャンバス アプリを編集する (試験段階)

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

重要

  • この機能は展開中であり、地域によっては、テナントがまだ利用できない場合があります。 Git のバージョン管理を有効にする で説明されている試験段階のスイッチをチェックして、機能がテナントで利用可能かどうかを確認します。
  • これは試験段階の機能です。 既定では無効になっており、使用前に 有効 にする必要があります。
  • 試験段階の機能は運用環境での使用を想定しておらず、機能が制限されている場合があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。

試験段階の Git のバージョン制御機能を使用して、複数のユーザーが同時にキャンバス アプリを編集できるようになりました。 この機能を使用すると、1 人のユーザーがアプリを編集しているときに、他のユーザーがアプリからロックアウトされることはありません。 変更が加えられて同期されると、他の変更と自動的にマージされ、アプリを編集している他のすべてのユーザーが利用できるようになります。

Git は、この機能のバッキング ストアとして使用されます。 Git への接続を使用して初期設定を行った後は、すべてのユーザーは、Git での認証を除いて、追加の構成手順なしでこの機能を使用できます。

いずれの Git プロバイダーも Power Apps Studio—GitHubAzure DevOps などで使用できます。 既存の Git ツールを使用して、バージョン履歴の表示、pull request の作成と管理、その他のバージョン管理タスクを実行します。

注意

  • 始める前に、必ずこの機能の 既知の制限 をお読みください。 Git の使用は進化しており、この機能の動作が変わる可能性があります。 この機能の更新とフィードバックの共有については、Power Apps コミュニティ フォーラム を参照してください。
  • Git のバージョン管理はアプリごとに管理されます。 各アプリは、Git バージョン管理に個別に追加する必要があります。
  • Git バージョン管理を一度有効にすると、アプリの自動保存が無効になります。 変更を手動で保存または同期する必要があります。

Git バージョン管理を有効にする

次の手順に従って、アプリで Git バージョン管理を有効にします。

  1. 新しいアプリを作成するか、Git のバージョン管理に追加する既存のアプリを開きます。

  2. Power Apps Studio で設定を選択します。

  3. 近日公開の機能 を選択します。

  4. 試験段階 を選択します。

  5. バージョン コントロールの設定を表示する まで下方向にスクロールし、オン にします。

  6. 設定ペインの左側に新しい Git バージョン管理 項目が表示されます。

    Git のバージョン管理を有効に切り替えます。

    ヒント

    この機能に関するその他の問題については、Power Apps コミュニティ フォーラム を参照してください。

アプリを Git に接続する

次の手順に従って、アプリを Git に接続します。

  1. Power Apps Studio で設定を選択します。

  2. Git バージョン管理 を選択します。

    このアプリの Git への接続を開始するためのボタン

  3. 接続 を選択し、このアプリの Git 接続情報を入力します。

    Git 接続情報を提供するテキスト入力ボックス。

    • Git リポジトリの URL: Git ツールで通常使用する URL。 Azure DevOps の場合、https://contoso.visualstudio.com/_git/repo などのように、URL の /_git/repo 部分を必ず含めてください。
    • ブランチ: 使用するブランチ名。
    • ディレクトリ: 使用するブランチ内のディレクトリ。 ブランチのルートにキャンバス アプリを保存することはできません。

    ブランチまたはディレクトリが存在しない場合は、作成するように求められます。 ブランチとディレクトリに既にキャンバス アプリがある場合は、現在のアプリが閉じられ、既存のアプリが Git から読み込まれます。

    接続すると、接続情報が表示されます。

Git による認証

Power Apps では、バージョン管理プロバイダーのアカウント パスワードの代わりに、個人用アクセス トークンを使用する必要があります。

注意

個人用アクセス トークンは、Power Apps や Git プロバイダー用のパスワードと同じではありません。 この機能を使用するには、個人用アクセス トークンを作成する必要があります。

バージョン管理プロバイダーによって、個人用アクセス トークンを生成する方法が異なります。 以下の手順に従って、個人用アクセス トークンを入手してください。

Git に接続されたアプリの編集中に、ユーザー名とパスワードの入力を求められます。 このダイアログで ユーザー名アクセス トークン を入力して、Git で認証します。

ダイアログは Git のユーザー名とアクセス トークン (パスワードとして) を要求します。

注意

Git 資格情報は、セッション間で Power Apps によって保存されません。 必要に応じて、ブラウザー設定を使用してフォーム情報を保存し、再利用して資格情報を頻繁に入力しないようにすることができます。

アプリに変更を加える

アプリが Git に接続されたら、Git 資格情報で認証するだけで、アプリを開いて編集できます。 この機能を使用してアプリを読み込んだり、編集したり、保存したり、公開したり、共有したりする場合に、Git の概念を確認する必要はありません。

Studio 画面上部にある新しい同期ボタン (アプリ チェッカー元に戻す ボタンの間) を使用して、現在の変更を Git の内容とマージし、結果を Studio に取り込んでさらに編集します。

変更を Git リポジトリと同期するためのボタン。

重要

マージが行われるたびに、アプリを読み込む必要があります。 アプリが大きい場合、この読み込みに時間がかかることがあります。

Git に接続した後、変更は Power Apps ではなく Git に保存されます。 未公開バージョンは、Power Apps メーカー ポータルに表示されません。

結果のマージ

現在、マージ競合を解決するオプションはありません。 Studio では、アプリのセマンティック ナレッジ (例えば、オブジェクトのタイプやその他のアプリの変更など) によって、自動的に競合のマージや修正が試みられます。 すべての変更は引き続き Git に保存されるため、自動マージがビジネス要件を満たしていない場合は、いつでもアプリの変更を取得して再適用できます。

アプリを公開

Git に接続されたアプリは、このプロセスに変更を加えることなく、公開とユーザー エクスペリエンスのために引き続き正常に機能します。 アプリを公開すると、Power Apps はアプリの実行可能なコピーをユーザーと共有する必要があるため、アプリのバージョンは Power Apps に保存されます。

pull request、履歴の表示、責任、その他の Git 機能

pull request やその他の Git 操作の操作は、Git プロバイダーの Web サイトなど、他の Git ツールを使用して行う必要があります。 コミットをプルまたはプッシュするような Git 操作を実行するオプションはありません。

変更を含む保存や同期を行うたびに、Git でのコミットが行われます。 例えば、他のメーカーが Gitで他の変更を行った場合、すべての変更の結果をマージするために追加のコミットが行われます。 マージによって編集が上書きされた場合でも、変更が失われることはありません。 各メーカーによる変更は、コミットを通じて Git に保存されます。

既知の制限

この機能は試験段階であるため、フィードバックをお待ちしています。 既知の制限を次に示します。 今後のバージョンで、これらの制限のほとんどは削除する予定です。

  • この機能には、コード コンポーネント との互換性がありません。 コード コンポーネントを使用するアプリでは、この機能を使用しないでください。
  • この機能はオンプレミスの Git リポジトリと互換性がありません。 Git リポジトリは Web 上でホストされ、ユーザー名と個人用アクセス トークンでアクセスできる必要があります。
  • 同じコントロールの同じプロパティへの編集はマージされません。 最後に実行した編集が有効になります。
  • アプリを復元 記事に説明されている手順を使用して、キャンバス アプリを以前のバージョンに復元することはできません。 代わりに、Git を使用してアプリを以前のバージョンに復元する必要があります。 詳細については、次のリソースを参照してください:
  • 複数のアプリを同じ Git ディレクトリに接続すると、問題が発生する可能性があります。 これには、アプリのコピーの作成およびそれらのエクスポートとインポートが含まれます。
  • 名前の長さが 180 文字を超えるリポジトリ内の既存のファイルは、接続時に問題を引き起こす可能性があります。 Git 接続アプリ専用のリポジトリを使用することをお勧めします。
  • ファイルメニューで閉じるを選ぶことで、アプリのカスタマイズが削除されているように見える場合があります。 ただし、カスタマイズは削除されません。 ページを更新して、すべてのカスタマイズを再度確認します。
  • Git に接続されたアプリ内 (例えば、アプリ B) (ファイル > 開く) から、Git に接続されていないアプリ (例えば、アプリ A) を開きアプリ A をリポジトリに接続を試みる場合、アプリ A の Git バージョン コントロール パラメーターは、アプリ B と同じです。これが発生した際は、ページを更新してアプリ A を再度リポジトリに接続するよう試みてください。
  • この機能は、カスタム コンポーネントの名前変更に対応していません。
  • 他のユーザーが編集中のアプリを開いているというメッセージが表示された場合、参照したユーザーにアプリの更新を依頼してください。 その後、アプリを更新してロックを除去します。
  • この機能は Test Studio のテストおよびモデル駆動型アプリのカスタム ページと互換性がありません
  • この機能は、SAML シングル サインオンでの使用が承認されている個人用アクセス トークンの使用をサポートしていません。

コミュニティ フォーラムへのフィードバック

ご意見をお寄せください! この機能は、優れたチーム開発エクスペリエンスを可能にする長い道のりの最初のステップです。 更新情報やフィードバックを入手するには、Power Apps コミュニティ フォーラム にアクセスしてください。