コードを使用してモデル駆動型アプリケーションのカスタマイズを開始する

[アーティクル]
02/23/2023

Power Apps で利用可能なツール、またはドキュメントに記載されているツールを使用して、モデル駆動型アプリをカスタマイズできます。これらのカスタマイズはサポートされており、アップグレードが可能です。

ここに記述されている以外の方法を使用して行われたカスタマイズについてはサポートされず、更新時やモデル駆動型アプリへのアップグレード時に問題が生じる場合があります。詳細については、このトピックの後方にあるサポートされていないカスタマイズを参照してください。

このサイトなどの Microsoft サイトに公開されている技術資料に記載のトピックは、サポートされていますがアップグレードされない可能性があります。

Power Apps を使用したカスタマイズ

モデル駆動型アプリには、カスタマイズに使用できるさまざまなツールが用意されています。モデル駆動型アプリのツールおよび Web アプリケーションを使用したカスタマイズは完全にサポートされており、すべてアップグレード可能です。

次のカスタマイズ方法を使用すると、完全にサポートされるカスタマイズを実行できます。

Power Apps またはソリューションエクスプローラーでカスタマイズ。詳細については、モデル駆動型アプリの作成の概要を参照してください
Web アプリケーションの設定。詳細については、モデル駆動型アプリの管理を参照してください。
Reporting Services。詳細については、モデル駆動型アプリのレポートと分析ガイドを参照してください。

注意

モデル駆動型アプリの動作は、関連する Microsoft Dataverse に適用されるカスタマイズによって異なります。詳細: Dataverse のサポートされているカスタマイズ 完全なサポート とは、開発者サポートによってカスタマイズをサポートすることができ、アプリケーションサポートによってそれらの変更を行う顧客を支援できることを意味します。

コードを使用して適用されたカスタマイズ

開発者受けのこのサイトのドキュメント、技術記事、このサイトのサンプルコードと、Dataverse 開発者サポートチームによってリリースされる情報は、コードを使用して適用されるカスタマイズの領域に含まれます。具体的な操作とそのサポートおよびアップグレードのレベルは後ほどこのトピックで説明します。

クライアント側 JavaScript

以下の 3 つの領域のモデル駆動型アプリ内で JavaScript を使用できます。

フォームスクリプトイベントハンドラー: フォームイベントハンドラーが JavaScript Web リソースで定義された関数を呼び出すように構成できます。
コマンドバー (リボン) コマンド: JavaScript Web リソース内に定義された関数を呼び出すアクションを定義するために、<CustomRule> または <JavaScriptFunction> 要素を使用できます。
Web リソースと IFRAME: HTML Web リソース内で JavaScript Web リソースを使用できます。クロスサイトスクリプトまたはフォームに含まれる HTML Web リソース内のスクリプトを許可するように構成されたIFRAMEは、親参照を介してフォーム内でドキュメント化されたXrm.PageまたはXrm.Utility メソッド対話することがあります。

アプリケーションページとのすべての対話は、モデル駆動型アプリのクライアント API 参照に記載されているメソッドを使用したメソッドを通じてのみ実行する必要があります。モデル駆動型アプリページのドキュメントオブジェクトモデル(DOM )に直接アクセスすることは、サポートされていません。フォームスクリプトおよびコマンドで jQuery を使用することはお勧めしません。詳細: JavaScript を使用したモデル駆動型アプリでのクライアントスクリプト作成。

URL を使用してフォーム、ビュー、ダイアログおよびレポートを開くに記載されている方法を使用して、モデル駆動型アプリフォーム、ビュー、ダイアログ、およびレポートを開くことができます。

リボンのカスタマイズ

リボン要素の追加、削除、および非表示を行う RibbonDiffXml がサポートされています。モデル駆動型アプリで定義されているリボンコマンドの再利用はサポートされますが、使用可能なコマンドは将来的に変更または削除される可能性があります。リボンコマンドで定義された JavaScript 関数の再利用はサポートされていません。

サポートされていないカスタマイズ

このドキュメントで説明されたメソッドまたは Power Apps のいずれのツールも使用しないで実行されたモデル駆動型の変更はサポートされず、モデル駆動型アプリの更新時またはアップグレード時に保存されません。このドキュメントおよびサポートドキュメントに文書化されていないものはすべてサポートされません。また、サポートされていない変更を加えると、修正プログラムや Service Pack によって更新する際、またはモデル駆動型アプリをアップグレードする際に問題が生じる可能性があります。

次は、よく質問されるサポートされていない操作の種類の一覧です:

モデル駆動型アプリケーション JavaScript コードの再利用。このコードはアップグレード時に変更または上書きされる場合があります。
ソリューションファイルの編集による、リボン、フォーム、サイトマップ、または保存されたクエリ以外のソリューションコンポーネントの編集はサポートされていません。詳細については、カスタマイズを編集するタイミングを参照してください。
- ソリューションファイルの定義による新しいソリューションコンポーネントの定義はサポートされていません。
- ソリューションと共にエクスポートされた Web リソースファイルの編集はサポートされていません。
- 管理ソリューションの保守に記載されている手順を除いて、マネージドソリューションの内容の編集はサポートされていません。
別のフォームに埋め込まれた IFrame 内のフォームの表示は、サポートされていません。

次の方法で共有