Platform
Planification Tâches Cron avec Parse Server et Back4App

13min
Comment créer votre tâche cron Parse
Introduction
Cette section explique comment vous pouvez planifier une tâche cron en utilisant les fonctionnalités principales de Parse Server via Back4App.
Pour ce tutoriel, en exemple, vous allez créer une tâche cron qui supprime les utilisateurs de votre Tableau de bord Parse qui n'ont pas vérifié leurs emails un certain temps après leur inscription.
À tout moment, vous pouvez accéder au projet complet construit pour ce tutoriel sur notre dépôt GitHub.
Conditions préalables
Pour compléter ce tutoriel, vous avez besoin de :
Une application créée sur Back4App.
Remarque : Suivez le Tutoriel de nouvelle application Parse pour apprendre à créer une application Parse sur Back4App
Connaissances sur le Cloud Code.
Remarque : Suivez le Tutoriel Cloud Code pour Android ou le Tutoriel Cloud Code pour iOS pour plus d'informations.
Un appareil (ou appareil virtuel) fonctionnant sous Android 4.0 (Ice Cream Sandwich) ou plus récent.
1 - Créez votre code de tâche cron
Créez un .js fichier pour mettre votre code de tâche cron. Dans cet exemple, un main.js fichier est créé dans un cloud_code répertoire.
Définissez une fonction de tâche en utilisant Parse.Cloud.job. Dans cet exemple, le code suivant vérifie chaque utilisateur dans votre Parse Dashboard, puis interroge ceux qui n'ont toujours pas vérifié leur email après un certain temps et les détruit:
Parse Server 3.X main.js
Parse Server 2.X main.js
1   Parse.Cloud.job("removeInvalidLogin", function (request, response) {
2     var date = new Date();
3     var timeNow = date.getTime();
4     var intervalOfTime = 3*60*1000;  // the time set is 3 minutes in milliseconds
5     var timeThen = timeNow - intervalOfTime;
6
7     // Limit date
8     var queryDate = new Date();
9     queryDate.setTime(timeThen);
10
11    // The query object
12    var query = new Parse.Query(Parse.User);
13
14    // Query the users that still unverified after 3 minutes
15    query.equalTo("emailVerified", false);
16    query.lessThanOrEqualTo("createdAt", queryDate);
17
18    query.find({
19        success: function (results) {
20        console.log("Successfully retrieved " + results.length + " invalid logins.");
21
22        // Destroying the invalid users
23        query.each(function (object, err) {
24          object.destroy({
25            success: function (object) {
26              response.success("Successfully destroyed object " + object.objectId);
27            },
28            error: function (error) {
29              response.error("Error: " + error.code + " - " + error.message);
30            },
31            useMasterKey: true  // VERY IMPORTANT!!
32          })
33        })
34      },
35      error: function (error) {
36        response.error("Error: " + error.code + " - " + error.message);
37      }
38    });
39  });
1   Parse.Cloud.job("removeInvalidLogin", function (request, response) {
2     var date = new Date();
3     var timeNow = date.getTime();
4     var intervalOfTime = 3*60*1000;  // the time set is 3 minutes in milliseconds
5     var timeThen = timeNow - intervalOfTime;
6
7     // Limit date
8     var queryDate = new Date();
9     queryDate.setTime(timeThen);
10
11    // The query object
12    var query = new Parse.Query(Parse.User);
13
14    // Query the users that still unverified after 3 minutes
15    query.equalTo("emailVerified", false);
16    query.lessThanOrEqualTo("createdAt", queryDate);
17
18    query.find({
19        success: function (results) {
20        console.log("Successfully retrieved " + results.length + " invalid logins.");
21
22        // Destroying the invalid users
23        query.each(function (object, err) {
24          object.destroy({
25            success: function (object) {
26              response.success("Successfully destroyed object " + object.objectId);
27            },
28            error: function (error) {
29              response.error("Error: " + error.code + " - " + error.message);
30            },
31            useMasterKey: true  // VERY IMPORTANT!!
32          })
33        })
34      },
35      error: function (error) {
36        response.error("Error: " + error.code + " - " + error.message);
37      }
38    });
39  });
﻿
Il est nécessaire d'utiliser la clé maître dans cette opération.
Vous pouvez modifier le intervalOfTime contenu avec la durée que vous pensez qu'un utilisateur non vérifié peut encore avoir son compte actif sans le vérifier. N'oubliez pas que pour tester votre application, de petits intervalles de temps sont meilleurs. Il est donc suggéré de définir le intervalOfTime contenu à trois minutes pour tester si le cron job fonctionne, puis de changer le code JavaScript avec la durée que vous souhaitez réellement intervalOfTime à être.
N'oubliez pas que les modifications apportées au fichier JavaScript ne sont prises en compte dans votre application que si vous téléchargez à nouveau le fichier sur le bloc de code Cloud de Back4app. Pour ce faire, supprimez le .js fichier avec le intervalOfTime indésirable et suivez l'étape 2 pour télécharger le fichier avec le bon intervalOfTime contenu.
2 - Télécharger le cron job sur Cloud Code
Pour en savoir plus sur la façon de commencer avec Cloud Code, consultez Tutoriel Cloud Code pour Android ou Tutoriel Cloud Code pour iOS.
Allez à votre application sur le Back4App site et cliquez sur Tableau de bord.
Trouvez le Cloud Code et cliquez sur Fonctions et Hébergement Web. Cela ressemble à ceci:
﻿
     3. Téléchargez ou créez un nouveau fichier (vous pouvez également modifier le main.js fichier directement dans le navigateur). Ensuite, cliquez sur Déployer comme montré ici:
