Exécuter automatiquement un script que vous choisissez

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 8 minutes de lecture

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

    Avant de commencer

    Rôles requis : admin

    Pourquoi et quand exécuter cette tâche

    Voici un exemple de script conditionnel. Il 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.
      Actif Option qui indique que la tâche planifiée est active et doit être exécutée à la date et à l'heure spécifiées.
      Application Nom de l'application qui contient le script. Global apparaît si le script se trouve dans le champ d'application global.
      Conditionnel Option permettant d'activer l'exécution de la tâche planifiée quand 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 à 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 mensuellement 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é.
      • Une fois : s'exécute pour une seule occurrence uniquement.
      • Sur demande : s'exécute immédiatement sur demande.
      • Calendrier d'entreprise : début de l'entrée : s'exécute selon les dates de début d'entrée 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 selon les dates de fin d'entrée du calendrier d'entreprise que vous sélectionnez dans le champ Calendrier d'entreprise. Cette sélection s'exécute de la même façon que Calendrier d'entreprise : début de l'entrée, mais en fonction des dates de fin des entrées du calendrier d'entreprise associées.
        Remarque :
        Lorsque vous sélectionnez Calendrier d'entreprise : début de l'entrée ou Calendrier d'entreprise : fin de l'entrée, vous pouvez appliquer un facteur de décalage pour planifier la tâche à exécuter avant ou après la période du calendrier d'entreprise 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écalageet 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 où la tâche planifiée doit s'exécuter.
      • Si le champ Exécution est défini sur Hebdomadaire, sélectionnez le jour de la semaine. Choisissez mercredi, par exemple.
      • Si le champ Exécution est défini sur Mensuel, sélectionnez le jour du mois. Par exemple, sélectionnez 25 pour le 25e jour du mois.
      Ce champ n'apparaît que si vous sélectionnez Mensuel ou Hebdomadaire dans le champ Exécution.
      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 nombre de jours, d'heures ou de minutes. Par exemple :
      • Pour exécuter la tâche prévue tous les quatre jours, saisissez 04 dans le champ Jours.
      • Pour l'exécuter toutes les 26 heures, entrez 26 dans le champ Heures.
      • Si elle doit se répéter à un intervalle de 13 heures 30 minutes et 25 secondes, saisissez 13 dans le champ Heures, puis 30 et 25 dans les deux champs non libellés suivants.
      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 être exécutée. Sélectionnez une entrée de fuseau horaire :
      • -Aucun- : utilisez le fuseau horaire par défaut de 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 prévue s'exécute à 22 h 15, heure de Londres, si Europe/London est le fuseau horaire du système par défaut pour l'instance, et que vous entrez 22:15 dans le champ Heure.

      • Fuseau horaire actuel.

        Par exemple, la tâche prévue s'exécute à 13 h 30 au fuseau horaire de l'Est des États-Unis si vous sélectionnez US/Eastern et entrez 13:30 dans le champ Heure.
      Heure Heure de la journée à laquelle la tâche planifiée doit s'exécuter, indiquée en heures, minutes et secondes dans un format de 24 heures. La sélection que vous faites dans le champ Fuseau horaire détermine le fuseau horaire de cette entrée.
      Jour
      Jour où la tâche planifiée doit s'exécuter.
      • Si le champ Exécution est défini sur Hebdomadaire, sélectionnez le jour de la semaine. Choisissez mercredi, par exemple.
      • Si le champ Exécution est défini sur Mensuel, sélectionnez le jour du mois. Par exemple, sélectionnez 25 pour le 25e jour du mois.
      Ce champ n'apparaît que si vous sélectionnez Mensuel ou Hebdomadaire dans le champ Exécution.
      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 nombre de jours, d'heures ou de minutes. Par exemple :
      • Pour exécuter la tâche prévue tous les quatre jours, saisissez 04 dans le champ Jours.
      • Pour l'exécuter toutes les 26 heures, entrez 26 dans le champ Heures.
      • Si elle doit se répéter à un intervalle de 13 heures 30 minutes et 25 secondes, saisissez 13 dans le champ Heures, puis 30 et 25 dans les deux champs non libellés suivants.
      En cours de démarrage Vous permet de définir la fenêtre de début lorsque vous souhaitez que votre tâche commence à s’exécuter. La tâche s’exécutera réellement à l’heure spécifiée dans Temps d’exécution. Sélectionnez la date et l'heure du calendrier. Le champ Starting (Début) s’affiche uniquement si vous sélectionnez l’un des types d’exécution suivants :
      • Quotidien
      • Jour et mois de l'année
      • Jour de la semaine du mois de l'année
      • Mensuel
      • Une fois
      • Périodique
      • Semaine du mois
      • Hebdomadaire

      Pour le type d’exécution Périodiquement, l’heure de début 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 pour effectuer l'exécution du script en tant que cet utilisateur. Configurez le formulaire pour ajouter ce champ si celui-ci n'existe pas.
      Exécuter ce script Nom du script à exécuter aux date et heure prévues. Par exemple, copiez la logique de script à partir d’une règle métier ou appelez un script include.
    5. Si Séparation de domaine est installée dans cette instance, les champs suivants s’affichent également pour la sélection, le tri et la planification des tâches par domaine.
      Remarque :
      Le module d’extension Domain Support - Domain Extensions Installer installe ces champs. Pour en savoir plus, consultez Demander une 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 Attribution 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’un domaine existant. Si vous en créez un nouveau, 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, consultez Filtres.
      Le traitement suivant a lieu lors de la planification d’une tâche dans une instance séparée par domaine :
      • Il interroge d’abord la table source de domaine sélectionnée.
      • Si vous avez spécifié une condition dans le champ Filtre source de domaine , il applique la condition de filtrage pour affiner l’ensemble 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.