Partager via

Outils de développement Dataverse

  • Article

Il existe de nombreux outils pour 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.

Outil Description Documentation
Configuration Migration Tool (CMT) Transporter les données de configuration et de test d’un environnement à un autre Outil de migration de configuration
Package Deployer (PD) Déployer des packages sur les environnements Dataverse où les packages contiennent des solutions, du code personnalisé, des fichiers HTML, etc. Déployer un package
Plug-in Registration Tool (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) Un outil qui peut décomposer de manière réversible un fichier de solution compressé Dataverse en plusieurs fichiers XML et 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 à partir de la ligne de commande à utiliser avec Dynamics 365 Customer Engagement (on-premises) et Dataverse. Vous pouvez l’utiliser pour générer des classes .NET Framework à liaison anticipée (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 pac modelbuilder build de Power Platform CLI à la place.

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

Notes

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

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

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

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

Notes

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

Vous devez avoir la version 1.19.3 (ou plus récente) de Power Platform CLI installée sur votre ordinateur pour suivre ainsi que ces instructions. Commencez par utiliser la CLI pour obtenir de l’aide sur les outils. Power Platform

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

Pour plus d’informations : pac tool

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 au premier lancement. Pour plus d’informations : pac tool list

Téléchargeons et lançons 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).

Pour 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 commande pac tool <toolname> lance la dernière version installée de l’outil.

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

Mettre à jour les outils à l’aide de la CLI Power Platform

La mise à jour des outils installés est plus facile en utilisant Power Platform CLI. Jetons un coup d’œil à la liste d’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 de l’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 contiendrait des instructions sur la façon de mettre à jour l’outil. Par exemple, imaginons que PRT dispose d’une mise à jour. La colonne Statut indiquerait « Version plus récente disponible, exécutez pac tool PRT --update ».

Nous pouvons jeter un coup d’œil aux 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)

La CLI ne supprime pas les anciennes versions installées (mises en cache) des outils. Vous pouvez supprimer ces anciennes versions, en conservant la dernière version, en utilisant le paramètre --clear.

> pac tool <toolname> --clear

Utiliser Solution Packager depuis la CLI Power Platform

Bien que l’outil autonome Solution Packager puisse être téléchargé à partir de NuGet, cela n’est pas nécessaire. Vous pouvez utiliser la fonctionnalité Solution Packager intégrée à la 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 avec Package Deployer et Windows PowerShell

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).