﻿
3 - Planifier une tâche cron sur Back4App
Allez sur votre application sur le site Web Back4App et cliquez sur Paramètres du serveur.
Trouvez le bloc “Tâches en arrière-plan” et cliquez sur PARAMÈTRES. Le bloc “Tâches en arrière-plan” ressemble à ceci:
﻿
     3. Une page de Tâches en arrière-plan apparaîtra et deux options seront affichées : Parcourir une tâche ou Planifier une tâche. Cliquez sur Planifier une tâche, comme indiqué ci-dessous :
﻿
Si vous voulez Modifier, Exécuter maintenant, ou Supprimer un cron job existant, cliquez sur le Parcourir un job bouton.
      4. Une page de planification d'un job apparaîtra et vous devrez remplir le Description de votre job avec sa description et aussi le champ Job Cloud avec le nom que vous avez donné à votre cron job dans la première ligne de son code JavaScript. Dans cet exemple, le nom du cron job créé est removeInvalidLogin.
﻿
 5. Vous pouvez également définir d'autres options pour votre cron job, comme à quelle heure il doit commencer à s'exécuter, s'il doit se répéter, et à quelle fréquence. Après avoir rempli ces options selon vos préférences, cliquez sur le ENREGISTRER bouton.
﻿
4 - Testez votre application
Créez quelques utilisateurs avec emailVerified colonne définie sur Faux dans votre Parse Dashboard, comme montré ci-dessous:
﻿
  2. Exécutez votre application et rafraîchissez votre Parse Dashboard. Cela devrait avoir détruit les utilisateurs non vérifiés. Pour le Parse Dashboard montré ci-dessus, voici le résultat:
﻿
Vous pouvez également voir si le cron job fonctionne en accédant aux journaux de Back4App. Pour ce faire, suivez ces étapes :
Allez sur votre application sur le site Web de Back4App et cliquez sur Paramètres du serveur.
Trouvez le bloc “Journaux” et cliquez sur PARAMÈTRES. Le bloc “Journaux” ressemble à ceci :
﻿
       3. Faites défiler la page jusqu'à ce que vous voyiez le Journal système du serveur. Là, vous devriez trouver des informations sur le cron job qui s'exécute, comme indiqué ci-dessous :
﻿
C'est fait !
À ce stade, vous pouvez planifier des cron jobs dans votre application en utilisant les fonctionnalités de base de Parse Server via Back4App !
Mis à jour 27 Jan 2025
Cette page vous a-t-elle aidée?
Configurer et utiliser les variables d'environnement Parse
Activation de Live Query sur Back4App pour Applications