埋め込みキャンバスアプリのガイドラインおよびトラブルシューティング

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

キャンバスアプリの埋め込みに関するガイダンス

この記事では、埋め込みキャンバスアプリを操作するためのガイダンスと、発生する可能性がある問題のトラブルシューティングに役立つヒントを提供します。

埋め込みキャンバスアプリは統一インターフェイスのモデル駆動型アプリでのみサポートされます。
埋め込みキャンバスアプリは、Web ではフォームごとに 3 つ、タブレット PC と電話のクライアントタイプでは 1 つだけ有効にできます。
複数の埋め込みキャンバスアプリをフォームに追加することができますが、Web では一度に 3 つ、タブレット PC と電話のクライアントタイプでは一度に 1 つしか有効にできません。
モデル駆動型のアプリのフォームで Web クライアントタイプの埋め込みキャンバスアプリが 3 つ以上有効になっている場合、次のようなエラーメッセージが表示されます: ”Web フォームファクタのキャンバスアプリが 3 つ以上ありますが、このフォームファクタでは最大 3 つです。キャンバスアプリの数は、Web 用に 3 つ、タブレットと電話用に 1 つに制限されています。」
埋め込みキャンバスアプリを有効化または無効化するには、埋め込みキャンバスアプリの有効化および埋め込みキャンバスアプリの無効化を参照してください。
フォームタブごとに1つの埋め込みキャンバスアプリを使用することを推奨します。
埋め込みキャンバスアプリをモデル駆動型フォームに追加する時は、常に値があることを保証されている必須の列を使用します。列に値がない場合、埋め込みキャンバスアプリはホストのモデル駆動型フォーム上のデータが変更されるときに最新の情報に更新されません。
モデル駆動型フォームを公開しても、埋め込みキャンバスアプリは公開されません。
- 埋め込みキャンバスアプリはホストのモデル駆動型フォームから独立して公開する必要があります。詳細: アプリの公開。
キャンバスアプリコントロールプロパティ内の カスタマイズ ボタンを介して埋め込みキャンバスアプリを作成または編集するために Power Apps Studio を開くことが Web ブラウザーのポップアップブロッカーによりブロックされる場合、make.powerapps.com サイトを有効化、または一時的にポップアップブロッカーを無効化してから、再度 カスタマイズ を選択する必要があります。
新しい行を作成するときは、それに渡すために行のコンテキストが必要なため、埋め込みキャンバスアプリは表示されません。
ModelDrivenFormIntegration.Item オブジェクトは読み取り専用です。
- データを記述するには、Dataverse コネクタを使用する必要があります。詳細: Microsoft Dataverse
埋め込みキャンバスアプリは、ホストのモデル駆動型フォームを介してのみ作成することができます。
キャンバスアプリが埋め込まれたモデル駆動型のフォームを表示したときに、「このアプリへのアクセス権がありません」というエラーメッセージが表示された場合は、作成者が埋め込みキャンバスアプリを共有していることを確認してください。詳細: 埋め込みキャンバスアプリの共有。
サブグリッドコントロールにキャンバスアプリを追加することができなくなりました。
- プレビューリリースでは、メーカーはサブグリッドコントロールにキャンバスアプリを追加できました。キャンバスアプリがモデル駆動型フォームに埋め込まれ、一般提供されたため、モデル駆動型フォームに埋め込まれたキャンバスアプリを追加することは、列に対して簡素化されます。
- これにより、メーカーは、現在の (メインフォーム) 行をデータコンテキストあるいは、現在の (メインフォーム) 行に関連する行の一覧として渡すかを事前に決める必要がなくなるため、さらに簡単になりました。
- メーカーは、列から常に開始し、現在の (メインフォーム) 行、または現在の (メインフォーム) 行に関連する行の一覧の両方にアクセスできます。
- キャンバスアプリで関連する行のリストにアクセスするにあたって、作成者はキャンバスアプリでデータソースの改善エクスペリエンスと Dataverse ビュー機能を有効にして、Dataverse コネクタとフィルタ機能を使用することができます。
  たとえば、取引先担当者 テーブルの アクティブな取引先担当者 ビューにアクセスするには、メーカーは以下を使用できます: フィルター (取引先担当者、'取引先担当者 (ビュー)'.'アクティブな取引先担当者')。
- サブグリッドコントロールを使用する既存のキャンバスアプリは、引き続き機能します。ただし、代わりに列を使用するために、次のアプリケーションに移行することをお勧めします。詳細: 詳しくは、現在の (メインフォーム) 行に関連する行の一覧を使用するモデル駆動型フォーム上の埋め込みキャンバスアプリへの移行をご覧ください。

