Dataverse 開発ツール

[アーティクル]
10/10/2023

Microsoft Dataverse コード開発のさまざまな側面に使用できる開発者向けのツールが多数あります。次の表は、これらを詳しく説明します。

ツール	Description	ドキュメント
Configuration Migration Tool (CMT)	ある環境から別の環境に、構成とテストデータを転送する	Configuration Migration Tool
Package Deployer (PD)	パッケージがソリューション、カスタムコード、HTML ファイルなどを含む Dataverse 環境にパッケージを展開する	パッケージの配置
Plug-in Registration tool (PRT)	カスタムコード (プラグイン、カスタムワークフロー活動) やサービスエンドポイントなどを登録する	プラグインの登録チュートリアル: プラグインを書き込み登録する
SolutionPackager ツール (SP)	Dataverse 圧縮ソリューションファイルを複数の XML ファイルおよびその他のファイルに可逆的に分解処理を行い、ソースコントロールシステムはこれらのファイルを管理できます	SolutionPackager ツール
コード生成ツール (CG)	`CrmSvcUtil.exe` は、Dynamics 365 Customer Engagement (on-premises) と Dataverse と共に使用するコマンドラインコード生成ツールです。これを使用すると、事前にバインドされた (強い型付けされた) .NET Frameworkクラスを生成できます。このクラスは、によって使用されるEntity Data Model (EDM) を表します。 Dataverse、ただし、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 コマンドは、Windows にインストールした CLI のみで使用できます。

コード生成ツールを除く、上記すべてのツールについては以下で説明します。

Power Platform CLI でツールをダウンロードし、起動する

Power Platform CLI のバージョンが 1.19.3 (またはそれ以降) であることを確認します。

次にツールのヘルプを参照します。

> 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 tool

そしてインストールされたツールを確認します。

> 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 tool list

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 tool 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 tool cmt、pac tool 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 のソリューションパッケージャーを使用する

Solution Packager スタンドアロンツールは 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 を使用します。

Dataverse 開発ツール

Power Platform CLI でツールをダウンロードし、起動する

Power Platform CLI でツールを更新する

Power Platform CLI のソリューションパッケージャーを使用する

関連情報

フィードバック

その他のリソース

Dataverse 開発ツール

Power Platform CLI でツールをダウンロードし、起動する

Power Platform CLI でツールを更新する

Power Platform CLI のソリューション パッケージャーを使用する

関連情報

フィードバック

その他のリソース

Power Platform CLI のソリューションパッケージャーを使用する