Herramientas de desarrollo de Dataverse

Hay muchas herramientas para desarrolladores que puede usar para distintos aspectos del desarrollo de código de Microsoft Dataverse. En la tabla siguiente se describen brevemente. Las instrucciones para instalar e iniciar las herramientas se encuentran en la sección siguiente que sigue a la tabla.

Tool	Description	Documentation
Herramienta de migración de configuración (CMT)	Configuración de transporte y prueba de datos de un entorno a otro	Herramienta de migración de configuración
Implementador de paquetes (PD)	Implementación de paquetes en entornos de Dataverse donde los paquetes contienen soluciones, código personalizado, archivos HTML, etc.	Implementación de un paquete
Plug-in Registration tool (PRT)	Registra código personalizado (complementos, actividades de flujo de trabajo personalizadas), puntos de conexión de servicio, etc.	Registrar un complemento Tutorial: Escribir y registrar un complemento
Herramienta SolutionPackager (SP)	Herramienta que puede descomponer de forma reversible un archivo de solución comprimido de Dataverse en varios archivos XML y otros archivos para que un sistema de control de código fuente pueda administrar estos archivos.	Herramienta SolutionPackager
Herramienta generación de código (CG)	CrmSvcUtil.exe es una herramienta de generación de código de línea de comandos para su uso con Dynamics 365 Customer Engagement (local) y Dataverse. Puede usarlo para generar clases de .NET Framework de enlace de tiempo de compilación (fuertemente tipadas) que representan el modelo de datos de entidad (EDM) usado por Dataverse, pero recomendamos usar el comando pac modelbuilder build de Power Platform CLI en su lugar. pac modelbuilder build es capaz de generar clases que admiten .NET Framework y compilación multiplataforma de .NET (Core). Más información sobre el uso de pac modelbuilder build para crear clases de enlace en tiempo de compilación para el SDK para .NET	Usar CrmSvcUtil.exe para generar clases de enlace en tiempo de compilación para el SDK para .NET

Nota:

Las herramientas CMT, PD y PRT proporcionan una interfaz de usuario de Windows (WPF) y solo se ejecutan en un sistema operativo Microsoft Windows. Además, el pac tool comando solo está disponible en una instalación de Windows de la CLI.

Todas las herramientas mencionadas anteriormente, excepto la herramienta Generación de código, se describen en este artículo.

Descarga e inicio de herramientas mediante la CLI de Power Platform

Siga estas instrucciones para descargar e iniciar las herramientas de desarrollo de Dataverse.

Nota:

Las herramientas de Dataverse ya no están disponibles individualmente mediante una descarga directa. Las herramientas ahora se distribuyen en varios paquetes NuGet. Proporcionamos un comando de la CLI de Power Platform para descargar el paquete correcto, extraer e iniciar cada herramienta y actualizar las herramientas instaladas.

Necesita la versión 1.19.3 (o posterior) de la CLI de Power Platform instalada en el equipo para seguir estas instrucciones. Empiece por usar la CLI de Power Platform para obtener ayuda sobre las herramientas.

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

Más información: pac tool

Ahora vamos a ver qué herramientas están instaladas.

> 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

No hay herramientas instaladas en el ejemplo anterior. Se instalan en el primer inicio. Más información: lista de herramientas pac

Vamos a descargar e iniciar 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).

Más información: pac tool prt

Ahora nuestra lista de herramientas tiene este aspecto.

> 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

Siga el mismo procedimiento para descargar e iniciar las herramientas de CMT y PD. Si ya hay instalada una herramienta, el pac tool <toolname> comando inicia la versión instalada más reciente de la herramienta.

Más información: pac tool cmt, pac tool pd

Actualización de herramientas mediante la CLI de Power Platform

La actualización de las herramientas instaladas es más fácil mediante la CLI de Power Platform. Echemos un vistazo a la lista de herramientas.

> 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

Si hubiera una actualización de herramientas disponible, la columna NuGet tendría un número de versión más reciente que la columna Versión instalada y la columna Estado contendrá instrucciones sobre cómo actualizar la herramienta. Por ejemplo, imaginemos que el PRT tiene una actualización. La columna Estado diría "Versión más reciente disponible, ejecute 'pac tool PRT --update'".

Podemos echar un vistazo a las opciones disponibles para cualquier herramienta de esta manera.

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

La CLI no elimina las versiones anteriores instaladas (almacenadas en caché) de las herramientas. Puede eliminar esas versiones anteriores, manteniendo la versión más reciente mediante el --clear parámetro .

> pac tool <toolname> --clear

Uso del empaquetador de soluciones desde la CLI de Power Platform

Aunque la herramienta independiente Solution Packager se puede descargar desde NuGet, no es necesario hacerlo. Puede usar la funcionalidad del empaquetador de soluciones integrada en la CLI de Power Platform.

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

Del mismo modo, para las opciones disponibles para desempaquetar una solución, use pac solution unpack help.

Véase también

Herramientas de desarrollo de Power Platform
Generar clases de enlace en tiempo de compilación para SDK para .NET
Examinar los metadatos de la organización
Implementación de paquetes mediante package Deployer y Windows PowerShell