Présentation du code Apex

Disponible avec : Salesforce Classic (pas disponible dans toutes les organisations) et Lightning Experience

Disponible avec : Enterprise Edition, Performance Edition, Unlimited Edition, Developer Edition et Database.com Edition

Apex peut être stocké sur la plate-forme sous deux formes :

• Une classe est un modèle ou plan directeur à partir duquel les objets Apex sont créés. Les classes sont constituées d'autres classes, de méthodes définies par l'utilisateur, de variables, de types d'exception et d'un code d'initialisation statique. Dans Configuration, saisissez Classes Apex dans la case Recherche rapide, puis sélectionnez Classes Apex.
• Un déclencheur est un Apex qui s'exécute avant ou après certains événements de langage de manipulation de données (DML), par exemple avant l'insertion d'enregistrements d'objet dans la base de données ou après la suppression d'enregistrements. Les déclencheurs sont stockés en tant que métadonnées dans Salesforce. La liste de tous les déclencheurs de votre organisation est disponible dans la page Déclencheurs Apex dans la Configuration.

Le code Apex s'exécute généralement dans le contexte du système, c'est-à-dire qu'il ne tient pas compte des autorisations de l'utilisateur actuel et de la sécurité au niveau des champs. Cependant, les règles de partage ne sont pas toujours contournées : la classe doit être déclarée avec le mot-clé without sharing afin de garantir que les règles de partage ne sont pas appliquées.

Vous devez avoir au moins 75 % de code Apex couvert par des tests unitaires pour pouvoir déployer votre code dans des environnements de production. En outre, tous les déclencheurs doivent également avoir une couverture de test.

Après avoir créé vos classes et déclencheurs, ainsi que vos tests, répétez l'exécution en utilisant la Developer Console.

Vous pouvez ajouter, modifier ou supprimer un code Apex en utilisant l'interface utilisateur Salesforce uniquement dans une organisation Developer Edition, une organisation d'évaluation Salesforce Enterprise Edition ou une organisation sandbox. Dans une organisation de production Salesforce, vous pouvez modifier le code Apex uniquement en utilisant l'appel d’deployAPI Metadata, Salesforce Extensions for Visual Studio Code ou l'outil de migration Ant. Salesforce Extensions pour Visual Studio Code et l'Outil de migration Ant sont des ressources que Salesforce fournit gratuitement afin d'aider les utilisateurs et les partenaires, mais qui ne sont pas considérés comme faisant partie de nos Services dans le cadre du Contrat de services principal de Salesforce.

Pour plus d'informations sur la syntaxe et l'utilisation d'Apex, reportez-vous au guide Apex Code Developer's Guide.

• Guide du développeur Apex et outils de développement
  Les documents Apex Developer Guide et Apex Reference Guide représentent la référence complète du langage de programmation Apex. Le guide du développeur Apex indique comment invoquer code Apex, travailler avec les limites, écrire des tests, et davantage. Le guide de référence Apex présente des informations complètes sur les classes, les interfaces et les exceptions Apex, etc. Pour écrire un code Apex, vous avez le choix entre plusieurs outils Salesforce et tiers.
• Définition de classes Apex
  Salesforce stocke les classes Apex en tant que métadonnées.
• Définition de déclencheurs Apex
  Un code Apex peut être invoqué en utilisant des déclencheurs. Les déclencheurs Apex peuvent être configurés pour exécuter des actions personnalisées avant ou après la modification d'enregistrements Salesforce, notamment des insertions, des mises à jour ou des suppressions.
• Exécution d'un code Apex anonyme
  La Developer Console permet d'exécuter un code Apex en tant que méthode alternative pour générer des journaux de débogage couvrant une logique applicative spécifique.
• Que se passe-t-il en cas d'exception Apex ?
  Lorsqu'une exception se produit, l'exécution du code est interrompue. Toutes les opérations DML traitées avant l'exception sont restaurées à leur état antérieur et ne sont pas enregistrées dans la base de données. Les exceptions sont consignées dans les journaux de débogage. Pour les exceptions non gérées, qui correspondent aux exceptions que le code ne détecte pas, Salesforce envoie un e-mail qui contient les détails de l'exception. L'utilisateur affiche un message d'erreur dans l'interface utilisateur de Salesforce.
• Gestion des exceptions Apex dans les packages gérés
  Lorsque vous créez un package géré pour AppExchange, vous pouvez spécifier un utilisateur qui recevra une notification par e-mail lorsqu'une exception se produit et qui n'est pas détectée par Apex.
• Gestion des classes Apex
  Une classe Apex est un modèle ou plan directeur à partir duquel les objets Apex sont créés. Les classes sont constituées d'autres classes, de méthodes définies par l'utilisateur, de variables, de types d'exception et d'un code d'initialisation statique.
• Gestion des déclencheurs Apex
  Un déclencheur est un Apex qui s'exécute avant ou après certains événements de langage de manipulation de données (DML), par exemple avant l'insertion d'enregistrements d'objet dans la base de données ou après la suppression d'enregistrements.
• Gestion des paramètres de version pour Apex
  Pour faciliter la rétrocompatibilité, les classes et les déclencheurs Apex sont stockés avec les paramètres de version de l'API Salesforce et de tous les packages gérés référencés.
• Affichage de classes Apex
  Après avoir créé une classe, vous pouvez afficher le code contenu dans la classe, ainsi que l'API par rapport à laquelle elle a été enregistrée, et déterminer si la classe est valide ou active.
• Affichage des détails de déclencheur Apex
  Les déclencheurs Apex sont stockés sous forme de métadonnées dans l'application, sous l'objet auquel ils sont associés.
• Création d'une classe Apex à partir d'un document WSDL
  Une classe Apex peut être générée automatiquement à partir d'un document WSDL stocké sur un disque dur local ou sur le réseau.
• Surveillance de la file d'attente des tâches Apex
  La page de configuration des tâches Apex présente des informations sur les tâches Apex, notamment le pourcentage d'utilisation de code Apex asynchrone et le nombre d'opérations Apex utilisées dans la limite de 24 heures de l'organisation. Surveillez le statut des tâches Apex afin d’anticiper les problèmes potentiels de limite avant qu'ils ne surviennent.
• Surveillance de la file d'attente Flex Apex
  Utilisez la page File d'attente Flex Apex pour afficher et réorganiser toutes les tâches par lot dont le statut est En attente. Vous pouvez également réorganiser vos tâches par lot par programmation en utilisant un code Apex.
• Planification de tâches Apex
  Utilisez le planificateur Apex et l'interface Schedulable pour exécuter régulièrement des classes Apex spécifiques ou exécuter une tâche Apex par lot avec l'interface utilisateur de Salesforce.
• FAQ Apex
  Foire aux questions sur les services Web externes, les types de schéma WSDL pris en charge et les différences entre les classes Apex et les déclencheurs.