Partager via


Outils de développement Dataverse

Il existe de nombreux outils pour les développeurs que vous pouvez utiliser pour différents aspects du développement de code Microsoft Dataverse. Le tableau suivant les décrit brièvement. Les instructions d’installation et de lancement des outils se trouvent dans la section suivante qui suit le tableau.

Tool Descriptif Documentation
Outil de migration de configuration (CMT) Configuration du transport et test des données d’un environnement à un autre Outil de Migration de Configuration
Package Deployer (Déployeur de Paquet) Déployer des packages dans des environnements Dataverse où les packages contiennent des solutions, du code personnalisé, des fichiers HTML, etc. Déployer un package
Outil d'enregistrement de module d'extension (PRT) Enregistre le code personnalisé (plug-ins, activités de flux de travail personnalisées), les points de terminaison de service, etc. Enregistrer un plug-in
Didacticiel : Écrire et enregistrer un plug-in
Outil SolutionPackager (SP) Outil capable de décomposer réversiblement un fichier de solution compressée Dataverse en plusieurs fichiers XML et d’autres fichiers afin qu’un système de contrôle de code source puisse gérer ces fichiers Outil SolutionPackager
Outil de génération de code (CG) CrmSvcUtil.exe est un outil de génération de code en ligne de commande à utiliser avec Dynamics 365 Customer Engagement (local) et Dataverse. Vous pouvez l’utiliser pour générer des classes .NET Framework à liaison précoce (fortement typées) qui représentent le modèle de données d’entité (EDM) utilisé par Dataverse, mais nous vous recommandons d’utiliser la commande build du modelbuilder pac Power Platform CLI à la place.

pac modelbuilder build est capable de générer des classes qui prennent en charge .NET Framework et la compilation .NET multiplateforme (Core). En savoir plus sur l’utilisation de pac modelbuilder build pour créer des classes à liaison anticipée pour le SDK pour .NET
Utilisez CrmSvcUtil.exe pour générer des classes à liaison précoce pour le SDK .NET

Note

Les outils CMT, et PRT fournissent une interface utilisateur Windows (WPF) et s’exécutent uniquement sur un système d’exploitation Microsoft Windows. En outre, la pac tool commande est disponible uniquement sur une installation Windows de l’interface CLI.

Tous les outils mentionnés ci-dessus, à l’exception de l’outil Génération de code, sont décrits dans cet article.

Télécharger et lancer des outils à l’aide de l’interface CLI Power Platform

Suivez ces instructions pour télécharger et lancer les outils de développement Dataverse.

Note

Les outils Dataverse ne sont plus disponibles individuellement par téléchargement direct. Les outils sont désormais distribués dans plusieurs packages NuGet. Nous fournissons une commande CLI Power Platform pour télécharger le package approprié, extraire et lancer chaque outil et mettre à jour les outils installés.

Vous avez besoin de la version 1.19.3 (ou ultérieure) de Power Platform CLI installée sur votre ordinateur pour suivre ces instructions. Commencez par utiliser l’interface CLI Power Platform pour obtenir de l’aide sur les outils.

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

Plus d’informations : outil pac

Voyons maintenant quels outils sont installés.

> 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

Aucun outil n’est installé dans l’exemple ci-dessus. Ils sont installés lors du premier lancement. Plus d’informations : liste des outils pac

Nous allons télécharger et lancer 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).

Plus d’informations : pac tool prt

Maintenant, notre liste d’outils ressemble à ceci.

> 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

Suivez la même procédure pour télécharger et lancer les outils CMT et PD. Si un outil est déjà installé, la pac tool <toolname> commande lance la dernière version installée de l’outil.

Plus d’informations : pac tool cmt, pac tool pd

Mettre à jour des outils à l’aide de l’interface CLI Power Platform

La mise à jour des outils installés est plus facile à l’aide de l’interface CLI Power Platform. Examinons la liste des outils.

> 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 une mise à jour d’outil était disponible, la colonne NuGet aurait un numéro de version plus récent que la colonne Version installée, et la colonne État contient des instructions sur la façon de mettre à jour l’outil. Par exemple, supposons que le PRT ait une mise à jour. La colonne État indique « Version plus récente disponible, exécutez « pac tool PRT --update ».

Nous pouvons examiner les options disponibles pour n’importe quel outil comme celui-ci.

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

L’interface CLI ne supprime pas les anciennes versions installées (mises en cache) des outils. Vous pouvez supprimer ces versions antérieures, en conservant la dernière version, à l’aide du --clear paramètre.

> pac tool <toolname> --clear

Utiliser le Solution Packager avec l'interface de ligne de commande Power Platform

Bien que le Packager de solution autonome puisse être téléchargé à partir de NuGet, ce n'est pas nécessaire. Vous pouvez utiliser la fonctionnalité Packager de solutions intégrée à l’interface CLI 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)

De même, pour les options disponibles pour décompresser une solution, utilisez pac solution unpack help.

Voir aussi

Outils de développement Power Platform
Générer des classes à liaison anticipée pour le SDK pour .NET
Parcourir les métadonnées de votre organisation
Déployer des packages à l’aide de Package Deployer et de Windows PowerShell