Dataverse 開発ツール

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

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

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 を使用します。

関連情報

Power Platform 開発者ツール
.NET 用 SDK の事前バインド クラスを生成する
組織のメタデータの参照
Package Deployer と Windows PowerShell を使用したパッケージの展開