Premiers pas avec Apex
Objectifs de formation
Une fois cette unité terminée, vous pourrez :
- Définir ce qu’est le code
- Indiquer où il est possible de stocker et de modifier du code
- Décrire deux manières de créer des commentaires de code
- Expliquer pourquoi les commentaires de code sont importants
Saviez-vous que vous pouvez bénéficier des connaissances d’un expert ? Regardez cette vidéo pour en apprendre davantage sur les thèmes abordés dans ce module :
Vous souhaitez approfondir votre connaissance de l’environnement Salesforce pour en savoir plus sur le code Apex ? Vous êtes au bon endroit. Préparez-vous à être guidé pas à pas dans l’univers de la lecture et de l’écriture du code. Cela pourra vous paraître un peu effrayant au début, mais ne vous inquiétez pas, nous simplifierons pour vous tous les concepts, même les plus complexes.
En tant qu’administrateur, vous comprenez déjà les tenants et les aboutissants des fonctionnalités de Salesforce et leurs restrictions. Vous maîtrisez Flow Builder, qui vous permet d’automatiser les processus métiers, et vous avez à cœur d’élaborer les meilleures applications personnalisées pour vos clients. Au cours de ce module, vous découvrirez tout d’abord des concepts de programmation, puis des exemples que vous pourrez tester par vous-même.
Prêt à décoller ? C’est parti !
Qu’est-ce que le code ?
Le code est le langage que les humains utilisent pour communiquer avec les ordinateurs. Nous utilisons le code pour écrire un ensemble précis d’instructions permettant d’effectuer une action spécifique. Voyez le code comme une recette : chaque ingrédient et chaque instruction doivent être exacts pour que le plat soit réussi.
Tout comme différentes langues sont parlées autour du monde, les ordinateurs utilisent différents langages, tels que JavaScript, Java, Ruby, Python et bien d’autres encore. Bien que les langages de programmation présentent de nombreuses différences, ils reposent tous sur les mêmes structures de base et peuvent tous être interprétés par un ordinateur pour créer des applications. En avançant dans votre apprentissage du langage de programmation Apex, vous commencerez à mieux comprendre les structures de programmation.
Emplacement de stockage du code Apex
Vous vous demandez probablement par où commencer. Tout d’abord, nous devons déterminer où stocker notre code. Sachez que le code est stocké dans des fichiers. Ces derniers peuvent être hébergés de manière locale (sur votre PC ou Mac), dans le Cloud (votre organisation Salesforce), ou bien être à la fois enregistrés localement et synchronisés automatiquement vers le Cloud. Pas mal, non ?
La Developer Console
En tant qu’administrateur, vous avez probablement entendu parler de la Developer Console. Il s’agit d’un outil que les développeurs utilisent pour créer et modifier des fichiers de code. Tout au long de ce module, nous utiliserons la Developer Console pour stocker et exécuter du code dans votre organisation Salesforce. Examinons cela d’un peu plus près.
Pour accéder à la Developer Console, procédez comme suit :
- Tout d’abord, assurez-vous d’être connecté à Trailhead.
- Ensuite, cliquez sur votre avatar d’utilisateur dans le coin supérieur droit de la page et sélectionnez Organisations d’exercice dans le menu déroulant.
- Cliquez sur le nom d’utilisateur pour lancer votre organisation. Vous souhaitez créer une nouvelle organisation ? Consultez le module Gestion des Trailhead Playgrounds pour obtenir plus d’informations à ce sujet.
- Dans votre organisation Trailhead Playground, cliquez sur
, puis sélectionnez Developer Console.
Gardez la Developer Console ouverte. Nous l’utiliserons tout au long de ce module pour tester le code.
Écriture du pseudo-code
La planification est la partie la plus importante des projets auxquels vous participez en tant qu’administrateur Salesforce. Elle vous aide à comprendre les besoins de vos clients, à organiser vos idées et à prévoir les problèmes que vous pourriez rencontrer lors du développement de l’application.
Lors de la planification du projet, les développeurs écrivent un pseudo-code avant de commencer à écrire du code Apex. Le pseudo-code est une description détaillée mais lisible de ce qu’un programme ou une fonctionnalité doit faire. Il est écrit en langage naturel et non en langage de programmation. Le pseudo-code permet aux non-programmeurs de passer en revue les différentes étapes pour confirmer que le code proposé satisfait aux cahier des charges pour l’application. Les développeurs peuvent écrire du pseudo-code dans des documents distincts, sur des tableaux blancs, ou encore dans la Developer Console.
Pour comprendre comment l’écriture de pseudo-code aide les développeurs à organiser leurs idées pour programmer une application, écrivons un pseudo-code décrivant la préparation d’un thé pour des amis.
- Dans la Developer Console, choisissez Fichier | Nouveau | Classe Apex.
Remarque
Ne vous préoccupez pas de comprendre ce qu’est une classe pour l’instant. Vous en apprendrez davantage sur les classes Apex dans un module plus avancé. Pour le moment, considérez ce fichier comme un fichier texte.
- Nommez la classe
Teatime. - Cliquez sur OK.
- Après avoir nommé la classe, une fenêtre contenant une nouvelle classe apparaît.
- Copiez et collez les instructions suivantes au-dessus de la classe existante :
Get Utensils and Ingredients Boil Water in a Tea Kettle Make Tea in Teapot Add Tea and Sugar to a Teacup Serve Tea to Friend
Chaque instruction de pseudo-code doit énoncer une action. Si vous donniez ces instructions à un robot, pensez-vous qu’il pourrait effectuer chaque étape correctement ?
Probablement pas. Le robot aurait besoin de savoir quels ustensiles employer, quels ingrédients utiliser et en quelle quantité, ainsi que comment faire bouillir l’eau. Ce pseudo-code doit donc être plus détaillé.
- Revenez dans la Developer Console.
- Remplacez le code existant par le code suivant :
Get Utensils and Ingredients Get Teacup Get Spoon Get Tea Kettle Get Teapot Get Tea Get Sugar Boil water in a Tea Kettle Fill Kettle with Water Switch Kettle On Wait for Kettle to Boil Make Tea in Teapot Put Tea in Teapot Put Boiling Water in Teapot Wait 2 Minutes Add Tea and Sugar to Teacup Pour Tea in Teacup Put 1 teaspoon of Sugar in Teacup Stir Tea in Teacup Serve Tea to a Friend public class Teatime { }
Lorsque vous écrivez du pseudo-code, procédez étape par étape et décomposez-les autant que possible pour tenir compte de toutes les possibilités. Par exemple, ce pseudo-code indique de remplir d’eau la bouilloire. Imaginons maintenant que la bouilloire est déjà pleine. Le robot doit-il continuer à remplir d’eau la bouilloire ? Doit-il la vider ? Lorsque vous réfléchissez comme un développeur, vous devez tenir compte de différents points de vue et envisager de multiples possibilités.
Commentaire de code
En tant qu’administrateur, avez-vous déjà vu un champ personnalisé sans description ? À moins que ce champ ait un nom très clair et descriptif, sa fonction peut ne pas être évidente. En code, les commentaires décrivent la fonction d’un bloc de code (une ou plusieurs lignes de code). Les commentaires aident les développeurs à savoir quel code écrire, ce que fait le code existant et ce que le code défaillant est censé faire. Les développeurs intègrent des commentaires dans le code en les encadrant de caractères spéciaux pour indiquer à l’ordinateur de ne pas les lire ni les exécuter.
Examinons deux manières de commenter du code : les commentaires sur une seule ligne et les commentaires sur plusieurs lignes.
Commentaires sur une seule ligne
Les commentaires sur une seule ligne commencent par deux barres obliques (//). Lorsqu’il s’exécute, le programme informatique ignore les caractères se trouvant à droite des // sur la même ligne. Exemple :
Integer i = 1; //This comment will be ignored when the code is run.
Commentaires sur plusieurs lignes
Les commentaires sur plusieurs lignes commencent par une barre oblique suivie d’un astérisque (/*) et se terminent par un astérisque suivi d’une barre oblique (*/). Exemple :
Integer i = 1; /*This comment is
ignored when the
code runs*/
Remarque
Avez-vous remarqué que chaque ligne est en retrait dans le commentaire sur plusieurs lignes ? L’utilisation de retraits améliore la lisibilité et est fortement recommandée.
Transformons le pseudo-code Teatime en commentaire. Pour développer le code correctement, il est recommandé d’écrire votre pseudo-code comme vous rédigeriez un plan.
- Dans la Developer Console, ajoutez des commentaires sur plusieurs lignes au pseudo-code. Ils doivent ressembler à ce qui suit :
/*Get Utensils and Ingredients Get Teacup Get Spoon Get Tea Kettle Get Teapot Get Tea Get Sugar Boil water in a Tea Kettle Fill Kettle with Water Switch Kettle On Wait for Kettle to Boil Make Tea in Teapot Put Tea in Teapot Put Boiling Water in Teapot Wait 2 Minutes Add Tea and Sugar to Teacup Pour Tea in Teacup Put 1 teaspoon of Sugar in Teacup Stir Tea in Teacup Serve Tea to a Friend*/ public class Teatime { } - Cliquez sur Fichier | Enregistrer.
Dans ce module, vous allez apprendre à suivre les meilleures pratiques d’écriture du code Apex. Vous acquerrez ainsi des bases solides, qui vous permettront de devenir un développeur extraordinaire.
Maintenant que vous avez un peu d’expérience, il est temps pour vous de plonger dans le vif du sujet et de commencer à coder.