Configurer votre environnement Salesforce DX

L ' Salesforce Developer Experience (DX) est un ensemble d'outils qui rationalise l'ensemble du cycle de vie du développement. Il améliore le développement et la collaboration des équipes, facilite les tests automatisés et l'intégration continue, et rend le cycle de publication plus efficace et plus agile.

Dans ce blog, nous allons voir pourquoi et comment configurer un environnement Salesforce sur une machine locale et apprenez à l'utiliser.

Pourquoi avons-nous besoin de l'environnement Salesforce DX?

Avant l'invention du composant Web Lightning nous pouvions utiliser la Developer Console pour créer des composants de programmation Apex comme Trigger , VisualForce et Lightning Pages. Mais la Developer Console ne dispose pas de fonctionnalité permettant de créer des composants Web Lightning. En plus de cette limitation, vous trouverez ci-dessous des limitations supplémentaires de la Developer Console:

• La saisie semi-automatique n'est pas disponible
• Chaque fois qu'après l'enregistrement, elle répond à la requête API
• Passer d'un onglet à un autre dans la console du développeur est un peu difficile lorsque vous ouvrez plus de classes Apex, de composants Lightning, etc.
• Le développement LWC n'est pas possible sur la Developer Console

Avantages de Salesforce DX

• Il contribue à améliorer la collaboration et le développement de l'équipe
• Il rend le processus de cycle de publication plus agile et efficace
• Il permet aux développeurs d'utiliser n'importe quel outil pour modifier le code tel que CLI, VIM, Sublime, Atom, etc.
• Facilite les tests automatisés de votre code et permet une intégration continue
• Nécessite un développement local configuration permettant aux développeurs d'acquérir une expertise pratique

Composants de Salesforce DX:

• VS Code: Visual Studio Code est l'éditeur de code incontournable pour les développeurs Salesforce. Il est gratuit, open source et disponible pour Windows, Linux et macOS. Cet éditeur possède des extensions faciles à installer pour la coloration syntaxique, la saisie semi-automatique du code, etc.
• Salesforce CLI (interfaces de ligne de commande): Salesforce CLI est une interface de ligne de commande puissante qui simplifie le développement et construit l'automatisation lorsque vous travaillez avec votre organisation Salesforce. Utilisez-le pour regrouper tous les outils dont vous avez besoin pour développer et exécuter des commandes sur votre organisation Salesforce. Synchronisez la source vers et depuis les organisations de zéro.
• Extensions dans VS Code: Les fonctionnalités que Visual Studio Code inclut prêtes à l'emploi ne sont que le début. Les extensions VS Code vous permettent d'ajouter des langages, des débogueurs et des outils à votre installation pour prendre en charge votre flux de travail de développement. Le modèle d'extensibilité riche de VS Code permet aux auteurs d'extensions de se connecter directement à l'interface utilisateur de VS Code et de contribuer aux fonctionnalités via les mêmes API que celles utilisées par VS Code. Le pack d'extension Salesforce comprend des outils de développement sur la plate-forme Salesforce dans l'éditeur de code VS léger et extensible. Ces outils fournissent des fonctionnalités pour travailler avec les organisations de développement (organisations scratch, sandbox et DE), Apex, les composants Aura et Visualforce.

Ce que nous allons faire

1. Configuration de l'environnement SFDX
2. Configuration de l'environnement VS Code
3. Configuration de Salesforce DX avec VS Code
4. Autorisation de récupération de l'organisation depuis l'organisation et déploiement dans l'organisation à l'aide du code VS

Configuration de l'environnement SFDX

Étape 1: Installez l'interface de ligne de commande à l'aide des liens ci-dessous

macOS: https://sfdc.co/sfdx_cli_osx

Windows 32 bits: https://sfdc.co/sfdx_cli_win

Windows 64 bits: ] https://sfdc.co/sfdx_cli_win64

Debian / Ubuntu 64: https://sfdc.co/sfdx_cli_linux

• Téléchargez l'archive à partir de l'une des URL du manifeste , extrayez l'archive, puis exécutez le script ./install

Debian / Ubuntu x86: https://sfdc.co/sfdx_cli_linux_x86

• Téléchargez l'archive à partir d'un des URL du manifeste, extrayez l'archive, puis exécutez le script ./install

Étape 2: Démarrez l'installation pour Windows

Étape 3: Sélectionnez le chemin d'installation

Étape 4: Attendez installation pour terminer

a)

b)

Étape 5: Vérifiez la version et conformez l'installation SFDX à partir de CMD.

Utilisez « sfdx –version » pour la version et « sfdx » pour la confirmation de l'installation. ( Remarque: Pour ouvrir l'invite de commande vous devez utiliser la recherche. Dans le champ de recherche de votre barre des tâches, entrez commande ou cmd . Ensuite , cliquez ou tapez sur le résultat de l'invite de commande .)

a)

b)

[19659002] Étape 6: Entrez la commande « sfdx force –help » pour prendre connaissance des différentes commandes disponibles avec son utilisation.

