Comment planifier Tâches API

Planifier un Tâche API vous permet de lancer des automatisations indépendantes de l\'infrastructure Bot Runner (utilisateurs et appareils). Comme Tâches API fonctionne sur cloud, cela élimine le besoin de licences utilisateur individuelles, ce qui permet de réduire les coûts et de simplifier la gestion de l\'automatisation.

Remarque : La planification des Tâches API dans la Control Room nécessite de disposer d\'une licence Plateforme Enterprise. Pour plus d\'informations sur la version prise en charge par cette fonctionnalité, consultez Plateforme Enterprise.
Vous pouvez programmer les Tâches API disponibles pour s\'exécuter à des heures spécifiées. Par exemple, traiter un lot de factures dans un fichier .csv pour l\'exécuter tous les mercredis à 17h.

Prérequis

Assurez-vous d\'être connecté à la Control Room en tant qu\'administrateur ou en tant qu\'utilisateur disposant des autorisations suivantes :

Procédure

  1. Connectez-vous à Control Room.
  2. Pour créer une planification, sélectionnez l\'une des méthodes suivantes dans le panneau de gauche :
    • Cliquez sur Automatisation.

      Cliquez sur le menu des actions (trois points verticaux) à droite de Tâche API pour lequel vous souhaitez créer un planning, puis cliquez sur Planifier une tâche API.

    • Cliquez sur Gestion > Planifiée > Créer une planification.
    L\'écran Automatisation et dépendances s\'affiche. Vous pouvez également cliquer sur l\'option Choisir pour rechercher une Tâche API spécifique.
  3. Sélectionnez le Tâche API que vous souhaitez planifier et cliquez sur Choisir.
    L\'écran Créer un calendrier s\'affiche ; il comporte plusieurs onglets.
  4. Utilisez l\'onglet Automatisation et dépendances pour examiner et mettre à jour les champs suivants :
    • Fichier d\'automatisation : Affiche la Tâche API sélectionnée.

      Si vous souhaitez sélectionner une autre Tâche API, cliquez sur Choisir.

    • Exécuter l\'automatisation et les dépendances en utilisant : Sélectionnez l\'une des versions suivantes de la Tâche API à exécuter :
      • Dernière version : planifie la Tâche API sélectionnée et les dépendances en utilisant la version la plus récente.
      • Étiquette de production : planifie la Tâche API sélectionnée et les dépendances en utilisant la version de production.

      Par défaut, la dernière version du Tâche API est sélectionnée.

    • Dépendances : Liste des dépendances de la Tâche API sélectionnée.
  5. Cliquez sur Suivant.
  6. Ajoutez les détails de planification de la Tâche API.
    Dans le champ Calendrier, sélectionnez l\'une des options suivantes :
    • Exécuter une fois : Exécute la Tâche API une fois, le jour et l\'heure spécifiés.

      Utilisez les options suivantes pour configurer le paramètre Run once :

      • Date de début : La valeur par défaut est le jour actuel.
      • Heure de début : La valeur par défaut est arrondie à la demi-heure suivante.
      • Fuseau horaire : Fuseau horaire du système sur votre périphérique local.
        Remarque : Les fuseaux horaires EST, HST ou MST sont obsolètes. Reportez-vous à la rubrique Prochaines obsolescences de fonctionnalités.
    • Exécuter de façon répétée : Utilisez cette option pour planifier votre Tâche API de sorte qu\'il s\'exécute à l\'heure spécifiée un jour donné.

      Utilisez les options suivantes pour configurer le paramètre Exécuter de manière répétée :

      • Date de début : Saisissez la date à laquelle vous souhaitez que la planification commence à exécuter le Tâche API.

        Saisissez la date manuellement au format AAAA/MM/JJ ou en utilisant le calendrier contextuel. La valeur par défaut du champ Date de début est définie sur le jour actuel de votre périphérique local.

      • Date de fin : Saisissez la date à laquelle vous souhaitez que la planification prenne fin.

        La Date de fin n\'est pas définie par défaut.

      • Heure de début : Définissez le champ Heure de début à l\'aide de la liste déroulante pour définir la valeur de l\'heure à laquelle vous souhaitez que votre planification commence.

        La liste contient des valeurs d\'heure prédéfinies au format 12 heures à intervalles de 15 minutes. Vous pouvez également définir manuellement la valeur d\'heure au format 12 heures.

      • Fuseau horaire : Sélectionnez le fuseau horaire pour l\'heure de début et l\'heure de fin.

        La valeur par défaut est définie sur l\'emplacement actuel de votre système. Une planification est exécutée en fonction du fuseau horaire sélectionné lors de sa création ou de sa modification.

      • Répéter chaque : Sélectionnez cette option pour répéter la planification.
    • Fréquence : Sélectionnez l\'une des options suivantes comme fréquence pour l\'exécution du programme :
      • Tous les jours : sélectionnez le nombre de jours pendant lesquels vous souhaitez que la planification s\'exécute.
      • Toutes les semaines : sélectionnez les semaines et les jours de la semaine où vous souhaitez que la planification s\'exécute.

        Par exemple, si vous souhaitez que la planification s\'exécute toutes les 2 semaines, le lundi et le jeudi, définissez l\'option Chaque sur 2 et cochez les cases Lundi et Jeudi.

      • Tous les mois : Sélectionnez l\'une des options suivantes :
        • Jour : sélectionnez le jour des mois où vous souhaitez que la planification s\'exécute.
        • Le : sélectionnez une occurrence particulière du jour des mois où vous souhaitez que la planification s\'exécute.

          Par exemple, si vous souhaitez que la planification soit exécutée le deuxième jeudi de janvier, mai et septembre, sélectionnez Deuxième, Jeudi et Janvier, Mai et Septembre parmi les options proposées.

        Remarque : Lorsque l\'heure d\'été est activée et que la Date de début est planifiée, la date est affichée dans le fuseau horaire auquel elle appartient (et non dans le fuseau horaire actuel de l\'utilisateur). Cependant, la Prochaine occurrence est affichée dans le fuseau horaire (fuseau horaire du système de l\'utilisateur) selon l\'heure d\'été.

        Par exemple, pour une planification créée le 15 mars dans le fuseau horaire GMT, la Date de début est indiquée comme étant le 15 mars, conformément au fuseau horaire GMT. Ultérieurement, lorsque l\'heure d\'été est activée et que vous modifiez ou affichez cette planification au mois d\'août dans le fuseau horaire BST, la prochaine occurrence est indiquée en août conformément au fuseau horaire BST.

        Si vous planifiez l\'exécution de la tâche du 23/11/2023 à 9 h 00 au 30/11/2023 à 9 h 00 avec la fréquence définie sur Tous les jours, la tâche s\'exécute quotidiennement à partir du 23/11/2023 à 9 h 00, et la dernière tâche est exécutée le 30/11/2023 à 9 h 00.

    • Dans la section Paramètre de planification manquée, cochez la case Redéployer la planification pour redéployer une planification manquée à cause de toute Control Room fermeture de.

      Lorsque l\'option Redéployer la planification est sélectionnée, les planifications manquées à cause de tout Control Room arrêt de la sont automatiquement redéployées après le Control Room redémarrage de la. Une entrée dans le journal d\'audit est également ajoutée, indiquant le Type d\'événement comme étant Schedule misfired.

      Remarque : Pour garantir un déploiement réussi lors de l\'utilisation de l\'option Redéployer à nouveau le planning, vous devez démarrer le service de compilation avant de redémarrer les services de Control Room.
  7. Cliquez sur Suivant.
  8. Utilisez l\'onglet Utilisateurs Exécuter en tant que pour effectuer les opérations suivantes :
    • Sélectionnez les utilisateurs dans la liste du champ Exécutions en tant qu\'utilisateurs disponibles et cliquez sur la flèche vers le bas pour ajouter votre sélection.

      Les utilisateurs que vous avez sélectionnés sont répertoriés dans le tableau sélectionné. Vous pouvez utiliser la flèche vers le haut pour supprimer l\'un des utilisateurs sélectionnés.

      Remarque : Le système génère un utilisateur appelé apitaskrunner qui est associé au rôle AAE_API Task Runner pour établir le contexte de l\'utilisateur Exécuter en tant que pour les Tâches API.
    • Dans le champ Définir le nombre d\'utilisateurs Exécuter en tant que à utiliser, choisissez l\'une des options suivantes :
      • Tous les utilisateurs Exécuter en tant que : sélectionnez cette option pour spécifier tous les utilisateurs disponibles dans le tableau sélectionné comme utilisateurs Exécuter en tant que, lors de l\'exécution de la Tâche API.
      • Nombre personnalisé d\'utilisateurs Exécuter en tant que : sélectionnez cette option pour fournir un certain nombre d\'utilisateurs du tableau sélectionné que vous souhaitez utiliser comme utilisateurs Exécuter en tant que.

        Par exemple, si vous avez 5 utilisateurs dans le tableau sélectionné et que vous souhaitez en utiliser seulement 3 comme utilisateurs Exécuter en tant que, saisissez 3. Les 3 utilisateurs répertoriés en haut du tableau sont utilisés comme utilisateurs Exécuter en tant que lors de l\'exécution de la Tâche API.

  9. Cliquez sur Suivant.
  10. Facultatif : L\'onglet Général permet de modifier les paramètres par défaut des options suivantes :
    • Nom de l\'activité : modifiez ou renommez le Tâche API.
    • Priorité d\'automatisation : cliquez sur le menu déroulant pour définir la priorité d\'automatisation.

      Moyen est la priorité d\'automatisation par défaut, mais vous pouvez la modifier afin de traiter les automatisations pour le déploiement en conséquence.

  11. Cliquez sur Créer une planification.
    Le Tâche API est prévu. Vous pouvez consulter le statut de la Tâches API planifiée sur la page Gérer > Planifiée.