Skip to main content
La Trailblazer Community sur Slack est maintenant en bêta ouverte. Rejoignez-la et échangez en temps réel. Rejoignez-nous sur Slack

Premiers pas avec Apex

Objectifs de formation

Une fois cette unité terminée, vous pourrez :

  • Présenter les principales fonctionnalités du langage de programmation Apex
  • Enregistrer une classe Apex et des méthodes d’appel avec un code Apex anonyme
  • Utiliser la console Web pour inspecter les journaux de débogage
Remarque

Remarque

Vous souhaitez apprendre en français ? Commencez le défi dans un Trailhead Playground en français et utilisez les traductions fournies entre crochets pour naviguer. Copiez et collez uniquement les valeurs en anglais, car les validations de défi reposent sur les données en anglais. Si vous ne réussissez pas le défi dans votre organisation en français, nous vous recommandons (1) de définir le paramètre régional sur les États-Unis, (2) de définir la langue sur l’anglais en suivant les instructions ici, puis (3) de cliquer à nouveau sur le bouton « Vérifier le défi ».

Consultez le badge Trailhead dans votre langue pour découvrir comment profiter de l’expérience Trailhead traduite.

Avant de commencer

Nous sommes ravis de vous accompagner dans votre parcours avec Apex. Bien que ce module couvre les informations de base sur le langage de programmation, il aborde également rapidement des sujets approfondis. Si ce module constitue votre premier contact avec Apex, nous vous recommandons fortement de commencer par le projet Prise en main rapide : Apex. Ensuite, revenez ici. Nous vous attendrons !

Qu'est-ce qu'Apex ?

Apex est un langage de programmation qui utilise une syntaxe de type Java et agit de la même façon que des procédures stockées de base de données. Apex permet aux développeurs d’ajouter une logique métier à des événements système, par exemple des clics sur des boutons, des mises à jour d’enregistrements associés et des pages Visualforce.

En tant que langage, Apex est :

  • Hébergé : Apex est enregistré, compilé et exécuté sur le serveur, Salesforce Platform.
  • Orienté objet : Apex prend en charge les classes, les interfaces et l’héritage.
  • Fortement typé : Apex valide des références à des objets lors de la compilation.
  • Respectueux de la mutualisation : Apex étant exécuté sur une plate-forme mutualisée, il empêche l’emballement du code en imposant des limites. Ces limites permettent d’éviter que le code ne monopolise les ressources partagées.
  • Intégré à la base de données : il est extrêmement facile d’accéder à des enregistrements et de les manipuler. Apex offre un accès direct aux enregistrements et à leurs champs, et fournit des instructions et des langages de requête pour manipuler ces enregistrements.
  • Orienté vers les données : Apex offre un accès transactionnel à la base de données, qui permet de restaurer les opérations.
  • Facile à utiliser : Apex s’appuie sur les idiomes Java habituels.
  • Facile à tester : Apex fournit une prise en charge intégrée de création de tests unitaires, d’exécution et de couverture de code.
  • Doté de versions gérées : un code Apex personnalisé peut être sauvegardé dans différentes versions de l’API.

Apex est un langage de programmation s’appuyant sur le Cloud

Présentation du langage Apex

Comme les autres langages de programmation s’appuyant sur le Cloud, Apex prend en charge certaines constructions de langage :

  • classes, interfaces, propriétés et collections (listes, cartes et ensembles).
  • Notation d'objet et de tableau.
  • Expressions, variables et constantes.
  • Instructions conditionnelles (if-then-else) et instructions de contrôle de flux (boucles for et boucles while).

Contrairement aux autres langages de programmation orientés objet, Apex prend en charge :

  • Le développement Cloud quand Apex est stocké, compilé et exécuté dans le Cloud.
  • Les déclencheurs, qui s’apparentent aux déclencheurs des systèmes de base de données.
  • Les instructions de base de données, qui permettent d'émettre des appels directs à la base de données, et des langages de requête pour interroger et rechercher des données.
  • Les transactions et les restaurations.
  • Le modificateur d'accès global, qui est plus permissif que le modificateur public et autorise l'accès entre les espaces de nom et les applications.
  • La gestion des versions d'un code personnalisé.

De plus, le langage Apex n'est pas sensible à la casse.

Outils de développement

Vous pouvez écrire et déboguer du code Apex sur votre ordinateur client à l’aide des extensions Salesforce pour Visual Studio Code. Reportez-vous à Développement facile avec les extensions Salesforce.

Vous pouvez également écrire du code Apex et accéder aux informations de débogage directement dans le navigateur en utilisant l’interface utilisateur de Salesforce. La console Web est un environnement de développement intégré (EDI) moderne, léger et basé sur un navigateur, conçu pour combler l’écart entre les outils hérités obsolètes et les environnements de développement à forte charge. Pour en savoir plus, consultez la documentation développeur de la console Web.