埋め込みキャンバスアプリの有効化

埋め込みキャンバスアプリとして表示するようにカスタマイズされた列を選択します。
列のプロパティ ダイアログボックスで、コントロール タブを選択します。
コントロールのリストで、キャンバスアプリを選択してからWeb オプションを選択します。
OK を選択します。

埋め込みキャンバスアプリの無効化

埋め込みキャンバスアプリとして表示するようにカスタマイズされた列を選択します。
列のプロパティ ダイアログボックスで、コントロール タブを選択します。
コントロールのリストで、既定のコントロールを選択してから Web オプションを選択します。
OK を選択します。

埋め込みキャンバスアプリでデータを保存する

メインフォームのコマンドバーの [保存] ボタンを選択するなど、モデル駆動型アプリから作成された保存イベントは、埋め込みキャンバスアプリで行われた変更を保存しません。
埋め込みキャンバスアプリで行った変更を保存するには、Dataverse コネクタを使用します。
ModelDrivenFormIntegration 制御 OnDataRefresh アクションは、埋め込みキャンバスアプリ内のデータを更新するためにのみ使用する必要があります。 OnDataRefresh アクションを使って、埋め込みキャンバスアプリ内の変更を保存することはお勧めしません。

埋め込みキャンバスアプリに関する既知の問題および制限

制限

キャンバスアプリコントロールは Web クライアントの種類と共に使用する場合にのみサポートされます。現在、電話およびタブレット PC クライアントの種類はサポートされていません。
セキュリティロール内のキャンバスアプリ特権を使用して、埋め込みキャンバスアプリやスタンドアロンキャンバスアプリのいずれかに対するアクセス権をアプリのユーザーに付与することはできません。埋め込みキャンバスアプリの共有の詳細については、埋め込みキャンバスアプリの共有にアクセスしてください。
ホストのモデル駆動型フォームに表示されているものと同じデータを記述する場合、フォームがリフレッシュされるまで引き続き古いデータが表示されます。そのための簡単な方法は RefreshForm メソッドを使うことです。
バーコードスキャン、デバイスからの写真のキャプチャ、ファイルの添付などのオフラインおよびデバイス機能のコントロールは、埋め込みキャンバスアプリではサポートされていません。

たとえば、ModelDrivenFormIntegration コントロールが取引先企業テーブルに接続されている場合、ModelDrivenFormIntegration.Item.'取引先責任者'.'氏名' を使用しても値は返されません。

関連テーブルのカラムにアクセスするには、以下のいずれかの式を使用します: - LookUp(取引先企業, 取引先企業 = GUID(First(ModelDrivenFormIntegration.Data).ItemId)).'取引先責任者'.'氏名'
- ItemId は作成時には空ですが、実行時には値を持ちます。 - LookUp(取引先企業, 取引先企業 = ModelDrivenFormIntegration.Item.Account).'取引先責任者'.'氏名' (この式は読みやすくなっていますが、前式の方が速度が若干よいです。)

埋め込みキャンバスアプリが正しくレンダリングされない

キャンバスアプリをレスポンシブになるようにビルドできます。これは、利用可能な画面スペースを賢明に使用するために、異なる画面サイズやフォームファクタに自動的にアプリを合わせ、あらゆるデバイス、フォームファクター、画面サイズで優れた UI と UX を提供する機能のことです。アプリが応答するように構築されているかどうかに応じて、キャンバスアプリがモデル駆動型アプリフォームのフィールド内で正しくレンダリングされるように、異なる設定をお勧めします。キャンバスアプリの周囲に空白やスクロールバーが追加される場合は、アプリで次の点を確認することをお勧めします。

レスポンシブなアプリの場合:

全体表示 オプションを無効化します。これにより、アプリに設定したディメンションとプロパティに従ってアプリをスケーリングできるようになります。埋め込みキャンバスアプリは、キャンバスアプリ周囲の追加の空白またはスクロールバーなど、モデル駆動型アプリフォームのフィールド内では正しくレンダリングされない場合があります。

レスポンシブアプリの場合:

全体表示 オプションを有効にすることをお勧めします。これは、利用可能なスペースに合わせてアプリを拡大縮小するのに役立ちます。

両方のシナリオにおいて、App Name プロパティ値が設定されているか、または埋め込みキャンバスアプリコントロールで正しく設定されていることを確認してください。

埋め込みキャンバスアプリで高さが正しく尊重されない

