{{:blocks:logo-apl.png?nolink|}} ===== Bloc Course Recycle (recyclage de cours) : Guide technique===== ====Permissions==== * Addinstance : Permet d'ajouter le bloc aux cours * View : Voir ce bloc - enseignant non éditeur par defaut * Admin : Gérer les options du bloc (statut du cours) enseignants par default ====Web services==== Les Web Services du bloc Recyclage de cours ne concernent actuellement que le mode GUILess. * **block_course_recycle_get_archivables()** : Récupère la liste courante des cours à archiver sur la plate-forme source. Elle est invoquée à partir d'une plate-forme d'archives. ==Paramètres== Pas de paramètres * **block_course_recycle_update_course_status($courseidfield, $courseid, $status, $postactions)** : Elle est invoquée par la plate-forme d'archives sur la plate-forme source pour rendre compte de la fin du processus d'archivage d'un cours et mettre à jour l'information de recyclage de la source. == Paramètres == * **courseidfield** : Indique le champ de référence pour l'identification du cours (id, idnumber ou shortname) * **courseid** : Donne l'identifiant du cours selon le champ précédent. * **status** : Indique le nouveau statut du cours. (Dans l'implémentation actuelle, la plate-forme d'archives renvoie un statut "Done" ou "Failed" si une erreur s'est produite à la récupération du cours archivé). * **postactions** : Renvoie le statut original avant archivage pour que la plate-forme source puisse déterminer les actions supplémentaires à exécuter après archivage. ====Tâches programmées==== === Tâches du mode GUI (Contrôle du cycle de recyclage) === * **task_show** : S'exécute une fois pas période de gestion pour activer l'affichage du sélecteur de choix. * **task_lock** : S'exécute une fois par période de recyclage pour bloquer les choix de recyclage. * **task_recycle** : S'exécute une fois par période de recyclage pour effectuer les actions de recyclage. * **task_reset** : S'exécute une fois en début de période de recyclage pour masquer les sélecteurs de choix === Tâches du mode GUILess === Les tâches du mode GUILess ne s'exécutent pas sur toutes les plates-formes. Certaines sont destinées à la plate-forme "source" qui est archivée, tandis que d'autres ne sont exécutées que sur la plate-forme d'archives. == Tâches sources == * **discover_finished_courses_task** : Examine les cours de la plate-forme et détecte les cours qui sont considérés comme terminés. Accessoirement, cette tâche examine les relances mails à effectuer pour demander aux enseignants de se positionner sur la destination de leurs cours. == Tâches archives == * **pull_and_archive_courses_task** : Récupère la liste des cours à archiver et procède aux archivages. ----- ==== Crédits ==== * Valéry Frémaux -Développements et tests * Florence Labord - Documentation et tests [[blocks:courserecycle|Index du composant]]- [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]