Qu'est-ce que l'interface de ligne de commande Salesforce ? Comment l'installer sur Mac et Windows ?

Salesforce CLI – Un outil d'amélioration de la productivité pour les développeurs

La CLI Salesforce est également un outil robuste pour les administrateurs, pas seulement utile pour les développeurs. Vous pouvez l'utiliser pour créer et gérer des organisations, créer et installer des packages, synchroniser des sources vers et depuis des organisations, etc.

Ce détail n'est pas suffisant pour en savoir plus sur l'interface de ligne de commande Salesforce.

Cet article vous aidera à comprendre Salesforce CLI, ses étapes d'installation sur différents appareils, ses cas d'utilisation, comment l'utiliser et bien plus encore.

Qu'est-ce que l'interface de ligne de commande Salesforce ?

Lorsque vous travaillez avec Salesforce org (le conteneur pour toutes les données des clients Salesforce), une interface de ligne de commande qui facilite le développement et l'automatisation de l'artisanat est Salesforce CLI. La CLI Salesforce est également connue pour accélérer le processus de développement pour les administrateurs et les développeurs. Il s'agit d'un outil gratuit et open source de Salesforce qui facilite et automatise les tâches sur toute la plateforme.

Eh bien, les férus de technologie connaissent peut-être CLI, mais les utilisateurs non techniques trouveront cela déroutant.

En termes simples, une interface de ligne de commande est une interface textuelle permettant de développer un programme.

Vous devez entrer des commandes à l'aide d'un terminal et interagir avec le programme pour utiliser une CLI. Sur un Mac, ce serait un terminal, et sur Windows, c'est juste un terminal Windows.

En tant qu'interface textuelle, vous devez taper des commandes pour répondre à vos besoins. Ensuite, ces textes sont traités et exécutés par le programme. Ces travaux sont plus accessibles dans une interface textuelle que dans une interface graphique.

Une CLI facilite l'automatisation facile de tous les travaux répétitifs. Cependant, la courbe d'apprentissage d'une telle interface est plus abrupte car les invites visuelles ne sont pas présentes.

Installer l'interface de ligne de commande Salesforce

Sur ton ordinateur; vous pouvez installer l'interface de ligne de commande à l'aide d'artefacts spécifiques au système d'exploitation.

Vous pouvez choisir une méthode mentionnée ci-dessous sur votre ordinateur.

1. Installez la CLI sur macOS

Vous pouvez installer Salesforce CLI sur macOS à l'aide d'un fichier .pkg.

Étapes à suivre:

• Téléchargez le fichier .pkg .
• Exécutez le fichier .pkg, comme en double-cliquant dessus depuis le Finder, et répondez à toutes les invites. (L'installation se termine ici.)
• Ensuite, redémarrez vos IDE ou fenêtres de terminal pour vous assurer que les exécutables de la CLI Salesforce sont désormais disponibles.

Remarque : Le programme d'installation de macOS installe les exécutables sfdx et sf.

2. Installez la CLI sous Windows

Vous pouvez installer Salesforce CLI sous Windows à l'aide d'un fichier .exe.

Étapes à suivre:

• Téléchargez le fichier .exe .
• Exécutez le fichier .exe, comme en double-cliquant dessus depuis l'Explorateur Windows, et répondez à toutes les invites. (L'installation se termine ici.)
• Ensuite, redémarrez vos fenêtres PowerShell , les invites de commande ou les IDE pour vous assurer que les exécutables de la CLI Salesforce sont désormais disponibles.

Remarque : Le programme d'installation de Windows installe les exécutables sfdx et sf.

Avertissement de Salesforce

Salesforce CLI fonctionne de manière optimale dans l'invite de commande Windows native (cmd.exe) et Microsoft Windows PowerShell. Il n'est pas recommandé d'utiliser Salesforce CLI avec un émulateur de terminal Linux, comme le sous-système Windows 10 pour Linux, MinGW ou Cygwin, car la prise en charge des bogues est limitée.

3. Installez la CLI avec un fichier TAR

Salesforce CLI propose des fichiers TAR que l'on peut installer sur tous les systèmes d'exploitation pris en charge. Sous Linux, vous pouvez installer Salesforce CLI d'une seule manière, avec un fichier TAR.

Vous pouvez utiliser le tableau ci-dessous pour afficher les URL non versionnées du fichier TAR (.tar.xz ou .tar.gz) pour votre système d'exploitation. Lorsque Salesforce publie une nouvelle version de Salesforce CLI chaque semaine, ils mettent également à jour ces URL. De cette façon, ils sont toujours prêts avec la dernière version.

Les URL universelles sont particulièrement adaptées aux cas d'utilisation de la CLI.

Le tableau ci-dessous contient des URL de manifeste qui révèlent l'URL versionnée pour chaque ligne.

4. Installez la CLI avec npm

Vous pouvez utiliser npm pour installer Salesforce CLI si vous avez déjà installé Node.js sur votre ordinateur. Cette méthode vous permettra d'installer Salesforce CLI à partir de la ligne de commande et peut être particulièrement utile pour les cas d'utilisation d'intégration continue (CI).

Vous pouvez suivre cette méthode pour installer la CLI si :

• Vous ne disposez pas des autorisations d'administrateur sur votre poste de travail ou
• La stratégie de groupe bloque l'installation et les mises à jour de la CLI.

L'installation de la CLI avec npm n'a pas besoin d'autorisations root.

Étapes à suivre

Assurez-vous que la version de support à long terme de Node.js (Active LTS) est installée sur votre ordinateur.

• Pour installer la version LTS, passez à

Téléchargement

• Courir:

node –version (pour vérifier votre numéro de version)