Ouvrez la console Web à partir du menu d’accès rapide (Icône d'engrenage de configuration).

Console Web

Présentation des types de données

Apex prend en charge plusieurs types de données, dont un propre à Salesforce : le type de données sObject.

Apex prend en charge les types de données suivants :

  • Un primitif, notamment de type Entier, Double, Long, Date, Date/heure, Chaîne, ID ou Booléen, entre autres.
  • Un sObject, qu’il s’agisse d’un sObject générique ou d’un sObject spécifique, tel qu’un compte, un contact ou un MyCustomObject__c. (Vous en apprendrez davantage sur les sObjects dans une autre unité.)
  • Une collection, qui comprend :
    • Une liste, à savoir une collection ordonnée et indexée d’éléments. Les éléments d’une liste peuvent être de n’importe quel type de données, y compris les types de primitifs, les collections, les sObjects, les types définis par l’utilisateur et les types Apex fournis par le système (intégrés).
    • Un ensemble, à savoir une collection non ordonnée d’éléments. Les éléments d’un ensemble peuvent également être de n’importe quel type de données et ne peuvent pas contenir de valeurs en double.
    • Une carte, à savoir une collection de paires clé-valeur pouvant être de n’importe quel type de données.
  • Une liste de valeurs saisies, également appelée enum
  • Des classes Apex définies par l’utilisateur (personnalisées)
  • Des classes Apex fournies par le système (intégrées)

Collections Apex : syntaxe List

Les listes contiennent une collection ordonnée de données du même type.

Les deux déclarations suivantes sont équivalentes. La variable colors est déclarée en utilisant la syntaxe List.

List<String> colors = new List<String>();

De même, la variable colors peut être déclarée en utilisant la notation de tableau.

String[] colors = new List<String>();

Augmentez les collections selon vos besoins en utilisant la méthode List.add() pour ajouter de nouveaux éléments. Vous pouvez utiliser la notation de tableau entre crochets pour référencer des éléments existants dans la collection par index. Cependant, vous ne pouvez pas utiliser la notation de tableau entre crochets pour ajouter d’autres éléments.

Cet exemple montre comment ajouter des éléments à une liste lors de sa création, puis utiliser la méthode add() pour ajouter plus d’éléments.

// Create a list and add elements to it in one step
List<String> colors = new List<String> { 'red', 'green', 'blue' };
// Add elements to a list after it has been created
List<String> moreColors = new List<String>();
moreColors.add('orange');
moreColors.add('purple');

Les éléments de liste peuvent être lus en spécifiant un index entre crochets, appelé notation de tableau. Vous pouvez également utiliser la méthode get() pour lire un élément de liste. Cet exemple s’appuie sur les listes créées dans l'exemple précédent et montre comment lire des éléments de liste en utilisant l'une ou l'autre méthode. L’exemple montre également comment itérer sur des éléments de liste.

// Get elements from a list
String color1 = moreColors.get(0);
String color2 = moreColors[0];
System.assertEquals(color1, color2);
// Iterate over a list to read elements
System.debug('Print out the colors in moreColors:');
for(String color : moreColors) {
    // Write value to the debug log
    System.debug(color);
}

Au-delà des concepts de base

Apex prend en charge deux autres types de collection : Set (Ensemble) et Map (Mappage). Pour plus d’informations, reportez-vous à la section Collections du guide du développeur Apex.

Classes Apex

L'un des avantages des classes Apex est la réutilisation du code. Des méthodes de classe peuvent être appelées par des déclencheurs et d'autres classes. Le didacticiel ci-dessous présente l’enregistrement d’un exemple de classe dans votre organisation, l’utilisation de cette classe pour mettre à jour les descriptions de compte et l’inspection des journaux de débogage.

Enregistrement d'une classe Apex

La classe AccountProcessor possède une méthode publique updateAccountDescriptions(). Cette méthode prend une liste de comptes et met à jour leur description selon le format spécifié dans la méthode helper privée applyStandardFormatting(). Vous ne pouvez pas appeler les méthodes helper privées de l’extérieur ; elles doivent être appelées depuis l’intérieur de la classe. La classe AccountProcessor contient également la méthode helper privée inspectResults(), qui inspecte les résultats de l’opération de mise à jour de la base de données.

Enregistrez la classe AccountProcessor dans votre organisation Trailhead.

  1. Ouvrez la console Web à partir du menu d’accès rapide (Icône d’engrenage de configuration).
  2. Dans la console Web, appuyez sur la combinaison de touches Ctrl + Maj + P (Windows) ou ⌘ + Maj + P (macOS) pour ouvrir la palette de commandes.
  3. Saisissez SFDX: Create Apex Class (SFDX : créer une classe Apex) et appuyez sur Entrée.
  4. Pour le type de modèle, sélectionnez DefaultApexClass, puis appuyez sur Entrée.
  5. Pour le nom de la classe, saisissez AccountProcessor, puis appuyez sur Entrée.
  6. Pour le répertoire de sortie, sélectionnez force-app/main/default/classes, puis appuyez sur Entrée.
  7. Remplacez le corps de classe par défaut par l’exemple de classe AccountProcessor.
public with sharing class AccountProcessor {
    /**
     * Applies a standard formatting to the descriptions of accounts in the list,
     * and updates each account.
     */
    public void updateAccountDescriptions(List<Account> acctList) {
        if (acctList == null || acctList.isEmpty()) {
            System.debug('Account list is null or empty.');
            return;
        }
        for (Account acc : acctList) {
            applyStandardFormatting(acc);
        }
        Database.SaveResult[] srList = Database.update(acctList,
false,
AccessLevel.USER_MODE);
        inspectResults(srList);
    }
    /**
     * Private helper method to handle the description formatting logic.
     */
    private static void applyStandardFormatting(Account acc) {
        String timestamp = String.valueOf(Datetime.now());
        if (String.isBlank(acc.Description)) {
            acc.Description = 'Account updated on: ' + timestamp;
        } else {
            acc.Description += ' | Last processed: ' + timestamp;
        }
    }
    /*
     * Private helper method to inspect the returned results.
     */
    private static void inspectResults(Database.SaveResult[] results) {
        for (Database.SaveResult sr : results) {
            if (sr.isSuccess()) {
                System.debug('Successfully updated account. Account ID: ' + sr.getId());
            } else {
                for (Database.Error err : sr.getErrors()) {
                    System.debug('The following error has occurred.');
                    System.debug(err.getStatusCode() + ': ' + err.getMessage());
                    System.debug('Account fields that affected this error: ' +
err.getFields());
                }
            }
        }
    }
}
  1. Pour enregistrer votre classe, appuyez sur Ctrl + S (Windows) ou ⌘ + S (macOS).

Salesforce compile et déploie votre classe lorsque vous l’enregistrez.

Note

Si votre classe contient des erreurs, le déploiement échouera lorsque vous tenterez de l’enregistrer. Vous pouvez afficher des informations sur les erreurs dans le panneau Output (Sortie) situé en bas de la fenêtre Web Console (Console Web).

Au-delà des concepts de base

La classe que vous venez d'enregistrer utilise une programmation orientée objet (OOP). La classe encapsule les méthodes associées à la gestion de la messagerie. Pour être un parfait exemple d'OOP, la classe devrait également contenir des variables membres (attributs) et des méthodes accesseur pour accéder à ces attributs. Toutefois, par souci de simplification notre classe n'en contient pas.

Appeler une méthode pour mettre à jour la description d’un compte

Invoquons la méthode publique. Pour cela, utilisons une exécution Apex anonyme. Un Apex anonyme permet d’exécuter sur le champ des lignes de code. Cela est pratique pour invoquer Apex, notamment afin de tester des fonctionnalités. Les résultats sont générés dans le journal de débogage, comme avec toute autre exécution Apex.

Note

Il existe d'autres méthodes pour invoquer Apex, via des déclencheurs par exemple. Nous présentons les déclencheurs dans un autre module.

  1. Dans la console Web, appuyez sur la combinaison de touches Ctrl + Maj + P (Windows) ou Command + Maj + P (macOS) pour ouvrir la palette de commandes.
  2. Saisissez SFDX: Create Anonymous Apex Script (SFDX : créer un script Apex anonyme) et appuyez sur Entrée.
  3. Pour le nom de la classe, saisissez UpdateAccounts, puis appuyez sur Entrée.
  4. Pour le répertoire de sortie, sélectionnez scripts/apex, puis appuyez sur Entrée.
  5. Saisissez ce code.
// Create new accounts
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Second New Account'));
// Insert them into the database
try {
    insert as user newAccts;
    System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
    System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Instantiate an AccountProcessor object
AccountProcessor myAcctProcessor = new AccountProcessor();
// Pass the original list to update the account descriptions
myAcctProcessor.updateAccountDescriptions(newAccts);
  1. Pour enregistrer votre script, appuyez sur Ctrl + S (Windows) ou ⌘ + S (macOS).
  2. Pour exécuter le script, faites un clic droit dans l’éditeur de texte et sélectionnez SFDX: Execute Anonymous Apex with Currently Open Editor (SFDX : exécuter Apex anonyme avec l’éditeur actuellement ouvert).
  3. Dans Salesforce, ouvrez les pages de détails d’enregistrement My New Account (Mon nouveau compte) et My Second New Account (Mon deuxième nouveau compte).

Le champ Description de My New Account (Mon nouveau compte) doit contenir Original Description | Last processed: 2026-01-01 00:00:00 (Description originale | Dernier traitement : 01/01/2026 00:00:00) et le champ Description de My Second New Account (Mon deuxième nouveau compte) doit contenir Account updated on: 2026-01-01 00:00:00 (Date de mise à jour du compte : 01/01/2026 00:00:00), sauf que les deux horodatages refléteront la date et l’heure auxquelles vous avez exécuté la transaction Apex anonyme.

Inspection des journaux de débogage

Les journaux de débogage sont utiles pour le débogage de votre code. Lorsque des méthodes Apex sont exécutées, les appels sont consignés dans le journal de débogage. Vous pouvez également écrire vos propres messages de débogage dans le journal, ce qui facilite le débogage de votre code en cas d'erreur. La méthode helper inspectResults(), qui est appelée par updateAccountDescriptions(), écrit des messages dans le journal en utilisant la méthode System.debug() pour indiquer si l’opération de mise à jour de base de données a réussi ou a généré des erreurs. Vous pouvez consulter ces messages dans le journal de débogage généré lors de l'exécution de la méthode.

  1. Après avoir exécuté le script UpdateAccounts dans la console Web, ouvrez le panneau Output (Sortie).
  2. Sélectionnez Débogage uniquement pour filtrer le journal et afficher uniquement les lignes des instructions System.debug().
  3. Dans le champ filter (filtre) en haut du panneau Output (Sortie), saisissez USER_DEBUG pour filtrer le journal afin que seules les lignes de journal correspondant aux instructions System.debug() soient affichées.
  4. Vous pouvez également afficher le journal de débogage dans le répertoire .sfdx/tools/debug/logs.

Filtrage du journal de débogage dans la console Web pour afficher les messages de débogage

Les messages ci-dessous s’affichent dans la vue du journal filtré lorsque le script a été exécuté sans générer d’erreur.

DEBUG|Successfully inserted 2 accounts.
DEBUG|Successfully updated account. Account ID: {id}
DEBUG|Successfully updated account. Account ID: {id}
Note

Vous pouvez également filtrer le journal de débogage en recherchant un mot-clé dans le champ filter (filtre). Pour les types d’événements de journal, consultez Niveaux du journal de débogage.

Appel d'une méthode statique

La méthode updateAccountDescriptions() de votre classe n’a pas accès aux variables membre de classe. Par conséquent, il n’est pas nécessaire qu’elle soit une méthode d’instance. Modifiez-la en méthode statique en ajoutant le mot-clé static à sa déclaration. Les méthodes statiques sont plus faciles à appeler que les méthodes d'instance, car il n'est pas nécessaire de les appeler dans une instance de la classe. Elles sont appelées directement dans le nom de la classe.

  1. Dans la console Web, ouvrez le fichier de classe AccountProcessor.cls.
  2. Modifiez la première ligne de la définition de updateAccountDescriptions(). La seule modification est l’ajout du mot-clé static (statique).
public static void updateAccountDescriptions(List<Account> acctList) {
  1. Pour enregistrer votre classe, appuyez sur Ctrl + S (Windows) ou ⌘ + S (macOS). La classe est redéployée lors de l’enregistrement.
  2. Ouvrez le fichier de script Apex anonyme UpdateAccounts.apex.
  3. Remplacez le code actuel par le code suivant afin que le script appelle la méthode statique sur le nom de la classe.
// Create new accounts
// For clarity, use different account names than the ones you used previously
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My Third New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Fourth New Account'));
// Insert them into the database
try {
    insert as user newAccts;
    System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
    System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Pass the original list to update the account descriptions
// The static method is called directly on the class
AccountProcessor.updateAccountDescriptions(newAccts);
  1. Pour enregistrer votre script, appuyez sur Ctrl + S (Windows) ou ⌘ + S (macOS).
  2. Pour exécuter le script, faites un clic droit dans l’éditeur de texte et sélectionnez SFDX: Execute Anonymous Apex with Currently Open Editor (SFDX : exécuter Apex anonyme avec l’éditeur actuellement ouvert). Cette méthode ayant été exécutée, vous pouvez vérifier les descriptions de compte mises à jour dans Salesforce et, si nécessaire, le journal de débogage, comme dans les étapes précédentes.

Ressources

Partagez vos commentaires sur Trailhead dans l'aide Salesforce.

Nous aimerions connaître votre expérience avec Trailhead. Vous pouvez désormais accéder au nouveau formulaire de commentaires à tout moment depuis le site d'aide Salesforce.

En savoir plus Continuer à partager vos commentaires