Microsoft Dataverse コード開発のさまざまな側面に使用できる開発者向けのツールは多数あります。 次の表では、それらを簡単に説明します。 ツールをインストールして起動する手順については、次のセクションの表を参照してください。
| Tool | Description | Documentation |
|---|---|---|
| 構成移行ツール (CMT) | ある環境から別の環境に構成とテスト データを転送する | 構成移行ツール |
| パッケージ 配置ツール (PD) | パッケージにソリューション、カスタム コード、HTML ファイルなどが含まれている Dataverse 環境にパッケージをデプロイする | パッケージをデプロイする |
| プラグイン登録ツール (PRT) | カスタム コード (プラグイン、カスタム ワークフロー アクティビティ)、サービス エンドポイントなどを登録します |
プラグインの登録 チュートリアル: プラグインを書き込み登録する |
| SolutionPackager ツール (SP) | ソース管理システムがこれらのファイルを管理できるように、Dataverse 圧縮ソリューション ファイルを複数の XML ファイルやその他のファイルに元に戻して分解できるツール | SolutionPackager ツール |
| コード生成ツール (CG) |
CrmSvcUtil.exe は、Dynamics 365 Customer Engagement (オンプレミス) と Dataverse で使用するためのコマンド ライン コード生成ツールです。 これを使用して、Dataverse で使用されるエンティティ データ モデル (EDM) を表す事前バインド (厳密に型指定された) .NET Framework クラスを生成できますが、代わりに Power Platform CLI pac modelbuilder ビルド コマンド を使用することをお勧めします。pac modelbuilder build は、.NET Framework とクロスプラットフォーム .NET (Core) コンパイルをサポートするクラスを生成できます。
pac modelbuilder ビルドを使用して SDK for .NET の早期バインド クラスを作成する方法の詳細を確認する |
CrmSvcUtil.exe を使用して SDK for .NET の早期バインド クラスを生成する |
注
CMT、PD、PRT ツールは、Windows (WPF) ユーザー インターフェイスを提供し、Microsoft Windows オペレーティング システムでのみ実行されます。 また、 pac tool コマンドは、CLI の Windows インストールでのみ使用できます。
この記事では、上記のすべてのツール (コード生成ツールを除く) について説明します。
Power Platform CLI を使用してツールをダウンロードして起動する
Dataverse 開発ツールをダウンロードして起動するには、次の手順に従います。
注
Dataverse ツールは、直接ダウンロードによって個別に使用できなくなりました。 ツールは、複数の NuGet パッケージで配布されるようになりました。 正しいパッケージをダウンロードし、各ツールを抽出して起動し、インストールされているツールを更新するための Power Platform CLI コマンドを提供します。
これらの手順に従うには、コンピューターに インストールされている Power Platform CLI のバージョン 1.19.3 (以降) が必要です。 まず、Power Platform CLI を使用してツールに関するヘルプを表示します。
> pac tool help
Microsoft PowerPlatform CLI
Version: 1.19.3
Help:
Power Platform tools that can be installed and launched
Commands:
Usage: pac tool [list] [prt] [cmt] [pd]
list List the launchable tools and their local install state and version.
prt Launch Plug-in Registration Tool (PRT)
cmt Launch Configuration Migration Tool (CMT)
pd Launch Package Deployer (PD)
詳細情報: pac ツール
次に、インストールされているツールを見てみましょう。
> pac tool list
ToolName Installed Version Nuget Status
CMT No N/A 9.1.0.80 not yet installed; 'pac tool CMT' will install on first launch
PD No N/A 9.1.0.104 not yet installed; 'pac tool PD' will install on first launch
PRT No N/A 9.1.0.155 not yet installed; 'pac tool PRT' will install on first launch
上記の例では、ツールはインストールされていません。 初回起動時にインストールされます。 詳細情報: pac ツールの一覧
PRT をダウンロードして起動しましょう。
> pac tool prt
Installing 9.1.0.155 version of PRT....
Shortcut in start menu created for 'Plugin Registration Tool'
Installation complete
Launched PRT (9.1.0.155).
詳細情報: pac ツール prt
これで、ツールの一覧は次のようになります。
> pac tool list
ToolName Installed Version Nuget Status
CMT No N/A 9.1.0.80 not yet installed; 'pac tool CMT' will install on first launch
PD No N/A 9.1.0.104 not yet installed; 'pac tool PD' will install on first launch
PRT Yes 9.1.0.155 9.1.0.155 ok
CMT および PD ツールをダウンロードして起動するには、同じ手順に従います。 ツールが既にインストールされている場合、 pac tool <toolname> コマンドは、インストールされている最新バージョンのツールを起動します。
詳細情報: pac ツール cmt、 pac ツール pd
Power Platform CLI を使用してツールを更新する
Power Platform CLI を使用すると、インストールされているツールの更新が簡単になります。 ツールの一覧を見てみましょう。
> pac tool list
ToolName Installed Version Nuget Status
CMT No N/A 9.1.0.80 not yet installed; 'pac tool CMT' will install on first launch
PD No N/A 9.1.0.104 not yet installed; 'pac tool PD' will install on first launch
PRT Yes 9.1.0.155 9.1.0.155 ok
使用可能なツールの更新プログラムがある場合、NuGet 列のバージョン番号は [インストールされているバージョン] 列よりも新しく、状態列にはツールを更新する方法に関する手順が含まれます。 たとえば、PRT に更新があるとします。 [状態] 列に "使用可能な新しいバージョン、'pac tool PRT --update' を実行する" と表示されます。
このようなツールで使用できるオプションを確認できます。
> pac tool prt help
Microsoft PowerPlatform CLI
Version: 1.19.3
Help:
Launch Plug-in Registration Tool (PRT)
Commands:
Usage: pac tool prt [--update] [--clear]
--update Update tool to latest available version from nuget.org (alias: -u)
--clear Clear tool from local file cache (alias: -c)
CLI では、以前にインストールされた (キャッシュされた) バージョンのツールは削除されません。
--clear パラメーターを使用して、古いバージョンを削除し、最新バージョンを保持することができます。
> pac tool <toolname> --clear
Power Platform CLI からソリューション パッケージを使用する
ソリューション パッケージャースタンドアロン ツールは NuGet からダウンロードできますが、これを行う必要はありません。 Power Platform CLI に組み込まれているソリューション パッケージ機能を使用できます。
> pac solution pack help
Microsoft PowerPlatform CLI
Version: 1.19.3
Help:
Package solution components on local filesystem into solution.zip (SolutionPackager)
Commands:
Usage: pac solution pack --zipfile [--folder] [--packagetype] [--log] [--errorlevel] [--singleComponent] [--allowDelete] [--allowWrite] [--clobber] [--map] [--sourceLoc] [--localize] [--useLcid] [--useUnmanagedFileForMissingManaged] [--disablePluginRemap] [--processCanvasApps]
--zipfile The full path to the solution ZIP file (alias: -z)
--folder The path to the root folder on the local filesystem. When unpacking/extractins, this will be written to, when packing this will be read from. (alias: -f)
--packagetype When unpacking/extracting, use to specify dual Managed and Unmanaged operation. When packing, use to specify Managed or Unmanaged from a previous unpack 'Both'. Can be: 'Unmanaged', 'Managed' or 'Both'; default: 'Unmanaged' (alias: -p)
--log The path to the log file. (alias: -l)
--errorlevel Minimum logging level for log output [Verbose|Info|Warning|Error|Off]; default: Info (alias: -e)
--singleComponent Only perform action on a single component type [WebResource|Plugin|Workflow|None]; default: None. (alias: -sc)
--allowDelete Dictates if delete operations may occur; default: false. (alias: -ad)
--allowWrite Dictates if write operations may occur; default: false. (alias: -aw)
--clobber Enables that files marked read-only can be deleted or overwritten; default: false. (alias: -c)
--map The full path to a mapping xml file from which to read component folders to pack. (alias: -m)
--sourceLoc Generates a template resource file. Valid only on Extract. Possible Values are auto or an LCID/ISO code of the language you wish to export. When Present, this will extract the string resources from the given locale as a neutral .resx. If auto or just the long or short form of the switch is specified the base locale for the solution will be used. (alias: -src)
--localize Extract or merge all string resources into .resx files. (alias: -loc)
--useLcid Use LCID's (1033) rather than ISO codes (en-US) for language files. (alias: -lcid)
--useUnmanagedFileForMissingManaged Use the same XML source file when packaging for Managed and only Unmanaged XML file is found; applies to AppModuleSiteMap, AppModuleMap, FormXml files (alias: -same)
--disablePluginRemap Disabled plug-in fully qualified type name remapping. default: false (alias: -dpm)
--processCanvasApps (Preview) Pack/unpack any Canvas apps (.msapp) while processing the solution. default: false (alias: -pca)
同様に、ソリューションをアンパックするための使用可能なオプションについては、 pac solution unpack helpを使用します。
こちらもご覧ください
Power Platform 開発者ツール
SDK for .NET の早期バインド クラスを生成する
組織のメタデータの参照
パッケージ 配置ツールと Windows PowerShell を使用してパッケージを展開する