Configuration des outils Salesforce DX

Salesforce DX ajoute des outils qui rationalisent l’ensemble du cycle de vie de développement. Il améliore la création et la collaboration des équipes, facilite les tests automatisés et l’intégration continue, et rend le cycle de publication plus efficace et agile.

Cependant, Salesforce DX est bien plus qu’un simple ensemble d’outils ! Il offre une alternative au développement d’ensembles de modifications et déplace la source d’informations fiables de l’organisation vers votre système de contrôle de version (VCS). Il réoriente votre objectif de développement, le faisant passer du développement organisationnel au développement de packages. Pour savoir comment migrer vos processus de développement existants vers le modèle de développement de packages, accédez au module Modèle de développement de packages.

Maintenant, trêve de bavardages. Êtes-vous prêt à vous lancer ? Commençons par configurer votre environnement et vous présenter quelques outils.

De nombreux outils Salesforce DX vous permettent d’utiliser un type d’organisation appelé organisation test. Une organisation test est un environnement Salesforce dédié, configurable et à court terme. Les organisations test stimulent la productivité et la collaboration des développeurs pendant le processus de développement, et facilitent la réalisation de tests automatisés ainsi que l’intégration continue. Vous pouvez utiliser la CLI ou les extensions Salesforce pour VS Code afin d’ouvrir votre organisation test dans un navigateur sans vous connecter. Vous pouvez créer une organisation test aux fins suivantes :

• Démarrer un projet.
• Démarrer une nouvelle branche de fonctionnalité.
• Tester une nouvelle fonctionnalité.
• Démarrer des tests automatisés.
• Effectuer des tâches de développement directement dans une organisation.
• Partir de zéro avec une toute nouvelle organisation.

Bien que les organisations test ont pour vocation d’être à usage unique, leurs fichiers de configuration constituent une ressource précieuse. Grâce au fichier de configuration, vous pouvez configurer l’organisation test avec différentes éditions Salesforce et avec uniquement les fonctionnalités et paramètres souhaités. Vous pouvez également partager le fichier de configuration de l’organisation test avec d’autres membres de l’équipe. De cette façon, vous disposez tous de la même organisation de base dans laquelle réaliser votre développement.

Un Dev Hub vous offre, à vous et à votre équipe, la possibilité de créer et de gérer des organisations test. Les organisations test sont des environnements Salesforce temporaires dans lesquels vous réalisez l’essentiel de votre travail de développement, conformément à ce modèle de développement fondé sur la source.

Pour démarrer avec les organisations test, vous allez choisir une organisation qui fera office pour vous de Dev Hub. Même si vous pouvez activer Dev Hub dans n’importe quelle organisation rémunérée, nous vous recommandons de ne pas effectuer vos tests dans un environnement de production. À la place, activez Dev Hub dans une organisation Developer Edition ou Trailhead Playground pour l’utiliser dans le cadre de ce module. Vous pouvez trouver vos Trailhead Playgrounds existants ou en créer un en cliquant sur votre photo de profil, puis en sélectionnant Hands-On Orgs (Organisations d’exercice).

1. Connectez-vous à l’organisation que vous avez choisie pour être votre Dev Hub.
2. Dans Setup (Configuration), saisissez Dev Hub dans la zone Quick Find (Recherche rapide) et sélectionnez Dev Hub.
3. Cliquez sur le bouton pour activer Dev Hub.

Vous pouvez également faire de n’importe quelle organisation payante votre Dev Hub et y octroyer l’accès aux développeurs. Pour plus d’informations, reportez-vous au guide du développeur Salesforce DX.

Maintenant que vous disposez d’une organisation Dev Hub, configurons le reste de vos outils Salesforce DX.

Utilisez Salesforce CLI pour contrôler le cycle de vie complet de vos applications. Vous pouvez créer facilement des environnements de développement et de test, synchroniser le code source entre vos organisations et votre VCS, et exécuter des tests.

Reportez-vous au Guide de configuration de l’interface de ligne de commande de Salesforce pour obtenir les instructions d’installation complètes.

1. Installez l’interface de ligne de commande à partir de https://developer.salesforce.com/tools/sfdxcli.
2. Vérifiez que la CLI est correctement installée et à jour en exécutant la commande suivante à partir de la ligne de commande.
   

   sf update

   Une sortie semblable à la suivante doit s’afficher : @salesforce/cli:Updating CLI…. La commande de mise à jour affiche ensuite les notes de publication de la version la plus récente.

