Gestion de la Planification

Le système de gestion de la planification de Softyflow vous permet d'automatiser l'exécution des processus et des tâches à des moments spécifiques ou à des intervalles définis. Le système prend en charge plusieurs modèles de planification, modes d'environnement et offre des capacités complètes de surveillance et de gestion des erreurs.

Aperçu​

Le système de gestion de la planification se compose de :

• Interface Frontend : Composant Vue.js pour créer et gérer les tâches planifiées
• Processeur de Tâches Backend : Système basé sur Agenda.js pour exécuter les tâches planifiées
• Support Multi-Environnements : Modes Test, UAT et Production
• Options de Temporisation Flexibles : DateTime, intervalles et expressions Cron
• Notifications d'Erreur : Alertes email automatisées pour les processus échoués
• Gestion des Logs : Nettoyage et surveillance automatisés

Création de Tâches Planifiées​

Accès à l'Interface de Planification​

Naviguez vers Ressources → Scheduling Tasks dans l'IDE Softyflow pour accéder à l'interface de planification.

Configuration de Base de la Planification​

1. Cliquez sur "Create Scheduling Tasks" pour ouvrir la boîte de dialogue de création

2. Sélectionnez le Mode d'Environnement :

   • TEST : Pour le développement et les tests
   • UAT : Pour les tests d'acceptation utilisateur
   • PROD : Pour les environnements de production

3. Choisissez le Projet et le Processus :

   • Sélectionnez le projet cible dans le menu déroulant
   • Choisissez le processus spécifique à planifier (filtré par projet sélectionné)

4. Définissez la Date et l'Heure de Début :

   • Utilisez le sélecteur de date pour choisir quand la planification doit commencer
   • L'heure est spécifiée à la minute près

Options de Planification​

Planification par Intervalles​

Pour des répétitions régulières, choisissez parmi :

• Days : Exécuter tous les X jours
• Hours : Exécuter toutes les X heures
• Minutes : Exécuter toutes les X minutes

Exemple : Pour exécuter un processus toutes les 2 heures, sélectionnez "Hours" et entrez "2" dans la valeur de délai.

Planification par Expression Cron​

Pour des modèles de planification complexes, utilisez les expressions Cron :

Format de Syntaxe Cron :

Seconds (0-59) Minutes (0-59) Hours (0-23) Day_of_Month (1-31) Months (1-12) Day_of_Week (0-7) Year (1970-2099)

Exemples Courants d'Expressions Cron :

• 0 0 9 * * MON-FRI * - Chaque jour de la semaine à 9h00
• 0 30 14 * * * * - Chaque jour à 14h30
• 0 0 0 1 * * * - Premier jour de chaque mois à minuit
• 0 */15 * * * * * - Toutes les 15 minutes

Validation Cron :

• Le système valide les expressions Cron en temps réel
• Une coche verte indique une syntaxe valide
• Un X rouge indique des erreurs de syntaxe
• Cliquez sur le bouton de validation pour voir les messages d'erreur détaillés

Gestion des Erreurs et Notifications​

Détection Automatique des Erreurs​

Le système surveille en continu :

• Les instances de processus échouées
• Les dépassements de délai d'exécution
• Les erreurs système lors des exécutions planifiées

Notifications par Email​

Exigences de Configuration :

• Paramètres du fournisseur de messagerie dans le système
• Destinataires de notifications spécifiques au projet
• Configuration SMTP ou Mailgun

Contenu des Notifications :

• Nom du projet et résumé de l'erreur
• Liste des instances échouées
• Horodatages et détails des erreurs
• Liens directs vers l'interface Softyflow

Résolution des Erreurs​

Lorsque des erreurs surviennent :

1. Consultez les notifications pour les détails spécifiques de l'erreur
2. Examinez les instances échouées dans l'interface principale
3. Corrigez les problèmes sous-jacents dans la conception du processus
4. Réexécutez ou replanifiez si nécessaire

Meilleures Pratiques​

Directives de Planification​

1. Commencez par le Mode Test : Testez toujours les planifications dans l'environnement de test en premier
2. Utilisez des Intervalles Appropriés : Évitez la sur-planification pour prévenir la surcharge du système
3. Surveillez les Performances : Vérifiez les ressources système lors de la planification de tâches fréquentes
4. Définissez des Délais Réalistes : Accordez suffisamment de temps pour l'achèvement des processus

Conseils pour les Expressions Cron​

1. Testez les Expressions Complexes : Utilisez des validateurs Cron en ligne pour les modèles complexes
2. Considérez les Fuseaux Horaires : Assurez l'alignement du fuseau horaire du serveur
3. Documentez les Expressions Personnalisées : Ajoutez des commentaires expliquant les planifications complexes
4. Validez Avant de Sauvegarder : Vérifiez toujours le validateur de syntaxe

Gestion des Environnements​

1. Séparez les Préoccupations : Utilisez des planifications différentes pour différents environnements
2. Prudence en Production : Vérifiez doublement toutes les planifications de production
3. Déploiement Progressif : Testez en UAT avant de passer en production
4. Surveillez l'Utilisation des Ressources : Suivez les performances du système à travers les environnements

Dépannage​

Problèmes Courants​

La Planification ne s'Exécute pas :

• Vérifiez que la date/heure de début est dans le futur
• Vérifiez si le processus associé existe et est valide
• Assurez-vous que le service agenda est en cours d'exécution

Erreurs d'Expression Cron :

• Utilisez le validateur intégré
• Vérifiez le nombre correct de champs (7 champs requis)
• Vérifiez que les caractères spéciaux sont correctement échappés

Les Notifications par Email ne s'Envoient pas :

• Vérifiez la configuration du fournisseur de messagerie
• Vérifiez les adresses email des destinataires
• Assurez-vous que les identifiants SMTP/Mailgun sont valides

Problèmes de Performance :

• Examinez la fréquence de planification
• Surveillez les performances de la base de données
• Vérifiez les exécutions planifiées qui se chevauchent

Obtenir de l'Aide​

Pour un support supplémentaire :

• Consultez les logs système pour les messages d'erreur détaillés
• Examinez l'état des tâches agenda dans la base de données
• Contactez les administrateurs système pour les problèmes d'infrastructure
• Consultez la documentation sur la conception du processus pour les problèmes spécifiques aux flux de travail