Exécuter automatiquement un script que vous choisissez

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 8 minutes de lecture

    • Planifiez des scripts conditionnels et non conditionnels. Si Séparation de domaine est installé dans l’instance, vous pouvez également sélectionner, filtrer, trier et planifier des scripts en fonction des domaines qui leur sont affectés.

    Avant de commencer

    Rôles requis : system_scheduler_admin

    Pourquoi et quand exécuter cette tâche

    Voici un exemple de script conditionnel. Elle exécute la tâche planifiée uniquement s’il existe des incidents actifs datant de plus de 30 jours.

    // Only run this Scheduled Job if there are active Incidents over 30 days old
var ga = new GlideAggregate('incident');
ga.addAggregate('COUNT');
ga.addQuery('active', 'true');
ga.addQuery('sys_created_on', '<', gs.daysAgo(30));
ga.query();
ga.next();
ga.getAggregate('COUNT') !== '0'

    Procédure

    1. Accédez à la Tous > Définition du système > Travaux planifiés.
    2. Sélectionnez Nouveau.
    3. Sélectionnez Exécuter automatiquement un script de votre choix.
    4. Remplissez les champs du formulaire.
      Tableau 1. Planifier l’exécution du script
      Champ Description
      Nom Nom qui identifie cette tâche planifiée.
      Actives Option qui indique que la tâche planifiée est active et doit être exécutée aux date et heure spécifiées.
      Application Nom de l’application qui contient le script. Global s’affiche si le script est dans le champ d’application global.
      Conditionnel Option permettant d’activer l’exécution de la tâche planifiée si certaines conditions sont remplies dans le script associé.
      Condition Script conditionnel qui détermine si une tâche planifiée doit être exécutée. La dernière expression du script doit être évaluée comme une valeur booléenne (vrai/faux). Cette zone de texte s’affiche uniquement si vous sélectionnez Utiliser les conditions.
      Avertissement :
      Les scripts conditionnels pour les e-mails de rapports planifiés et Analyse des performances les travaux de collecte de données sont exécutés dans le bac à sable. Par conséquent, les définitions de fonctions ne sont pas autorisées. Certains appels API et mots clés ne sont pas non plus autorisés.Pour plus d’informations, reportez-vous à .Script sandbox

      Après la mise à niveau, les tâches avec des scripts conditionnels qui contiennent ces composants d’API non autorisés se terminent avec des erreurs.
      Exécuter
      Intervalle de temps à utiliser pour l’exécution de la tâche planifiée :
      • Quotidien : s'exécute quotidiennement à l'heure désignée.
      • Jour et mois de l’année : s’exécute chaque année à un jour et un mois spécifiques (par exemple, le 14 juillet), à une heure définie.
      • Jour de la semaine du mois de l’année : s’exécute chaque année un jour spécifique de la semaine d’une semaine spécifique d’un mois spécifique (par exemple, le deuxième lundi d’octobre), à une heure désignée.
      • Semaine du mois : s’exécute tous les mois pendant une semaine spécifique du mois (par exemple, la troisième semaine de chaque mois), à des jours et à une heure désignés.
      • Hebdomadaire : s'exécute chaque semaine à l'heure et au jour désignés de la semaine.
      • Mensuel : s'exécute chaque mois à l'heure et au jour désignés du mois.
      • Périodiquement : s'exécute selon l'intervalle de répétition désigné.
      • Once (Une fois) : s’exécute pour une seule occurrence.
      • Sur demande : s’exécute immédiatement sur demande.
      • Calendrier d’entreprise : début de l’entrée : s’exécute aux dates d’entrée de début du calendrier d’entreprise que vous sélectionnez dans le champ Calendrier d’entreprise . Une tâche planifiée s'exécute à la date de début de chacune des entrées d'entreprise que vous avez définies dans le calendrier d'entreprise.

        Par exemple, si le calendrier d'entreprise représente une année fiscale et que la date de début de chaque entrée est un mois fiscal, alors la tâche planifiée s'exécute le premier jour de chaque mois.

      • Calendrier d’entreprise : fin de l’entrée : s’exécute pour la date de fin du calendrier d’entreprise que vous sélectionnez dans le champ Calendrier d’entreprise . Cette sélection s’exécute de la même manière que Calendrier d’entreprise : début de l’entrée, mais pour les dates de fin des entrées de calendrier d’entreprise associées.
        Remarque :
        Lorsque vous sélectionnez Calendrier d’entreprise : début de l’entrée ou Calendrier d’entreprise : fin d’entrée, vous pouvez appliquer un facteur de décalage pour planifier l’exécution de la tâche avant ou après l’intervalle de temps du calendrier professionnel sélectionné. Si vous sélectionnez un calendrier professionnel et que toutes ses plages de calendrier professionnel sont dans le passé, la tâche ne s’exécute jamais, car cette configuration n’est pas valide. Pour en savoir plus, consultez les champs Type de décalage et Décalage .

        Pour en savoir plus sur la création et l’utilisation des calendriers d’entreprise et sur la définition d’entrées de calendrier d’entreprise, consultez Création de calendriers d’entreprise et Définir des entrées de calendrier d’entreprise.
      Jour
      Jour d’exécution de la tâche planifiée.
      • Si Exécuter est défini sur Hebdomadaire, sélectionnez le jour de la semaine. Par exemple, sélectionnez Mercredi.
      • Si Exécuter est défini sur Mensuel, sélectionnez le jour du mois. Par exemple, sélectionnez 25 pour le 25e jour du mois.
      Ce champ s’affiche uniquement si vous sélectionnez Mensuel ou Hebdomadaire dans le champ Exécuter.
      Intervalle de répétition
      Durée de l’intervalle de répétition pour chaque exécution de tâche planifiée. Entrez la durée en jours, heures ou minutes. Par exemple :
      • Pour exécuter la tâche planifiée tous les quatre jours, entrez 04 dans le champ Jours .
      • Pour l’exécuter toutes les 26 heures, saisissez 26 dans le champ Heures .
      • S’il doit se répéter à un intervalle de 13:30:25, entrez 13 dans le champ Heures , puis entrez 30 et 25 dans les deux champs non étiquetés qui le suivent.
      Fuseau horaire
      Fuseau horaire à utiliser avec l’entrée du champ Heure lorsque vous spécifiez l’heure à laquelle la tâche planifiée doit s’exécuter. Sélectionnez une entrée de fuseau horaire :
      • -Aucun- : utilisez le fuseau horaire par défaut pour l’utilisateur connecté qui crée la tâche planifiée.

        Par exemple, la tâche planifiée s’exécute à 16 h 45, heure des États-Unis/Pacifique s’il s’agit du fuseau horaire affecté à l’utilisateur, et vous saisissez 16 h 45 dans le champ Heure .

      • Utiliser le fuseau horaire du système : utilisez le fuseau horaire du système par défaut spécifié pour l’instance dans laquelle il s’exécute.

        Par exemple, la tâche planifiée s’exécute à 22h15. Heure de Londres si Europe/Londres est le fuseau horaire du système par défaut pour l’instance, et vous entrez 22:15 dans le champ Heure .

      • Fuseau horaire réel.

        Par exemple, la tâche planifiée s’exécute à 13 h 30 dans le fuseau horaire de l’Est des États-Unis si vous sélectionnez États-Unis/Est et saisissez 13 h 30 dans le champ Heure .
      Heure Heure de la journée à laquelle la tâche planifiée doit s’exécuter, exprimée en heures, minutes et secondes sur une horloge de 24 heures. La sélection que vous effectuez dans le champ Fuseau horaire détermine le fuseau horaire de cette entrée.
      Jour
      Jour d’exécution de la tâche planifiée.
      • Si Exécuter est défini sur Hebdomadaire, sélectionnez le jour de la semaine. Par exemple, sélectionnez Mercredi.
      • Si Exécuter est défini sur Mensuel, sélectionnez le jour du mois. Par exemple, sélectionnez 25 pour le 25e jour du mois.
      Ce champ s’affiche uniquement si vous sélectionnez Mensuel ou Hebdomadaire dans le champ Exécuter.
      Intervalle de répétition
      Durée de l’intervalle de répétition pour chaque exécution de tâche planifiée. Entrez la durée en jours, heures ou minutes. Par exemple :
      • Pour exécuter la tâche planifiée tous les quatre jours, entrez 04 dans le champ Jours .
      • Pour l’exécuter toutes les 26 heures, saisissez 26 dans le champ Heures .
      • S’il doit se répéter à un intervalle de 13:30:25, entrez 13 dans le champ Heures , puis entrez 30 et 25 dans les deux champs non étiquetés qui le suivent.
      En cours de démarrage Vous permet de définir la fenêtre de début à laquelle vous souhaitez que votre tâche commence à s’exécuter. La tâche s’exécutera réellement à l’heure spécifiée dans Exécution. Sélectionnez la date et l’heure du calendrier. Le champ Starting (En cours) s’affiche uniquement si vous sélectionnez l’un des types d’exécution suivants dans le champ Run (Exécuter) :
      • Quotidien
      • Jour et mois de l'année
      • Jour de la semaine du mois de l'année
      • Mensuel
      • Une fois
      • Périodiquement
      • Semaine du mois
      • Hebdomadaire

      Pour le type d’exécution Périodiquement, l’heure de démarrage est la date et l’heure de la première génération de tâche planifiée.
      Calendrier d'entreprise

      Entrée du calendrier d’entreprise que vous utilisez pour déterminer la date de début ou de fin du calendrier professionnel pour la tâche planifiée. Ce champ s’affiche uniquement si vous sélectionnez Entrée d’entreprise : date de début ou Entrée d’entreprise : date de fin dans le champ Heure .
      Exécuter en tant que [Facultatif] Sélectionnez un autre utilisateur sous lequel exécuter l’exécution du script. Configurez le formulaire pour ajouter ce champ s’il n’est pas présent.
      Exécuter ce script Nom du script à exécuter aux date et heure planifiées. Par exemple, copiez la logique de script à partir d’une règle métier ou appelez une inclusion de script.
    5. Si Séparation en domaines est installé dans cette instance, les champs suivants s’affichent également pour sélectionner, trier et planifier les tâches par domaine.
      Remarque :
      Le module d’extension Domain Support - Domain Extensions Installer installe ces champs. Pour en savoir plus, consultez Demander Séparation de domaine.
      Champ Description
      Itérateur de domaine Case à cocher qui permet à cette tâche de s’exécuter sur plusieurs domaines. Si cette option est sélectionnée, les champs Table source de domaine et Filtre source de domaine s’affichent.
      Table source de domaine Nom de la table séparée par domaine qui est la source des domaines dans lesquels la tâche planifiée doit s’exécuter. Par exemple, sélectionnez Département (cmn_department) si vous souhaitez l’utiliser comme source des domaines affectés utilisés pour planifier des scripts. La tâche planifiée détermine ces domaines à partir du champ sys_domain des enregistrements de la table source. Pour en savoir plus, consultez Affectation de domaine.
      Remarque :
      C’est une bonne idée de créer une table séparée par domaine uniquement dédiée aux domaines d’approvisionnement, sauf si vous avez un cas d’utilisation qui justifie l’utilisation d’une table existante. Si vous en créez un, sélectionnez-le simplement à l’aide de ce champ.
      Filtre source de domaine Condition facultative que vous pouvez spécifier pour filtrer les enregistrements interrogés à partir de la table source de domaine sélectionnée.
      1. Sélectionnez le champ à utiliser pour filtrer les enregistrements.
      2. Ajoutez des conditions de filtrage et des opérateurs pour affiner les critères de sélection de domaine. Pour en savoir plus, voir Filtres.
      Le traitement suivant a lieu lors de la planification d’une tâche dans une instance séparée par domaine :
      • Elle interroge d’abord la table source de domaine sélectionnée.
      • Si vous avez spécifié une condition dans le champ de filtre Source de domaine , il applique la condition de filtrage pour affiner le jeu d’enregistrements résultant.
      • Enfin, il récupère sa liste de domaines uniques dans les colonnes sys_domain de ces enregistrements.
    6. Sélectionnez Mettre à jour pour mettre à jour la tâche planifiée, Exécuter maintenant pour exécuter immédiatement le script planifié ou Supprimer pour supprimer la tâche.