Voici quelques autres commandes utiles pour vous aider à vous lancer :

sf org login web -h
sf org login web --help

De nombreux indicateurs de commande CLI disposent à la fois d’un nom long et d’un nom court. Par exemple, de nombreuses commandes emploient --target-org pour désigner une organisation, et le nom court de cet indicateur est -o. Par souci de clarté, nous présentons uniquement des noms d’indicateurs longs dans ce module, mais n’hésitez pas à utiliser leurs noms courts si vous le souhaitez. 

Continuons maintenant la configuration du reste des outils Salesforce DX.

Pour commencer, connectez-vous à Dev Hub à l’aide de la CLI afin d’être autorisé à créer des organisations test. Vous pouvez utiliser la commande org login web pour vous connecter à diverses organisations. Nous vous proposons quelques possibilités pour vous aider à gérer ces organisations.

1. Pour autoriser le Dev Hub, utilisez le flux de connexion Web :

   sf org login web --set-default-dev-hub --alias DevHub

   Spécifiez l’indicateur --set-default-dev-hub pour définir cette organisation comme Dev Hub par défaut. Utilisez l’indicateur --alias pour définir un alias pour l’organisation (utilisez un nom accrocheur, comme DevHub). Un alias est bien plus facile à mémoriser que le nom d’utilisateur unique du Dev Hub.
   
   Important : spécifiez l’indicateur --set-default-dev-hub uniquement pour votre Dev Hub. Si vous l’utilisez avec une autre organisation, vous ne pourrez pas créer d’organisations test tant que vous n’aurez pas correctement identifié le Dev Hub à l’aide de la commande config set.
   
   
2. Connectez-vous avec vos identifiants dans la fenêtre de navigateur qui s’ouvre.
   
   Une fois l’opération réussie, la CLI stocke de manière sécurisée le jeton ainsi que l’alias de l’organisation (DevHub, dans cet exemple). Vous pouvez fermer la fenêtre de navigateur de l’organisation Dev Hub à tout moment.

Par ailleurs, vous pouvez fermer le Dev Hub et créer tout de même des organisations test. Cependant, si vous souhaitez ouvrir l’organisation Dev Hub pour consulter les organisations test actives ou votre registre d’espace de noms, l’alias s’avère très pratique :

sf org open --target-org DevHub

Il est probable que vous ayez de nombreuses organisations, notamment des sandbox et votre organisation de production. Avec la CLI, vous pouvez également vous y connecter à l’aide de ces commandes. Lorsque vous vous connectez à une organisation à l’aide de la CLI, vous ajoutez cette organisation à la liste des organisations avec lesquelles la CLI pourra fonctionner à l’avenir.

sf org login web --instance-url https://MyDomainName--SandboxName.my.salesforce.com --alias FullSandbox
sf org login web --instance-url https://MyDomainName--SandboxName.my.salesforce.com --alias DevSandbox

N’oubliez pas : n’utilisez pas l’indicateur --set-default-dev-hub lors de la connexion à une sandbox. Si vous l’utilisez, la CLI pensera que l’organisation est votre Dev Hub, et un message d’erreur s’affichera lorsque vous essayerez de créer une organisation test.

Le pouvoir des alias

Comme vous pouvez l’imaginer, l’utilisation d’alias constitue un moyen puissant de gérer et de suivre vos organisations, et nous vous recommandons de vous en servir. Pourquoi ? Prenons l’exemple des noms d’utilisateur des organisations test. Le nom d’utilisateur d’une organisation test ressemble à ceci : test-7emx29rtpx0y@example.com. Vous conviendrez que cela n’est pas facile à retenir. Ainsi, lorsque vous envoyez une commande qui nécessite le nom d’utilisateur de l’organisation, le fait d’utiliser un alias dont vous vous souvenez peut accélérer le processus.

sf org open --target-org FullSandbox
sf org open --target-org MyScratchOrg
sf limits api display --target-org DevSandbox

• Documentation Salesforce : Guide de configuration Salesforce CLI
• Documentation Salesforce : Référence de commande de la Salesforce CLI
• Documentation Salesforce : Guide du développeur Salesforce DX
• Place de marché Visual Studio : Extensions Salesforce pour VS Code