• Courir:

 npm install sfdx-cli --global (to install the sfdx executable)

• Courir:

 npm install @salesforce/cli --global (to install the sf executable)

Lors de l'installation de la CLI à l'aide de npm, si vous obtenez une erreur d'autorisation, il est recommandé de ne pas utiliser sudu.

5. Installer les anciennes versions de Salesforce CLI

Il est recommandé d'utiliser la version candidate de Salesforce CLI ou la dernière version.

Évidemment, vous pouvez parfois avoir besoin d'une version plus ancienne de la CLI. Ainsi, pour cela, Salesforce publie des fichiers JSON qui répertorient les URL de téléchargement des dernières versions des programmes d'installation et des fichiers Tar pour chaque système d'exploitation pris en charge.

Chaque semaine, Salesforce ajoute une version récemment publiée à la liste ; la version reste sur la liste pendant environ 20 semaines. Ils conservent les fichiers TAR et d'installation pendant au moins 40 semaines.

Remarque : Salesforce conservera chaque ancienne version du package sfdx-cli npm.

6. Vérifiez votre installation

Pour vérifier si vous avez correctement installé l'installation de Salesforce CLI, vous devez la vérifier.

Étapes à suivre

• Exécutez la commande ci-dessous pour vérifier la version que vous avez installée :

 sfdx --version sfdx-cli/7.144.0 darwin-x64 node-v16.14.2

• Ensuite, exécutez la commande ci-dessous pour voir les plugins installés et leurs versions.

 sfdx plugins --core @oclif/plugin-autocomplete 0.3.0 (core) @oclif/plugin-commands 1.3.0 (core) @oclif/plugin-help 3.3.1 (core) @oclif/plugin-not-found 1.2.6 (core) @oclif/plugin-plugins 1.10.11 (core) @oclif/plugin-update 1.5.0 (core) @oclif/plugin-warn-if-update-available 2.0.4 (core) @oclif/plugin-which 1.0.4 (core) @salesforce/sfdx-plugin-lwc-test 0.1.7 (core) alias 1.2.1 (core) apex 0.11.0 (core) auth 1.8.1 (core) community 1.1.4 (core) config 1.3.23 (core) custom-metadata 1.0.12 (core) data 0.6.10 (core) generator 1.2.2 (core) info 1.3.1 (core) limits 1.3.0 (core) org 1.11.2 (core) salesforce-alm 54.0.2 (core) schema 1.1.0 (core) sfdx-cli 7.144.0 (core) source 1.9.0 (core) telemetry 1.4.0 (core) templates 54.3.0 (core) user 1.7.1 (core)

• Exécutez la commande ci-dessous pour afficher les notes de publication de votre version actuelle de Salesforce CLI :

 sfdx whatsnew

Utilisations de Salesforce CLI

Vous pouvez utiliser Salesforce CLI comme suit :

• Il permet d'accumuler les outils essentiels nécessaires au développement et d'effectuer des commandes.
• Vous pouvez l'utiliser pour créer et installer des packages.
• Les utilisateurs peuvent l'utiliser pour créer et exécuter des tests.
• Vous pouvez synchroniser des sources vers et à partir d'organisations zéro.
• Exporter et importer des données.
• Aussi, pour créer et gérer des organisations.

3 façons d'utiliser la CLI Salesforce

Examinons quelques scénarios et cas d'utilisation réels où l'on peut utiliser l'interface de ligne de commande Salesforce pour augmenter l'efficacité.

1. Récupérer et déployer les métadonnées

Prenons un scénario pour mieux comprendre.

Supposons que vous êtes un consultant Salesforce. Récemment, vous avez réalisé un projet incluant une création de flux contenue dans la barre d'utilitaires. L'objectif était d'aider les utilisateurs finaux à soulever rapidement des cas et des demandes d'assistance.

Vous avez réalisé le test utilisateur et l'avez déployé à l'aide des ensembles de modifications de l'environnement de test vers la production.

Plus tard, un scénario similaire est apparu dans un autre projet après quelques semaines avec quelques différences infimes. Malgré le redéveloppement de la même fonctionnalité, vous choisissez d'utiliser l'interface de ligne de commande Salesforce pour stimuler cette fonctionnalité en déployant votre solution connue et éprouvée pour l'organisation précédente avant de la modifier pour répondre aux exigences spécifiques du client.

2. Importer et exporter des données

Dans ce cas, vous disposez d'un environnement UAT exécuté sur un sandbox de copie partielle.

Vous avez développé un ensemble parfait de comptes de test et de contacts que vous souhaitez déplacer d'une copie partielle vers divers nouveaux bacs à sable de développement.

Bien que les types de sandbox soient différents, vous ne pouvez pas uniquement créer un nouveau sandbox en utilisant l'environnement UAT comme source.

Vous pouvez exporter les données, puis les importer dans vos bacs à sable de développement. Mais, vous devrez effectuer avec VLOOKUPS ou des identifiants externes dans Excel à chaque fois. Ce n'est pas évolutif et pas facile non plus.

Ainsi, vous pouvez utiliser la CLI Salesforce pour accélérer les choses et les rendre évolutives.

3. Création de bac à sable

La CLI comprend le

 force:org:create command

qui est utilisé pour créer des organisations test.

Vous pouvez également l'utiliser pour créer des bacs à sable. Et pour cela, vous devez utiliser divers paramètres principalement définis comme des paires clé-valeur dans votre commande.

Sommaire

J'espère que vous trouverez cet article utile pour en savoir plus sur Salesforce CLI et l'utiliser pour rationaliser vos tâches.

Vous pouvez contacter un consultant Salesforce pour obtenir plus de détails et accélérer votre processus de développement.