Lancement du générateur de code
Objectifs de formation
Une fois cette unité terminée, vous pourrez :
- Accéder à l’application Générateur de code dans votre organisation
- Vous connecter à votre organisation avec le générateur de code
- Exécuter une requête SOQL
Ouverture de l’application Générateur de code
Le générateur de code est installé et l’autorisation CodeBuilderGroup a été accordée. Accédons au tableau de bord du générateur de code et lançons-le
- Dans le lanceur d’application (), cherchez et sélectionnez Code Builder (Générateur de code).
- Cliquez sur Launch (Lancer).
La première fois que vous lancez le générateur de code, il exécute un processus de configuration qui prend un certain temps. Le message ci-dessous s’affiche : « Code Builder is loading… » (Le générateur de code est en cours de chargement…) Certaines alertes peuvent s’afficher, que vous pouvez ignorer.
Le générateur de code s’ouvre avec un nouveau projet Salesforce DX déjà lancé. La structure du fichier est affichée dans l’explorateur à côté de la barre d’activité. Actuellement, aucune des métadonnées ou aucun des fichiers de votre organisation n’est chargé dans le projet. Nous aborderons ce point plus tard.
Découverte de la barre d’activité
Le menu se compose de huit options principales.
Option |
Description |
---|---|
Explorateur |
Affiche la structure des répertoires et tous les fichiers que vous avez extraits de l’organisation autorisée vers votre projet local. |
Rechercher |
Vous permet de rechercher des éléments dans le projet. Pour rechercher des éléments dans votre organisation autorisée, vous devez d’abord les télécharger avec le navigateur d’organisation. |
Contrôle de la source |
Gère une liste des mises à jour des fichiers de votre projet. Cette option est généralement associée à GitHub. |
Exécuter et déboguer |
Vous permet d’exécuter du code, de définir des points de contrôle, de surveiller les valeurs des variables et d’afficher la pile d’exécution. |
Extensions |
Affiche toutes les extensions que vous pouvez ajouter au générateur de code pour améliorer votre code. Les principales extensions Salesforce sont préchargées dans le générateur de code. |
Test |
Vous permet d’exécuter des tests Apex et de composants Web Lightning, et de surveiller les résultats. |
Générateur de code |
Permet d’accéder au panneau de ressources du générateur de code avec des liens rapides, des guides de démarrage rapide, des vidéos et des liens vers Trailhead et la documentation d’aide. |
Navigateur d’organisation |
Renvoie à l’ensemble des métadonnées et fichiers de l’organisation autorisée. Depuis le navigateur d’organisation, vous pouvez télécharger les métadonnées sur lesquelles vous souhaitez travailler. |
Différences entre organisations |
Affiche les conflits ou les différences entre les organisations si Detect Conflicts at Sync (Détecter les conflits lors de la synchronisation) est activé. |
Autorisation de votre organisation
Afin d’afficher les métadonnées ou les fichiers de votre organisation, vous devez autoriser le générateur de code à accéder à l’organisation à l’aide de vos identifiants. Vous pouvez autoriser n’importe quelle organisation (production, sandbox ou test) à l’aide de votre nom d’utilisateur et de votre mot de passe.
- Si la page d’accueil s’affiche, cliquez sur Connect an Org (Connecter une organisation).
Sinon, appuyez simplement sur les touches Ctrl + Maj + P (Windows) ou Command + Maj + P (Mac) pour ouvrir la palette de commandes. SaisissezSFDX
et sélectionnez SFDX : autoriser une organisation.
- Pour le type d’organisation, sélectionnez Production afin de pouvoir vous connecter à un Trailhead Playground.
- Pour l’alias, saisissez
CBTrailhead
et appuyez sur la touche Retour (MacOS) ou Entrée (Windows).
Vous pouvez avoir plusieurs autorisations, alors créez des alias uniques pour pouvoir les distinguer facilement.
Un écran de connexion spécial réservé au générateur de code s’ouvre avec un code pré-rempli pour vous.
- Cliquez sur Se connecter.
- Connectez-vous à l’aide de votre nom d’utilisateur et de votre mot de passe associés à l’organisation que vous autorisez.
- Cliquez sur Autoriser.
- Cliquez sur Continuer.
Vous êtes maintenant connecté à une organisation et son nom est visible dans la barre d’état en bas de la fenêtre du générateur de code.
Affichage des métadonnées de l’organisation
Voilà qui est parfait ! Vous êtes connecté à votre organisation. Incorporons maintenant quelques métadonnées et fichiers de l’organisation dans votre projet DX du générateur de code avec lesquels travailler.
- Dans la barre d’activité, sélectionnez le navigateur d’organisation ().
- En haut du panneau du navigateur d’organisation, cliquez sur SFDX Refresh Types (Types d’actualisations SFDX) ().
- Faites défiler l’écran et sélectionnez Custom Objects (Objets personnalisés).
- Sélectionnez Retrieve Source from Org (Récupération de la source à partir de l’organisation) () pour Account (Compte).
Les fichiers de métadonnées se trouvent désormais dans votre projet du générateur de code. Examinons-les de plus près.
- Sélectionnez Explorer ().
- Sélectionnez force-app.
- Sélectionnez objects (objets).
Voici les fichiers que vous avez récupérés ! Mais attendez, il y a beaucoup de fichiers seulement pour Account (Compte). Effectivement, chaque objet possède des fichiers de métadonnées pour tous ses attributs. Vous pouvez consulter un fichier pour voir chacun de ses champs, listViews et même son fichier principal Account.object-meta.xml.
Vous savez maintenant comment afficher et récupérer des métadonnées et des fichiers d’une organisation autorisée. Mais qu’en est-il des données ? SOQL Builder est un outil formidable pour consulter les enregistrements de l’organisation.
Affichage des enregistrements avec SOQL Builder
SOQL signifie Salesforce Object Query Language, autrement dit, Langage de requête d’objet Salesforce. Il s’agit d’un langage de commande simple qui facilite la récupération des enregistrements d’une organisation Salesforce. Il vous permet de faire beaucoup de choses. Jetez un œil au badge Trailhead SOQL pour les administrateurs pour en savoir plus sur la façon dont vous pouvez utiliser SOQL. Mais pour l’instant, explorons simplement certains enregistrements de votre organisation.
- Appuyez sur la combinaison de touches Ctrl + Maj + P (Windows) ou Command + Maj + P (Mac) pour ouvrir la palette de commandes.
- Saisissez
SOQL
et sélectionnez SFDX : Create Query in SOQL Builder (Créer une requête dans SOQL Builder).
- Dans le champ From (De), saisissez
cont
et sélectionnez Contact.
- Dans Fields (Champs), saisissez
id
et sélectionnez Id.
- Saisissez un autre champ : Name (Nom).
Observez la requête SOQL apparaître en fonction des valeurs de champ que vous sélectionnez.
- Cliquez sur Run Query (Exécuter la requête) pour afficher les résultats.
- Fermez SOQL Builder et cliquez sur Save (Enregistrer) pour enregistrer la requête ou sur Don’t Save (Ne pas enregistrer) pour la supprimer.
SOQL Builder vous permet de faire beaucoup de choses. Assurez-vous de consulter la page Developers SOQL Builder pour obtenir plus d’informations sur l’outil et vos enregistrements.
Maintenant que vous disposez d’un moyen simple de configurer et d’utiliser le générateur de code, poursuivez sur votre lancée et donnez à vos utilisateurs les moyens de s’attaquer à du code, ou explorez-le vous-même pour découvrir toutes les façons étonnantes d’afficher vos enregistrements et les enregistrements connectés sans limitations. Apprenez-en davantage à ce sujet dans les ressources.