[19659002] Étape 7: Confirmez que vous avez installé les plugins sfdx, à l'aide de la commande « sfdx plugins ».

Étape 8: Si les plug-ins sfdx ne sont pas installés, exécutez la commande suivante: « plugins sfdx: installez salesforcedx @ pre-release ».

[19659002] Étape 9: Encore une fois, vérifiez en utilisant la commande suivante: « sfdx plugins ».

De cette façon, nous pouvons compléter l'installation de SFDX dans un environnement Windows. Maintenant, configurons le code VS.

Configuration de l'environnement VS Code

Si VS Code est déjà installé sur votre machine, vous pouvez ignorer ces étapes ou suivre les étapes suivantes.

Étape 1: Téléchargez et installez la configuration de VS Code à partir de l'URL suivante: https://code.visualstudio.com

Step 2: Installation du code VS

a)

b)

c)

d)

e)

f)

g)

h)

i)

[19659002] De cette manière, nous pouvons installer VS Code sur votre système.

Configurer Salesforce DX avec VS Code

Étape 1: Pour configurer Sa leforce dans VS Code, commencez par installer « Salesforce Extension Pack ».

Étape 2: Pour choisir un composant Web Lightning dans VS Code, vous devez d'abord installer « Lightning Web Components ».

Voici les étapes requises pour installer et configurer Salesforce DX sur votre système.

Créer un projet Salesforce DX via la palette de commandes

• Dans Visual Studio Code, ouvrez la palette de commandes en appuyant sur Ctrl + Maj + P sous Windows ou Cmd + Maj + P sur macOS
• Tapez SFDX
• Sélectionnez SFDX: Créer un projet
• Entrez HelloWorldLightningWebComponent comme nom de projet
• Appuyez sur Entrez
• Sélectionnez un dossier pour stocker le projet
• Cliquez sur Créer un projet . Vous devriez voir quelque chose comme ceci comme configuration de base:

Autorisez votre organisation non DevHub via la palette de commandes

• Dans Visual Studio Code, ouvrez la palette de commandes en appuyant sur Ctrl + Maj + P sous Windows ou Cmd + Maj + P sous macOS
• Tapez SFDX
• Sélectionnez SFDX: autoriser une organisation
• Sélectionnez le option de connexion en conséquence. Sélectionnez login.salesforce.com pour vous connecter à votre organisation de développement ou sélectionnez test.salesforce.com pour vous connecter au sandbox. Vous pouvez également utiliser une URL de domaine personnalisée pour vous connecter.
• Connectez-vous avec votre organisation.
• Si vous êtes invité à autoriser l'accès, cliquez sur Autoriser

[19659005] Une fois que vous vous êtes authentifié dans le navigateur, la CLI se souvient de vos informations d'identification. Le message de réussite doit ressembler à ceci:

Create a Lightning Web Component via Command Palette

• Dans Visual Studio Code, ouvrez la Command Palette en appuyant sur Ctrl + Shift + P sous Windows ou Cmd + Shift + P sous macOS
• Tapez SFDX
• Sélectionnez SFDX: Créer un composant Web Lightning
• Appuyez sur Entrée pour accepter la valeur par défaut force-app / main / default / lwc
• Entrez le nom souhaité comme nom du nouveau composant
• Appuyez sur Entrez
• Affichez les fichiers nouvellement créés dans Visual Studio Code

Déploiement du composant dans l'organisation

• Dans le code Visual Studio, sélectionnez le dossier default dans le projet ou le composant sélectionné
• Cliquez avec le bouton droit; vous verrez une option pour SFDX: Deploy Source to org . Sélectionnez-le.

Après un déploiement réussi, vous verrez le message suivant dans le terminal:

Notes: [19659132] Vérifiez que vous avez installé Java 8 ou Java 11 et configurez le chemin sur votre système.

Si vous ne parvenez pas à récupérer ou à déployer des composants et que vous obtenez « UNSUPPORTED_API_VERSION: Version d'API non valide spécifiée sur l'URL ”, puis exécutez la commande suivante:“ sfdx force: config: set apiVersion = 48.0 ”et sélectionnez-y la version précédente.

L'objectif principal de ce blog est de vous fournir une présentation et un moyen simple de configurer Salesforce DX sur un système utilisant VS Code. À l'aide de ce nouveau DX, nous pouvons créer des composants d'application Salesforce tels que des composants LWC, des composants d'éclairage ou tout autre développement dans l'organisation Salesforce.

Pour en savoir plus sur les outils de développement Salesforce à votre disposition, cliquez sur ici .

Visitez notre page Salesforce pour en savoir plus sur le partenariat Salesforce de Perficient et nos capacités avec la plate-forme.

À propos de l'auteur

Amit Behere est un consultant technique au sein de Perficient Nagpur GDC. Il est expérimenté dans le développement, l'analyse et la fourniture de solutions Salesforce. Il a également travaillé avec Mulesoft et Appian. Il est le chef de groupe du groupe de développeurs Amravati Salesforce. Il aime apprendre et enseigner.

Plus de cet auteur