フォームフィールドの高さ プロパティは、キャンバスアプリコンポーネントでは考慮されません。埋め込まれている場合、キャンバスアプリコンポーネントのサイズは、キャンバスアプリで設定されたアスペクト比を尊重します。アスペクト比が固定されているため、キャンバスアプリコンポーネントの高さはアプリの幅に対して計算されます。アプリの幅は、モデル駆動型アプリで使用可能な水平方向のスペースに基づいて決定されます。キャンバスアプリコンポーネントの高さを調整する場合は、キャンバスアプリでアスペクト比のカスタマイズをお勧めします。アスペクト比をカスタマイズするには、アプリがタブレットレイアウトである必要があることに注意してください。

領域に合わせて拡大縮小を有効にする

既定では、キャンバスアプリでは領域に合わせて拡大縮小するオプションが有効になっています。

編集用のモデル駆動型アプリのフォームに埋め込むキャンバスアプリを開きます。
Power Apps studioで、ファイル > 設定 > 画面サイズ + 向きの順に選択します。
詳細設定で、領域に合わせて拡大縮小をオンに設定します。

アプリ名のプロパティ値が欠落しているか、または正しく定義されない

この問題を解決するには、次の正しいオプションを選択します。

管理ソリューション: ソリューションが管理ソリューションとして環境にインポートされた場合は、次の手順を実行します。
1. Power Apps にサインインし、埋め込みキャンバスアプリを最初に作成した開発環境に移動します。これは、ソリューションがエクスポートされた環境でもあります。
2. キャンバスアプリを含むアンマネージドソリューションを開き、ソリューションコンポーネントのリストでキャンバスアプリを見つけます。キャンバスアプリ名をコンポーネントリストに表示されているとおりにコピーします。例: contoso_flooringestimatesapp_624d7。
3. 同じソリューションで、キャンバスアプリコントロールが埋め込まれたモデル駆動型アプリを編集し、前の手順の値を使用してキャンバス アプリ名を埋め込みキャンバスアプリコントロールに設定します。詳細: 埋め込みキャンバスアプリをモデル駆動型フォームに追加する
4. 開発環境からソリューションをエクスポートし、ターゲット環境にソリューションをインポートします。
アンマネージドソリューション: ソリューションがアンマネージドソリューションとして環境にインポートされた場合は、キャンバスアプリコントロールが埋め込まれたモデル駆動型アプリを編集し、管理ソリューションで説明された同様の手順を実行し、キャンバス アプリ名 プロパティを設定します。

埋め込まれたキャンバスアプリコントロールは、別の環境からキャンバスアプリをロードします

キャンバスアプリが埋め込まれたモデル駆動型アプリを含むソリューションがターゲット環境にインポートされると、コントロールはソース環境 (ソリューションがエクスポートされた場所) からキャンバスアプリを読み込みます。コントロールは、ターゲット (現在の) 環境からキャンバスアプリをロードする必要があります。

この問題は、アプリユーザーがターゲット (現在の) 環境で CanvasApp 拡張メタデータテーブルへの読み取りアクセス権を持っていないために発生します。この問題を解決するには、CanvasApp 拡張メタデータテーブルへの読み取りアクセス権のあるアプリで使用するセキュリティロールにユーザーを追加します。詳細: CanvasApp 拡張メタデータテーブルの読み取り権限を付与する

エラーメッセージ:「キャンバスアプリエンティティの読み取り特権がありません。管理者に問い合わせてください」

エラーメッセージは、埋め込みキャンバスアプリが表示されるモデル駆動型アプリフォームに表示されます。

この問題は、アプリユーザーが CanvasApp 拡張メタデータテーブルへの読み取りアクセス権を持っていないために発生します。この問題を解決するには、CanvasApp 拡張メタデータテーブルへの読み取りアクセス権のあるアプリで使用するセキュリティロールにユーザーを追加します。

CanvasApp 拡張メタデータテーブルの読み取り権限を付与する

Power Apps で、環境を選択してから左側のナビゲーションペインで アプリ を選択します。
必要なアプリを選択し、… を選択してから共有を選択します。
左側のペインで、アプリを選択してから、セキュリティロールを管理する を選択します。
Basic ユーザーセキュリティロールなど、アプリに割り当てられているセキュリティロールを開きます。
カスタムエンティティ タブを選択し、CanvasApp 拡張メタデータ テーブルで必要な組織スコープの読み取り権限を設定します。
保存して閉じる を選択して、セキュリティロールウィンドウを閉じます。