Installer et configurer les outils de développement

Cet article décrit comment installer et configurer les outils de finances et d’opérations Visual Studio requis dans votre environnement de développement local. Les instructions dans chaque section doivent être suivies dans l’ordre présenté dans cet article.

Important

Vous pouvez en savoir plus en regardant la présentation et les démos de la série Dynamics 365 FastTrack Tech Talk

Expérience de développement unifiée pour les finances et les opérations | Dynamics 365 FastTrack Tech Talk

Conditions préalables

• En tant que condition préalable, vous devez avoir accès à un environnement de bac à sable axé sur le développeur et approvisionné.
• Le rôle Administrateur système doit être attribué au compte d’utilisateur que vous utilisez pour le développement dans l’environnement de bac à sable.
• La machine de développement doit disposer d’au moins 16 Go d’espace libre sur le lecteur système local pour télécharger l’extension et les métadonnées.
• La machine de développement exécutant Microsoft Windows 10 ou 11 doit avoir Visual Studio 2022 installé avec au moins la charge de travail de développement de bureau .NET, le SDK de modélisation et quelques autres composants.
• Ce SDK et d’autres composants peuvent être sélectionnés et installés à partir du volet des composants individuels dans le Visual Studio programme d’installation. Consultez les composants Visual Studio requis.
• Microsoft SQL Server Express LocalDB est installé par défaut avec Visual Studio 2022, et vous devez valider que vous pouvez vous y connecter avec l’authentification Windows.

Installer l’extension Power Platform pour Visual Studio

Suivez les instructions de cet article pour installer l’extension à partir du Marketplace : Qu’est-ce que Power Platform tools pour Visual Studio. Il n’est pas nécessaire d’installer le profileur de plug-in, comme indiqué dans cet article.

Se connecter à votre environnement en ligne

Après avoir installé l’ Power Platform tools extension pour Visual Studio, suivez ces instructions pour vous connecter Visual Studio à votre environnement unifié axé sur les développeurs.

1. Lancez Visual Studio s’il n’est pas déjà en cours d’exécution.

2. Dans le menu Outils, sélectionnez Se connecter à Dataverse ou Télécharger les ressources Dynamics 365 FinOps.

   • Connecter pour Dataverse télécharger uniquement les ressources qui n’ont pas été téléchargées précédemment.
   • Téléchargez les ressources FinOps Dynamics 365 toujours téléchargées.

3. Sélectionnez les options souhaitées dans la boîte de dialogue et sélectionnez Connexion.

   Si vous devez utiliser un autre compte ou un autre environnement en ligne, ne choisissez pas d’utiliser l’utilisateur connecté. Saisissez les informations d’identification de votre compte utilisateur développeur avec accès à l’environnement en ligne.

4. Sélectionnez une solution disponible dans la boîte de dialogue, puis choisissez Terminé.

5. Recherchez l’environnement sandbox créé pour le développement en ligne dans la liste des Dataverse environnements et connectez-vous à celui-ci.

   Note

   Si vous n’avez qu’un seul environnement de développement en ligne, la boîte de dialogue de la liste d’organisations peut ne pas s’afficher car vous vous connectez automatiquement à l’environnement.

   

   Si votre compte nécessite une authentification multifacteur, décochez toutes les cases sur l’écran de connexion.

   Si vous vous connectez à un environnement de développement en ligne dans un client différent du vôtre, dans lequel votre nom d’utilisateur principal (UPN) est ajouté en tant qu’invité, mettez à jour Visual Studio>Outils>Options>Power Platform tools et sélectionnez Ignorer la découverte lors de la connexion à Dataverse et décochez toutes les cases du volet de connexion. Vous serez invité à fournir l’URI Dataverse.

   

   

   

Télécharger et installer l’extension et les métadonnées de finances et d’opérations

Après avoir installé l’ Power Platform Tools extension et vous être connecté à l’environnement de développeur unifié, une boîte de dialogue s’affiche pour télécharger l’extension Finances et opérations Visual Studio et les métadonnées.

Important

Vous pouvez configurer les paramètres à l’aide du paramètre Visual Studio Outils>Options>Power Platform Tools.

L’option Configuration automatique pour Dynamics 365... est activée par défaut. Cela garantit que vous n’avez pas besoin d’extraire manuellement les métadonnées du système ou de créer la configuration des métadonnées. L’outil le fera pour vous. Examinez le Visual Studio volet de sortie pour toute action utilisateur nécessaire.

Pensez à sélectionner l’option Ne pas afficher Power Platform Explorateur... pour accélérer la connexion à votre environnement et Télécharger les journaux... pour obtenir les journaux du déploiement et des opérations DBSync.

Pensez à désélectionner l’option Configuration automatique pour Dynamics 365 si vous utilisez un environnement unifié pour télécharger uniquement les ressources et effectuer la configuration manuellement.

Vous avez besoin d’au moins 16 Go d’espace libre sur le lecteur système local pour télécharger l’extension et les métadonnées.

Choisissez OK dans la boîte de dialogue pour démarrer le téléchargement. Visual Studio vous tient informé de la progression dans le Visual Studio volet de sortie.

Extraire les métadonnées du système

Note

Ceci n’est pas requis lorsque la configuration automatique est activée

Les actifs téléchargés se trouvent dans l’emplacement suivant :
C:\Users\<User>\AppData\Local\Microsoft\Dynamics365\<ApplicationVersion>

Les fichier Excel suivants sont téléchargés :

• DYNAMICSXREFDB.bak est une sauvegarde de la base de données de références croisées.
• Microsoft.Dynamics.FinOps.ToolsVS2022.vsix est l’extension Finances et opérations.
• PackagesLocalDirectory.zip sont les métadonnées du système.
• TraceParser.msi En savoir plus sur Trace Parser.

