Pour débuter avec SFDX, il est important de mettre en place certaines bases, afin de pouvoir utiliser une Scratch Org. On peut utiliser l’interface graphique de VSCode ou les lignes de commandes.

Il vous faudra une devhub (une organisation Salesforce qui vous permettra de créer des Scratch Org), si vous n’en avez pas vous pouvez créer une org de développement (gratuitement) : https://developer.salesforce.com/signup

Pour activer la Dev Hub dans une organisation :

• Connectez-vous à votre organisation Salesforce
• Dans la Configuration, saisissez dans la case Recherche rapide, puis sélectionnez “Dev Hub”.
• Pour activer la Dev Hub, cliquez sur Activer (une fois la Dev Hub activée, vous ne pouvez pas la désactiver.)

Il vous faudra :

• SFDX CLI : https://developer.salesforce.com/tools/sfdxcli
• VSCode : https://code.visualstudio.com/

Objectif de l’article :

• Créer un objet et un champ dans une Scratch Org.
• Récupérer l’objet et le champ (metadata) en local sur votre machine.
• Créer un champ en local puis le déployer sur la Scratch Org

Voici un exemple d’étapes à réaliser avec le CLI (ligne de commande):

0/ Connexion à votre DevHub

sfdx force:auth:web:login -r https://test.salesforce.com

(Pour vérifier si vous êtes bien connecté : sfdx force:org:list)

1/ Création du répertoire (de votre projet)

sfdx force:project:create –projectname nomDeVotreProjet –manifest

Passons à la création d’un champ sur l’objet que vous avez créé et une nouvelle fois faites un pull

6/ Création d’un champ depuis le local et envoi vers la Scratch Org

Vous pouvez copier-coller le fichier récupérer précédemment dans le même répertoire puis renommer le avec le nom que vous voulez, dans mon exemple j’ai besoin d’un nouveau champ Archive__c : Boolean.

Il faudra modifier l’intérieur du fichier pour correspondre à votre besoin :

sfdx force:source:push

Votre nouveau champ doit être présent dans votre Scratch Org, attention, il est possible que vous deviez faire des actions manuelles afin de donner les droits de visibilités sur le champ.

Si vous n’avez pas beaucoup de champ à créer, je vous conseille de passer par l’interface de Salesforce et de récupérer via un pull.

Le petit mot de la fin :

Voilà, les bases de SFDX ont été entrevues, très rapidement je vous l’accorde ! Il y a tellement à dire, ça sera l’occasion de faire d’autres articles.

Exemple, maintenant que nous avons ce code en local et que nous pouvons créer, développer en Scratch Org, comment tout déployer vers une sandbox/production ?!

Conseils:

Lorsque vous avez un doute sur une commande ou vous voulez consulter les paramètres disponibles de celle-ci, vous pouvez ajouter un « -h » à la fin de la commande pour avoir une aide détaillée.

Exemple :

sfdx force:org:create -f config/project-scratch-def.json -a nomDeLaScratchOrg -s -w 20 -h

Site pour apprendre l’écosystème Salesforce :

https://trailhead.salesforce.com/

Apprendre la création d’un objet :

https://trailhead.salesforce.com/fr/content/learn/modules/data_modeling/objects_intro

Fichier de création de Scratch Org automatisé :

setupScratchOrg.sh

echo ### Création de la Scratch Org ###
sfdx force:org:create -f config/project-scratch-def.json -a CartoTechno -s -w 20
sfdx force:data:record:update -s User -w "Name='User User'" -v "LanguageLocaleKey=en_US"
echo ### Pousser le code vers la Scratch Org ###
sfdx force:source:push -u CartoTechno
echo ### Ouvrir la Scratch Org ###
sfdx force:org:open -u CartoTechno

# Il est possible de rajouter autant de commandes que souhaité afin de gagner du temps lors de la création de la Scratch Org.