Planification de tâches à l’aide du planificateur Apex

• Quand utiliser une méthode Apex planifiée
• Comment surveiller les tâches planifiées
• La syntaxe d’une méthode Apex planifiée
• Les meilleures pratiques d’utilisation de méthodes planifiées

Remarque

Vous souhaitez apprendre en français ? Dans ce badge, les validations de défi pratique Trailhead se font en anglais. Les traductions sont fournies entre parenthèses à titre de référence. Dans votre Trailhead Playground, veillez (1) à définir les États-Unis comme région, (2) à sélectionner l’anglais comme langue, et (3) à copier et coller uniquement les valeurs en anglais. Suivez les instructions ici.

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

public class SomeClass implements Schedulable {
    public void execute(SchedulableContext ctx) {
        // awesome code here
    }
}

Exemple de code

La classe ci-dessous interroge les opportunités ouvertes qui auraient dû être fermées à la date courante, et crée une tâche dans chaque opportunité pour rappeler à son propriétaire de la mettre à jour.

public class RemindOpptyOwners implements Schedulable {
    public void execute(SchedulableContext ctx) {
        List<Opportunity> opptys = [SELECT Id, Name, OwnerId, CloseDate
            FROM Opportunity
            WHERE IsClosed = False AND
            CloseDate < TODAY];
        // Create a task for each opportunity in the list
        TaskUtils.remindOwners(opptys);
    }
}

Vous pouvez planifier l’exécution de votre classe par programmation ou depuis l’interface utilisateur du planificateur Apex.

RemindOpptyOwners reminder = new RemindOpptyOwners();
// Seconds Minutes Hours Day_of_month Month Day_of_week optional_year
String sch = '20 30 8 10 2 ?';
String jobID = System.schedule('Remind Opp Owners', sch, reminder);

1. Dans Configuration, saisissez Apex dans la case Recherche rapide, puis sélectionnez Classes Apex.
2. Cliquez sur Planifier Apex.
3. Saisissez le nom de la tâche, par exemple Rappel d’opportunité quotidienne.
4. Cliquez sur le bouton de recherche en regard de la classe Apex, puis saisissez le caractère générique * pour obtenir la liste de toutes les classes qui peuvent être planifiées. Dans les résultats de recherche, cliquez sur le nom de votre classe planifiée.
5. Sélectionnez la fréquence Hebdomadaire ou Mensuelle, puis définissez la fréquence souhaitée.
6. Sélectionnez les dates de début et de fin, et une date de début préférée.
7. Cliquez sur Enregistrer.

@IsTest
private class RemindOppyOwnersTest {
    // Dummy CRON expression: midnight on March 15.
    // Because this is a test, job executes
    // immediately after Test.stopTest().
    public static String CRON_EXP = '0 0 0 15 3 ? 2042';
    @IsTest
    static void testScheduledJob() {
        // Create some out of date Opportunity records
        List<Opportunity> opptys = new List<Opportunity>();
        Date closeDate = Date.today().addDays(-7);
        for (Integer i=0; i<10; i++) {
            Opportunity o = new Opportunity(
                Name = 'Opportunity ' + i,
                CloseDate = closeDate,
                StageName = 'Prospecting'
            );
            opptys.add(o);
        }
        insert opptys;
        // Get the IDs of the opportunities we just inserted
        Map<Id, Opportunity> opptyMap = new Map<Id, Opportunity>(opptys);
        List<Id> opptyIds = new List<Id>(opptyMap.keySet());
        Test.startTest();
        // Schedule the test job
        String jobId = System.schedule('ScheduledApexTest',
            CRON_EXP,
            new RemindOpptyOwners());
        // Verify the scheduled job has not run yet.
        List<Task> lt = [SELECT Id
            FROM Task
            WHERE WhatId IN :opptyIds];
        System.assertEquals(0, lt.size(), 'Tasks exist before job has run');
        // Stopping the test will run the job synchronously
        Test.stopTest();
        // Now that the scheduled job has executed,
        // check that our tasks were created
        lt = [SELECT Id
            FROM Task
            WHERE WhatId IN :opptyIds];
        System.assertEquals(opptyIds.size(),
            lt.size(),
            'Tasks were not created');
    }
}

• Vous pouvez avoir seulement 100 tâches Apex planifiées à la fois et le nombre maximal d’exécutions Apex planifiées par période de 24 heures est limité. Pour en savoir plus, suivez le lien Execution Governors and Limits de la section Ressources.
• Si vous envisagez de planifier une tâche à partir d’un déclencheur, soyez extrêmement prudent(e). Assurez-vous que le nombre de tâches planifiées ajoutées par le déclencheur ne dépasse pas la limite.
• Les appels externes de service Web synchrones ne sont pas pris en charge depuis une méthode Apex planifiée. Pour exécuter des appels externes, définissez un appel asynchrone en le plaçant dans une méthode annotée avec @future(callout=true), puis appelez cette méthode à partir d’une méthode Apex planifiée. Cependant, si votre méthode Apex planifiée exécute une tâche par lot, les appels externes sont pris en charge depuis la classe par lot.

• Apex Developer Guide: Apex Scheduler
• Apex Developer Guide: Execution Governors and Limits