Scripts complexes
Spécificités techniques
- L'ensemble des entités des différents types de ressources hérite de l'entité "Ressource" à l'aide de l'annotation doctrine "@ORM\InheritanceType("SINGLE_TABLE")" qui génère une table unique "ressource".
- Les traductions se font à l'aide du service "TraductionsServices" mais pour la compatibilité avec le code initial, on utilisera plutôt la fonction "getTabParamsWithTraductionsAndParams" du service "UtilsServices".
- Les téléchargements sur le serveur se font dans le répertoire "web\UploadDir".
- Certains contrôleurs héritent du contrôleur "BaseController" qui contient entre autres des fonctions permettant de récupérer les différents repository, des fonctions pour vérifier les rôles des utilisateurs et des fonctions pour récupérer des paramètres sensés être génériques à tous les contrôleurs comme certaines traductions. Un refactoring serait nécessaire pour supprimer cette classe inutile mais appelée à de nombreux endroits.
- L'entité "Activite" fait référence aux services et devrait être renommée. Son repository est "ServicesRepository" (et non "ActiviteRepository") et est donc appelé par la fonction "getSR()" dans les classes se servant du "BaseController".
- Les paramètres globaux de l'application modifiables par l'administrateur sont tous stockés dans la première ligne de la table "parametresgeneraux". Cette table ne doit donc contenir qu'une seule ligne et si on désire rajouter un paramètre il faudra donc rajouter une colonne à celle-ci.
- Au niveau des pages des calendriers des différents services, certains éléments sont référencés directement à l'aide d'indices de leur position dans le DOM. Il faut donc éviter autant que possible de rajouter, modifier ou supprimer des éléments du dom dans ces pages.
Batchs et commandes
Les tâches planifiées sont toutes regroupées dans le fichier "src\UnivLorraine\plateformeLansadBundle\Resources\batchs\batchEdolang.bash" .
Elles sont exécutées chaque nuit à l'aide de crontab (à minuit). (Le cron exécute ce fichier bash.) Son exécution dure environ 15 minutes.
Ce fichier regroupe les commandes Symfony qui doivent être lancées.
On dénombre 6 commandes actuellement:
- univlorraine:lansad:nettoyagePaniers qui enlève du panier des apprenants les exemplaires non empruntés ajoutés il y a plus d'un jour.
- univlorraine:lansad:rappelsEmprunts qui envoie un mail de rappel à tous les utilisateurs (les enseignants) n'ayant pas rendu un exemplaire au bout de 15 jours.
- univlorraine:lansad:rappelsInscription qui envoie un mail de rappel à tous les utilisateurs inscrits à un service le lendemain.
- univlorraine:lansad:nettoyageCarnetBordConsultationLigne qui ferme les lignes de carnet de bord de consultation en ligne de plus de 6 heures (et compte 3 heures de consultation).
- univlorraine:lansad:purgeInfosPersonnelles qui anonymise les utilisateurs qui ne sont plus présent dans l'annuaire LDAP(met à null les login, nom, prénom, mail et les rend inactifs). Aucune donnée rattachée n'est supprimée pour conserver leurs statistiques. La commande nécessite un paramètre fixé à 500 qui détermine le nombre maximal d'utilisateurs à purger pour éviter une purge accidentelle excessive.
- univlorraine:lansad:statistiques qui calcule jour par jour les statistiques ne pouvant être effectuées à la volée à partir du dernier jour non calculé (valeur en base de donnée du champ `dernierJourCalculStatistiques` de la table `parametresgeneraux`).
D'autres commandes sont également disponibles afin d'être exécutées ponctuellement:
- univlorraine:lansad:actualiservetscomposante qui permet d'actualiser les VETs et la composante des utilisateurs.
- univlorraine:lansad:importcalao qui permet de lancer l'import données données de CALAO. (Voir l'import des données de CALAO)
- univlorraine:lansad:nbCarnetsBord qui permet d'afficher sur la sortie standard le nombre de carnets de bord avec au moins une ligne.
- univlorraine:lansad:uploadIconeSelectionQuinzaine qui permet de télécharger l'icône d'une catégorie de sélection de la quinzaine tout en l'associant en base de donnée à celle-ci. (Voir la documentation d'installation)