Débloquez l’un des trois fichiers à débloquer.

Décompresser le fichier PackagesLocalDirectory.zip comme PackagesLocalDirectory. Nous vous recommandons d’utiliser l’utilitaire 7zip pour accélérer l’extraction.

Installer l’extension de finances et d’opérations

Note

Ceci n’est requis que lorsque le Visual Studio volet de sortie l’indique.

À l’aide de l’Explorateur de fichiers Windows, depuis le dossier C:\Users\<User>\AppData\Local\Microsoft\Dynamics365\<ApplicationVersion>, ouvrez le Microsoft.Dynamics.FinOps.ToolsVS2022.vsix fichier pour installer l’extension.

Au premier démarrage de Visual Studio après la mise à jour/l’installation de l’extension Microsoft.Dynamics.FinOps.ToolsVS2022 VS, vous serez invité à accorder des autorisations élevées pour l’extension afin d’enregistrer l’URLProtocoloHandler, de configurer les cibles de build, d’extraire les fichiers du compilateur, etc.

Configurer l’extension de finances et d’opérations

Note

Ceci n’est pas requis lorsque la configuration automatique est activée. Si vous ne voyez pas l’option Configurer les métadonnées, ouvrez Extensions>Dynamics 365>Infolog et réessayez.

Pour configurer l’extension, procédez comme suit.

1. Démarrez Visual Studio, puis sélectionnez Continuer sans code dans la boîte de dialogue.

2. Accédez à Extensions>Dynamics 365>Configurer les métadonnées pour la première fois.

   

3. Dans le formulaire de configuration, sélectionnez Nouveau, puis créez une nouvelle configuration. Reportez-vous aux descriptions des champs fournies dans le tableau Descriptions des champs du formulaire de configuration qui suit cette procédure.

   

4. Sélectionnez Enregistrer.

5. Vous pouvez de la même manière modifier une configuration. Un champ courant à mettre à jour est le dossier contenant vos propres métadonnées personnalisées.

6. Vous souhaiterez peut-être également déplacer votre base de données de références croisées de la base de données locale du serveur SQL vers le serveur SQL et mettre à jour la configuration

7. Vous pouvez supprimer les configurations obsolètes.

8. Notez qu’une seule configuration peut être actuelle ou active à un moment donné.

Description des champs du formulaire de configuration

Champ de formulaire	Description
Nom	Nom de la configuration que vous créez maintenant.
Description	Description de la configuration que vous créez maintenant.
Serveur de base de données de références croisées	Définissez sur (localdb)\. si vous utilisez LocalDB, ou localhost si vous utilisez Microsoft SQL Server.
Nom de la base de données de références croisées	Nom de la base de données de références croisées. L’extension Visual Studio en crée une si elle n’existe pas.
Version de l’application à partir de laquelle restaurer la base de données de références croisées	Sélectionnez cela. Il est renseigné à partir des ressources téléchargées lorsque vous vous êtes connecté à l’environnement de développement unifié.
Dossier pour vos propres métadonnées personnalisées	Dossier où se trouvent (ou seront) vos propres modules X++.
Dossiers pour les métadonnées de référence	Doit contenir au moins le chemin d’accès où vous avez extrait le dossier PackagesLocalDirectory mentionné dans Extraire les métadonnées du système. Également où vous ajouteriez des dossiers contenant d’autres modules de référence ; par exemple ceux reçus des éditeurs de logiciels indépendants.

Résolution des problèmes de configuration

Si la Enregistrer Le bouton est toujours grisé après avoir rempli tous les champs, vous verrez des messages d’erreur avec une bordure rouge dans les info-bulles sur les champs avec des valeurs non valides.

Assurez-vous d’avoir saisi les valeurs correctes pour les champs contenant des erreurs. Par exemple, utilisez (localdb)\. si vous utilisez LocalDB. De plus, si vous utilisez LocalDB, vous devrez peut-être d’abord le configurer et le tester. Envisagez d’émettre la commande suivante à partir d’une invite de commande :

sqllocaldb create MSSQLLocalDB -s.

Pour plus d’informations : SQL Server Express LocalDB.

Note

Si la base de données de références croisées n’existe pas déjà, l’outil restaure la base de données à partir de la sauvegarde téléchargée dans C:\Users\<User>\AppData\Local\Microsoft\Dynamics365\<ApplicationVersion>. Vous verrez des notifications dans le volet Sortie de Visual Studio. Si vous devez le restaurer vous-même, vous pouvez le faire après le téléchargement avec la configuration automatique désactivée. Pour obtenir des instructions sur la restauration d’une base de données, reportez-vous à Restaurer sur SQL Server.

Terminer configuration

Une fois la configuration créée après une nouvelle installation de l’extension, vous pourriez recevoir une invite d’élévation en tant que Administrateur pour enregistrer le gestionnaire de protocole et extraire les fichiers du compilateur. Continuez et acceptez ces invites.

Une fois la configuration terminée, accédez à Afficher>Explorateur d’applications. Vous devriez voir la fenêtre Explorateur d’applications ouverte. Il faudra peut-être redémarrer Visual Studio d’abord.

Vous pouvez créer plusieurs configurations, mais vous devez en sélectionner une comme configuration actuelle. La configuration choisie prend effet sur les nouvelles instances de Visual Studio.

Synthèse

Félicitations ! Vous êtes maintenant prêt à créer, déployer, déboguer et tester vos modules X++ en utilisant l’environnement de développeur en ligne Power Platform. Explorez les possibilités avec la puissance des finances et des opérations intégrées à Power Platform.

Étapes suivantes

Commencez à écrire du code, à le déployer et à le déboguer.

Écrire, déployer et déboguer du code X++

Voir aussi

Expérience de développement unifiée pour applications de finances et d’opérations