# -*- mode: python -*- # -*- coding: utf-8 -*- ############################################################################## # # Gestion scolarite IUT # # Copyright (c) 1999 - 2024 Emmanuel Viennet. All rights reserved. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # # Emmanuel Viennet emmanuel.viennet@viennet.net # ############################################################################## """Global/Semestre Preferences for ScoDoc (version dec 2008) Preferences (paramètres) communs à tous les utilisateurs. Peuvent être définis globalement (pour tous les semestres) ou bien seulement pour un semestre précis. Chaque parametre est défini dans la base de données SQL par: - name : nom du parametre - value: valeur du parametre, ou NULL si on doit utiliser une valeur par défaut - formsemestre_id: semestre associé, ou NULL si applicable à tous les semestres pour lesquels une valeur spécifique n'est pas définie. Au niveau du code interface, on défini pour chaque préférence: - name (clé) - title : titre en français - initvalue : valeur initiale - explanation: explication en français - size: longueur du chap texte - input_type: textarea, separator, ... type de widget TrivialFormulator a utiliser - rows, rols: geometrie des textareas - category: misc ou bul ou page_bulletins ou abs ou general ou portal ou pdf ou pvpdf ou ... - only_global (default False): si vraie, ne peut pas etre associée a un seul semestre. Les titres et sous-titres de chaque catégorie sont définis dans PREFS_CATEGORIES On peut éditer les préférences d'une ou plusieurs catégories au niveau d'un semestre ou au niveau global. * niveau global: changer les valeurs, liste de catégories. * niveau d'un semestre: présenter valeur courante: valeur ou "definie globalement" ou par defaut lien "changer valeur globale" ------------------------------------------------------------------------------ Doc technique: * Base de données: Toutes les préférences sont stockées dans la table sco_prefs, qui contient des tuples (name, value, formsemestre_id). Si formsemestre_id est NULL, la valeur concerne tous les semestres, sinon, elle ne concerne que le semestre indiqué. * Utilisation dans ScoDoc 9 - lire une valeur: get_preference(name, formsemestre_id) nb: les valeurs sont des chaines, sauf: . si le type est spécifié (float ou int) . les boolcheckbox qui sont des entiers 0 ou 1 - avoir un mapping (read only) de toutes les valeurs: sco_preferences.SemPreferences(formsemestre_id) - éditer les preferences globales: sco_preferences.get_base_preferences(self).edit() - éditer les preferences d'un semestre: SemPreferences(formsemestre_id).edit() * Implémentation: sco_preferences.py PREF_CATEGORIES : définition des catégories de préférences (pour dialogues édition) prefs_definition : pour chaque pref, donne infos pour édition (titre, type...) et valeur par défaut. class BasePreferences Une instance unique par site (département, repéré par URL). - charge les preferences pour tous le semestres depuis la BD. .get(formsemestre_id, name) .is_global(formsemestre_id, name) .save(formsemestre_id=None, name=None) .set(formsemestre_id, name, value) .deleteformsemestre_id, name) .edit() (HTML dialog) class SemPreferences(formsemestre_id) Une instance par semestre, et une instance pour prefs globales. L'attribut .base_prefs point sur BasePreferences. .__getitem__ [name] .is_global(name) .edit(categories=[]) get_base_preferences(formsemestre_id) Return base preferences for current scodoc_dept (instance BasePreferences) """ import flask from flask import current_app, flash, g, render_template, request, url_for from app import db, log from app.models import Departement from app.scodoc import sco_cache from app.scodoc.sco_exceptions import ScoValueError, ScoException from app.scodoc.TrivialFormulator import TrivialFormulator import app.scodoc.notesdb as ndb from app.scodoc import sco_pdf import app.scodoc.sco_utils as scu def clear_base_preferences(): """Clear cached preferences""" # usefull only for tests, where the same process may run # successively on several databases g._SCO_BASE_PREFERENCES = {} # { dept_id: BasePreferences instance } def get_base_preferences(dept_id: int = None): """Return global preferences for the specified department or the current departement """ if dept_id is None: dept_id = g.scodoc_dept_id if not hasattr(g, "_SCO_BASE_PREFERENCES"): g._SCO_BASE_PREFERENCES = {} if not dept_id in g._SCO_BASE_PREFERENCES: g._SCO_BASE_PREFERENCES[dept_id] = BasePreferences(dept_id) return g._SCO_BASE_PREFERENCES[dept_id] def get_preference(name, formsemestre_id=None, dept_id=None): """Returns value of named preference. All preferences have a sensible default value, so this function always returns a usable value for all defined preferences names. If dept_id is None, use current dept (g.scodoc_dept_id) """ return get_base_preferences(dept_id=dept_id).get(formsemestre_id, name) def _convert_pref_type(p, pref_spec): """p est une ligne de la bd {'id': , 'dept_id': , 'name': '', 'value': '', 'formsemestre_id': } converti la valeur chaine en le type désiré spécifié par pref_spec """ if "type" in pref_spec: typ = pref_spec["type"] if typ == "float": # special case for float values (where NULL means 0) p["value"] = float(p["value"] or 0) elif typ == "int": p["value"] = int(float(p["value"] or 0)) else: raise ValueError("invalid preference type") if pref_spec.get("input_type", None) == "boolcheckbox": # boolcheckbox: la valeur stockée en base est une chaine "0" ou "1" # que l'on ressort en True|False if p["value"]: try: p["value"] = bool(int(p["value"])) except ValueError: log( f"""Warning: invalid value for boolean pref in db: '{p["value"]}'""" ) p["value"] = False else: p["value"] = False # NULL (backward compat) def _get_pref_default_value_from_config(name, pref_spec): """get default value store in application level config. If not found, use default value hardcoded in pref_spec. """ # XXX va changer avec la nouvelle base # search in scu.CONFIG if hasattr(scu.CONFIG, name): value = getattr(scu.CONFIG, name) log("sco_preferences: found default value in config for %s=%s" % (name, value)) else: # uses hardcoded default value = pref_spec["initvalue"] return value _INSTALLED_FONTS = ", ".join(sco_pdf.get_available_font_names()) PREF_CATEGORIES = ( # sur page "Paramètres" ("general", {"title": ""}), # voir paramètre titlr de TrivialFormulator ("misc", {"title": "Divers"}), ("apc", {"title": "BUT et Approches par Compétences"}), ("abs", {"title": "Suivi des absences", "related": ("bul",)}), ("assi", {"title": "Gestion de l'assiduité"}), ("portal", {"title": "Liaison avec portail (Apogée, etc)"}), ("apogee", {"title": "Exports Apogée"}), ( "pdf", { "title": "Mise en forme des documents PDF", "related": ("pvpdf", "bul_margins"), }, ), ( "pvpdf", { "title": "Procès verbaux de jury (documents PDF)", "related": ("pdf", "bul_margins"), }, ), # sur page "Réglages des bulletins de notes" ( "bul", { "title": "Réglages des bulletins de notes", "related": ("abs", "bul_margins", "bul_mail"), }, ), ( "bul_but_pdf", { "title": "Réglages des bulletins BUT", "related": ( "bul", "bul_margins", ), }, ), # sur page "Mise en page des bulletins" ( "bul_margins", { "title": "Marges additionnelles des bulletins, en millimètres", "subtitle": """Le bulletin de notes classique (pas BUT) est toujours redimensionné pour occuper l'espace disponible entre les marges. """, "related": ("bul", "bul_mail", "pdf"), }, ), ( "bul_mail", { "title": "Envoi des bulletins par e-mail", "related": ("bul", "bul_margins", "pdf"), }, ), ( "feuilles", {"title": "Mise en forme des feuilles (Absences, Trombinoscopes, Moodle, ...)"}, ), ("pe", {"title": "Avis de poursuites d'études"}), ("edt", {"title": "Connexion avec le logiciel d'emplois du temps"}), ("debug", {"title": "Tests / mise au point"}), ) class BasePreferences: """Global preferences""" _editor = ndb.EditableTable( "sco_prefs", "pref_id", ("pref_id", "dept_id", "name", "value", "formsemestre_id"), filter_dept=True, sortkey="name", convert_null_outputs_to_empty=False, # allow_set_id=True, #sco8 html_quote=False, # car markup pdf reportlab ( etc) filter_nulls=False, ) def __init__(self, dept_id: int): dept = db.session.get(Departement, dept_id) if not dept: log(f"BasePreferences: Invalid departement: {dept_id}") raise ScoValueError(f"BasePreferences: Invalid departement: {dept_id}") self.dept_id = dept.id self.init() self.load() def init(self): from app.scodoc import sco_bulletins_generator self.prefs_definition = ( ( "DeptName", { "initvalue": "Dept", "title": "Nom abrégé du département", "explanation": "acronyme: par exemple R&T, ORTF, HAL", "size": 12, "category": "general", "only_global": True, }, ), ( "DeptFullName", { "initvalue": "nom du département", "title": "Nom complet du département", "explanation": "apparaît sur la page d'accueil", "size": 40, "category": "general", "only_global": True, }, ), ( "UnivName", { "initvalue": "", "title": "Nom de l'Université", "explanation": "apparait sur les bulletins et PV de jury", "size": 40, "category": "general", "only_global": True, }, ), ( "InstituteName", { "initvalue": "", "title": "Nom de l'Institut", "explanation": """exemple "IUT de Villetaneuse". Peut être utilisé sur les bulletins. """, "size": 40, "category": "general", "only_global": True, }, ), ( "DeptIntranetTitle", { "initvalue": "Intranet", "title": "Nom lien intranet", "size": 40, "explanation": 'titre du lien "Intranet" en haut à gauche', "category": "general", "only_global": True, }, ), ( "DeptIntranetURL", { "initvalue": "", "title": """URL de l'"intranet" du département""", "size": 40, "explanation": 'lien "Intranet" en haut à gauche', "category": "general", "only_global": True, }, ), ( "emails_notifications", { "initvalue": "", "title": "e-mail(s) à qui notifier les opérations", "size": 70, "explanation": """optionnel; adresses séparées par des virgules; notifie les opérations (saisies de notes, etc). """, "category": "general", "only_global": False, # peut être spécifique à un semestre }, ), ( "emails_notifications_inscriptions", { "initvalue": "", "title": "e-mail(s) à qui notifier les inscriptions d'étudiants", "size": 70, "explanation": """optionnel; adresses séparées par des virgules; notifie les inscriptions/désincriptions de chaque individu. """, "category": "general", "only_global": False, # peut être spécifique à un semestre }, ), # ------------------ MISC ( "email_from_addr", { "initvalue": "", "title": "Adresse mail origine", "size": 40, "explanation": f"""adresse expéditeur pour tous les envois par mail (bulletins, notifications, etc.). Si vide, utilise la config globale. Pour les comptes (mot de passe), voir la config globale accessible en tant qu'administrateur depuis la page d'accueil. """, "category": "misc", "only_global": True, }, ), ( "use_ue_coefs", { "initvalue": 0, "title": """Utiliser les coefficients d'UE pour calculer la moyenne générale (hors BUT)""", "explanation": """Calcule les moyennes dans chaque UE, puis pondère ces résultats pour obtenir la moyenne générale. Par défaut, le coefficient d'une UE est simplement la somme des coefficients des modules dans lesquels l'étudiant a des notes. Attention: changer ce réglage va modifier toutes les moyennes du semestre !. Aucun effet en BUT. """, "input_type": "boolcheckbox", "category": "misc", "labels": ["non", "oui"], "only_global": False, }, ), # ------------------ APC / BUT ( "but_moy_skip_empty_ues", { "initvalue": 0, "title": "BUT: moyenne générale sans les UE sans notes", "explanation": """La moyenne générale indicative BUT est basée sur les moyennes d'UE pondérées par leurs ECTS. Si cette option est cochée, ne prend pas en compte les UEs sans notes. Attention: changer ce réglage va modifier toutes les moyennes du semestre !. Aucun effet dans les formations non BUT.""", "input_type": "boolcheckbox", "category": "apc", "labels": ["non", "oui"], "only_global": False, }, ), ( "but_disable_edit_poids_evaluations", { "initvalue": 0, "title": "Interdire de modifier les poids des évaluations", "explanation": """empêche la modification des poids des évaluations""", "input_type": "boolcheckbox", "category": "apc", "labels": ["non", "oui"], "only_global": False, }, ), # ------------------ Absences ( "email_chefdpt", { "initvalue": "", "title": "e-mail du chef du département", "size": 40, "explanation": "pour lui envoyer des notifications sur les absences", "category": "abs", "only_global": True, }, ), ( "work_saturday", { "initvalue": 0, "title": "Considérer le samedi comme travaillé", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "abs", "only_global": True, # devrait etre par semestre, mais demanderait modif gestion absences }, ), ( "abs_require_module", # affecte l'UI mais pas les fonctions de base { "initvalue": 0, "title": "Imposer l'indication du module lors de la saisie des absences", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "abs", "only_global": False, }, ), ( "handle_billets_abs", { "initvalue": 0, "title": 'Gestion de "billets" d\'absence', "explanation": 'fonctions pour traiter les "billets" déclarés par les étudiants sur un portail externe', "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "abs", "only_global": True, }, ), ( "abs_notify_chief", # renamed from "send_mail_absence_to_chef" { "initvalue": 0, "title": "Notifier les absences au chef", "explanation": "Envoyer un mail au chef si un étudiant a beaucoup d'absences", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "abs", "only_global": True, }, ), ( "abs_notify_respsem", { "initvalue": 0, "title": "Notifier les absences au dir. des études", "explanation": "Envoyer un mail au responsable du semestre si un étudiant a beaucoup d'absences", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "abs", }, ), ( "abs_notify_respeval", { "initvalue": 0, "title": "Notifier les absences aux resp. de modules", "explanation": "Envoyer un mail à chaque absence aux responsable des modules avec évaluation à cette date", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "abs", }, ), ( "abs_notify_etud", { "initvalue": 0, "title": "Notifier les absences aux étudiants concernés", "explanation": "Envoyer un mail à l'étudiant s'il a \"beaucoup\" d'absences", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "abs", }, ), ( "abs_notify_email", { "initvalue": "", "title": "Notifier à:", "explanation": "e-mail à qui envoyer des notification d'absences (en sus des autres destinataires éventuels, comme le chef etc.)", "size": 40, "category": "abs", }, ), ( "abs_notify_abs_threshold", { "initvalue": 10, "title": "Seuil de première notification", "explanation": "nb minimum d'absences (en 1/2 journées) avant notification", "size": 4, "type": "int", "convert_numbers": True, "category": "abs", }, ), ( "abs_notify_abs_increment", { "initvalue": 20, # les notification suivantes seront donc rares "title": "Seuil notifications suivantes", "explanation": "nb minimum d'absences (en 1/2 journées supplémentaires)", "size": 4, "type": "int", "convert_numbers": True, "category": "abs", }, ), ( "abs_notification_mail_tmpl", { "initvalue": """ --- Ceci est un message de notification automatique issu de ScoDoc --- L'étudiant %(nomprenom)s L'étudiant %(nomprenom)s L'étudiant %(nomprenom)s inscrit en %(inscription)s) inscrit en %(inscription)s) inscrit en %(inscription)s) a cumulé %(nbabsjust)s absences justifiées a cumulé %(nbabsjust)s absences justifiées a cumulé %(nbabsjust)s absences justifiées et %(nbabsnonjust)s absences NON justifiées. Le compte a pu changer depuis cet envoi, voir la fiche sur %(url_ficheetud)s. Votre dévoué serveur ScoDoc. PS: Au dela de %(abs_notify_abs_threshold)s, un email automatique est adressé toutes les %(abs_notify_abs_increment)s absences. Ces valeurs sont modifiables dans les préférences de ScoDoc. """, "title": """Message notification e-mail""", "explanation": """Balises remplacées, voir la documentation""", "input_type": "textarea", "rows": 15, "cols": 64, "category": "abs", }, ), # Assiduité ( "forcer_module", { "initvalue": 0, "title": "Imposer la déclaration du module", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "assi", "explanation": "toute saisie d'absence doit indiquer le module concerné", }, ), ( "non_present", { "initvalue": 0, "title": "Désactiver la saisie des présences", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "assi", "explanation": "Désactive la saisie et l'affichage des présences", }, ), ( "nb_heures_par_jour", { "initvalue": 8, "size": 10, "title": "Nombre d'heures de travail dans une journée", "type": "int", "explanation": "Est utilisé dans le calcul de la métrique 'heure'. ", "category": "assi", }, ), # ( # "assi_etat_defaut", # { # "explanation": "⚠ non fonctionnel, travaux en cours !", # "initvalue": "aucun", # "input_type": "menu", # "labels": ["aucun", "present", "retard", "absent"], # "allowed_values": ["aucun", "present", "retard", "absent"], # "title": "Définir l'état par défaut", # "category": "assi", # }, # ), ( "non_travail", { "initvalue": "sam, dim", "title": "Jours non travaillés", "size": 40, "category": "assi", "only_global": True, "explanation": "Liste des jours (lun,mar,mer,jeu,ven,sam,dim)", }, ), ( # La valeur stockée est scu.AssiduitesMetrics.SHORT: "1/2 J.", "J.", "H." "assi_metrique", { "initvalue": "1/2 J.", "input_type": "menu", "labels": scu.AssiduitesMetrics.LONG, "allowed_values": scu.AssiduitesMetrics.SHORT, "title": "Métrique de l'assiduité", "explanation": "Unité utilisée dans la fiche étudiante, les bilans et les calculs", "category": "assi", "only_global": True, }, ), ( "assi_seuil", { "initvalue": 3, "size": 10, "title": "Seuil d'alerte des absences", "type": "int", "explanation": "Nombres d'absences limite avant alerte (utilisation de l'unité métrique ↑ )", "category": "assi", "only_global": True, }, ), ( "assiduites_disable", { "initvalue": "", "title": "Désactiver le module d'assiduité", "size": 40, "category": "assi", "explanation": """Désactive complètement le suivi de l'assiduité sur ScoDoc. Indiquer un message à afficher pour orienter l'utilisateur. Laisser ce champ est vide pour utiliser l'assiduité dans ScoDoc. """, }, ), ( "abs_notify_max_freq", { "initvalue": 7, "title": "Fréquence maximale de notification", "explanation": "nb de jours minimum entre deux mails envoyés au même destinataire à propos d'un même étudiant ", "size": 4, "type": "int", "convert_numbers": True, "category": "abs", }, ), # portal ( "portal_url", { "initvalue": "", "title": "URL du portail", "size": 40, "category": "portal", "only_global": True, }, ), ( "portal_timeout", { "initvalue": 3, "title": "timeout", "explanation": "secondes", "size": 3, "type": "int", "convert_numbers": True, "category": "portal", "only_global": True, }, ), ( "portal_dept_name", { "initvalue": "Dept", "title": "Code du département sur le portail", "category": "portal", "only_global": True, }, ), ( "etapes_url", { "initvalue": "", "title": "URL listant les étapes Apogée", "size": 40, "category": "portal", "only_global": True, "explanation": "par defaut, selon l'api, getEtapes ou scodocEtapes sur l'URL du portail", }, ), ( "maquette_url", { "initvalue": "", "title": "URL maquettes Apogee", "size": 40, "category": "portal", "only_global": True, "explanation": "par defaut, scodocMaquette sur l'URL du portail", }, ), ( "portal_api", { "initvalue": 1, "title": "Version de l'API", "explanation": "1 ou 2", "size": 3, "type": "int", "convert_numbers": True, "category": "portal", "only_global": True, }, ), ( "etud_url", { "initvalue": "", "title": "URL listant les étudiants Apogée", "size": 40, "category": "portal", "only_global": True, "explanation": "par defaut, selon l'api, getEtud ou scodocEtudiant sur l'URL du portail", }, ), ( "photo_url", { "initvalue": "", "title": "URL donnant la photo d'un étudiant avec argument nip=", "size": 40, "category": "portal", "only_global": True, "explanation": "par defaut, selon l'api, getPhoto ou scodocPhoto sur l'URL du portail", }, ), ( "xml_etapes_by_dept", { "initvalue": 1, "title": "Etapes séparées par département", "explanation": "XML getEtapes structuré en départements ?", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "portal", "only_global": True, }, ), ( "notify_etud_changes_to", { "initvalue": "", "title": "e-mail à qui notifier les changements d'identité des étudiants", "explanation": "utile pour mettre à jour manuellement d'autres bases de données", "size": 40, "category": "portal", "only_global": True, }, ), ( "always_require_ine", { "initvalue": 0, "title": "Impose la présence du code INE", "explanation": "lors de toute création d'étudiant (manuelle ou non)", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "portal", "only_global": True, }, ), ( "always_require_apo_sem_codes", { "initvalue": 0, "title": "Impose la présence des codes Apogée", "explanation": "lors des créations de semestres", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "portal", "only_global": True, }, ), # exports Apogée ( "export_res_etape", { "initvalue": 1, "title": "Exporter résultat de l'étape", "explanation": "remplissage maquettes export Apogée", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "apogee", "only_global": True, }, ), ( "export_res_sem", { "initvalue": 1, "title": "Exporter résultat du semestre", "explanation": "remplissage maquettes export Apogée", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "apogee", "only_global": True, }, ), ( "export_res_ues", { "initvalue": 1, "title": "Exporter les résultats d'UE", "explanation": "remplissage maquettes export Apogée", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "apogee", "only_global": True, }, ), ( "export_res_modules", { "initvalue": 1, "title": "Exporter les résultats de modules", "explanation": "remplissage maquettes export Apogée", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "apogee", "only_global": True, }, ), ( "export_res_sdj", { "initvalue": 0, "title": "Exporter les résultats même sans décision de jury", "explanation": "si coché, exporte exporte étudiants même si pas décision de jury saisie (sinon laisse vide)", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "apogee", "only_global": True, }, ), ( "export_res_rat", { "initvalue": 1, "title": "Exporter les RAT comme ATT", "explanation": "si coché, exporte exporte étudiants en attente de ratrapage comme ATT (sinon laisse vide)", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "apogee", "only_global": True, }, ), ( "export_res_remove_typ_res", { "initvalue": 0, "title": "Ne pas recopier la section APO_TYP_RES", "explanation": "si coché, ne réécrit pas la section APO_TYP_RES (rarement utile, utiliser avec précaution)", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "apogee", "only_global": True, }, ), # pdf ( "SCOLAR_FONT", { "initvalue": "Helvetica", "title": "Police de caractère principale", "explanation": f"pour les pdf (Helvetica est recommandée, parmi {_INSTALLED_FONTS})", "size": 25, "category": "pdf", }, ), ( "SCOLAR_FONT_SIZE", { "initvalue": 10, "title": "Taille des caractères", "explanation": "pour les pdf", "size": 4, "type": "int", "convert_numbers": True, "category": "pdf", }, ), ( "SCOLAR_FONT_SIZE_FOOT", { "initvalue": 6, "title": "Taille des caractères pied de page", "explanation": "pour les pdf", "size": 4, "type": "int", "convert_numbers": True, "category": "pdf", }, ), ( "pdf_footer_extra", { "initvalue": "", "title": "Texte à ajouter en pied de page", "explanation": "sur tous les documents, par exemple vos coordonnées, ...", "size": 78, "category": "pdf", }, ), ( "pdf_footer_x", { "initvalue": 20, "title": "Position horizontale du pied de page pdf (en mm)", "size": 8, "type": "float", "category": "pdf", }, ), ( "pdf_footer_y", { "initvalue": 6.35, "title": "Position verticale du pied de page pdf (en mm)", "size": 8, "type": "float", "category": "pdf", }, ), # pvpdf ( "DirectorName", { "initvalue": "", "title": "Nom du directeur de l'établissement", "size": 32, "explanation": "pour les PV de jury", "category": "pvpdf", }, ), ( "DirectorTitle", { "initvalue": """directeur de l'IUT""", "title": 'Titre du "directeur"', "explanation": "titre apparaissant à côté de la signature sur les PV de jury", "size": 64, "category": "pvpdf", }, ), ( "PV_SIGNATURE_LEFT", { "initvalue": "", "title": "Texte signature PV gauche", "explanation": """texte optionnel placé sous la table du PV de jury, à gauche de la signature""", "input_type": "textarea", "rows": 1, "cols": 64, "category": "pvpdf", }, ), ( "ChiefDeptName", { "initvalue": "", "title": "Nom du chef de département", "size": 32, "explanation": "pour les bulletins pdf", "category": "pvpdf", }, ), ( "INSTITUTION_NAME", { "initvalue": "Institut Universitaire de Technologie - Université Paris 13", "title": "Nom institution sur pied de pages PV", "explanation": "(pdf, balises <b> interprétées)", "input_type": "textarea", "rows": 4, "cols": 64, "category": "pvpdf", }, ), ( "INSTITUTION_ADDRESS", { "initvalue": "Web www.iutv.univ-paris13.fr - 99 avenue Jean-Baptiste Clément - F 93430 Villetaneuse", "title": "Adresse institution sur pied de pages PV", "explanation": "(pdf, balises <b> interprétées)", "input_type": "textarea", "rows": 4, "cols": 64, "category": "pvpdf", }, ), ( "INSTITUTION_CITY", { "initvalue": "Villetaneuse", "title": "Ville de l'institution", "explanation": "pour les lettres individuelles", "size": 64, "category": "pvpdf", }, ), ( "PV_INTRO", { "initvalue": """- Vu l'arrêté du 3 août 2005 relatif au diplôme universitaire de technologie et notamment son article 4 et 6; - - - vu l'arrêté n° %(Decnum)s du Président de l'%(UnivName)s; - - - vu la délibération de la commission %(Type)s en date du %(Date)s présidée par le Chef du département; """, "title": """Paragraphe d'introduction sur le PV""", "explanation": """Balises remplacées: %(Univname)s = nom de l'université, %(DecNum)s = numéro de l'arrêté, %(Date)s = date de la commission, %(Type)s = type de commission (passage ou délivrance), %(VDICode)s = code diplôme""", "input_type": "textarea", "cols": 80, "rows": 10, "category": "pvpdf", }, ), ( "PV_WITH_BACKGROUND", { "initvalue": 0, "title": "Mettre l'image de fond sur les PV de jury (paysage)", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "pvpdf", }, ), ( "PV_WITH_HEADER", { "initvalue": 1, # legacy "title": "Ajouter l'en-tête sur les PV (paysage)", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "pvpdf", }, ), ( "PV_WITH_FOOTER", { "initvalue": 1, # legacy "title": "Ajouter le pied de page sur les PV (paysage)", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "pvpdf", }, ), ( "PV_TITLE_WITH_VDI", { "initvalue": 0, # legacy "title": "Indiquer VDI et code dans le titre du PV", "explanation": "il est souvent préférable de l'inclure dans le paragraphe d'introduction.", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "pvpdf", }, ), # marges PV paysages (en millimètres) ( "pv_left_margin", { "initvalue": 0, "size": 10, "title": "Marge gauche PV en mm", "type": "float", "category": "pvpdf", }, ), ( "pv_top_margin", { "initvalue": 23, "size": 10, "title": "Marge haute PV", "type": "float", "category": "pvpdf", }, ), ( "pv_right_margin", { "initvalue": 0, "size": 10, "title": "Marge droite PV", "type": "float", "category": "pvpdf", }, ), ( "pv_bottom_margin", { "initvalue": 5, "size": 10, "title": "Marge basse PV", "type": "float", "category": "pvpdf", }, ), ( "PV_LETTER_DIPLOMA_SIGNATURE", { "initvalue": """Le %(DirectorTitle)s,
%(DirectorName)s""", "title": """Signature des lettres individuelles de diplôme""", "explanation": """%(DirectorName)s et %(DirectorTitle)s remplacés""", "input_type": "textarea", "rows": 4, "cols": 64, "category": "pvpdf", }, ), ( "PV_LETTER_PASSAGE_SIGNATURE", { "initvalue": """Pour le Directeur de l'IUT
et par délégation
Le Chef du département""", "title": """Signature des lettres individuelles de passage d'un semestre à l'autre""", "explanation": """%(DirectorName)s et %(DirectorTitle)s remplacés""", "input_type": "textarea", "rows": 4, "cols": 64, "category": "pvpdf", }, ), ( "pv_sig_image_height", { "initvalue": 11, "size": 10, "title": "Hauteur de l'image de la signature", "type": "float", "explanation": "Lorsqu'on donne une image de signature, elle est redimensionnée à cette taille (en millimètres)", "category": "pvpdf", }, ), ( "PV_LETTER_TEMPLATE", { "initvalue": """  %(INSTITUTION_CITY)s, le %(date_jury)s à %(nomprenom)s %(domicile)s %(codepostaldomicile)s %(villedomicile)s Jury de %(type_jury)s
%(titre_formation)s Le jury de %(type_jury_abbrv)s du département %(DeptName)s s'est réuni le %(date_jury)s. s'est réuni le %(date_jury)s. s'est réuni le %(date_jury)s. Les décisions vous concernant sont : %(prev_decision_sem_txt)s Décision %(decision_orig)s : %(decision_sem_descr)s %(decision_ue_txt)s %(observation_txt)s %(autorisations_txt)s %(diplome_txt)s """, "title": """Lettre individuelle""", "explanation": """Balises remplacées et balisage XML, voir la documentation""", "input_type": "textarea", "rows": 15, "cols": 64, "category": "pvpdf", }, ), ( "PV_LETTER_WITH_BACKGROUND", { "initvalue": 0, "title": "Mettre l'image de fond sur les lettres individuelles de décision", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "pvpdf", }, ), ( "PV_LETTER_WITH_HEADER", { "initvalue": 0, "title": "Ajouter l'en-tête sur les lettres individuelles de décision", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "pvpdf", }, ), ( "PV_LETTER_WITH_FOOTER", { "initvalue": 0, "title": "Ajouter le pied de page sur les lettres individuelles de décision", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "pvpdf", }, ), ( "pv_htab1", { "initvalue": "8cm", "title": "marge colonne droite lettre", "explanation": "pour les courriers pdf", "size": 10, "category": "pvpdf", }, ), ( "pv_htab2", { "initvalue": "5mm", "title": "marge colonne gauche lettre", "explanation": "pour les courriers pdf", "size": 10, "category": "pvpdf", }, ), ( "PV_FONTNAME", { "initvalue": "Times-Roman", "title": "Police de caractère pour les PV", "explanation": f"pour les pdf ({_INSTALLED_FONTS})", "size": 25, "category": "pvpdf", }, ), # bul ( "bul_title", { "initvalue": "Université Paris 13 - IUT de Villetaneuse - Département %(DeptName)s", "size": 70, "title": "Titre des bulletins", "explanation": "%(DeptName)s est remplacé par le nom du département", "category": "bul", }, ), ( "bul_class_name", { "initvalue": sco_bulletins_generator.bulletin_default_class_name(), "input_type": "menu", "labels": sco_bulletins_generator.bulletin_class_descriptions(), "allowed_values": sco_bulletins_generator.bulletin_class_names(), "title": "Format des bulletins", "explanation": "format de présentation des bulletins de note (web et pdf), non utilisé en BUT.", "category": "bul", }, ), ( "bul_show_abs", # ex "gestion_absence" { "initvalue": 1, "title": "Indiquer les absences dans les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_abs_modules", { "initvalue": 0, "title": "Indiquer les absences dans chaque module", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_decision", { "initvalue": 0, "title": "Faire figurer les décisions de jury sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_ects", { "initvalue": 1, "title": "Faire figurer les ECTS sur les bulletins", "explanation": "crédits associés aux UE ou aux modules, selon réglage", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_codemodules", { "initvalue": 0, "title": "Afficher codes des modules sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_matieres", { "initvalue": 0, "title": "Afficher les matières sur les bulletins", "explanation": "(sans effet en BUT)", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_all_evals", { "initvalue": 0, "title": "Afficher toutes les évaluations sur les bulletins", "explanation": "y compris incomplètes ou futures (déconseillé, risque de publier des notes non définitives; n'affecte pas le calcul des moyennes)", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_rangs", { "initvalue": 1, "title": "Afficher le classement sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_ue_rangs", { "initvalue": 1, "title": "Afficher le classement dans chaque UE sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_mod_rangs", { "initvalue": 1, "title": "Afficher le classement dans chaque module sur les bulletins", "explanation": "(sans effet en BUT)", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_moypromo", { "initvalue": 0, "title": "Afficher moyennes de la promotion sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_minmax", { "initvalue": 0, "title": "Afficher min/max moyennes sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_minmax_mod", { "initvalue": 0, "title": "Afficher min/max moyennes des modules sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_minmax_eval", { "initvalue": 0, "title": "Afficher min/max moyennes des évaluations sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_ue_coef", { "initvalue": 1, "title": "Afficher coefficient des UE sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_coef", { "initvalue": 1, "title": "Afficher coefficient des modules sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_ue_cap_details", { "initvalue": 0, "title": "Afficher détail des notes des UE capitalisées sur les bulletins ", "explanation": "ne concerne pas les bulletins BUT", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_ue_cap_current", { "initvalue": 1, "title": "Afficher les UE en cours mais capitalisées sur les bulletins", "explanation": "ne concerne pas les bulletins BUT", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_temporary_forced", { "initvalue": 0, "title": 'Bannière "provisoire" sur les bulletins', "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_temporary", { "initvalue": 1, "title": 'Bannière "provisoire" si pas de décision de jury', "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_temporary_txt", { "initvalue": "Provisoire", "title": 'Texte de la bannière "provisoire', "explanation": "", "size": 40, "category": "bul", }, ), ( "bul_show_uevalid", { "initvalue": 1, "title": "Faire figurer les UE validées sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_mention", { "initvalue": 0, "title": "Faire figurer les mentions sur les bulletins et les PV", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_date_inscr", { "initvalue": 1, "title": "Faire figurer la date d'inscription sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_sig_left", { "initvalue": 0, "title": "Faire figurer le pied de page de gauche (ex.: nom du directeur) sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), ( "bul_show_sig_right", { "initvalue": 0, "title": "Faire figurer le pied de page de droite (ex.: nom du chef de département) sur les bulletins", "input_type": "boolcheckbox", "category": "bul", "labels": ["non", "oui"], }, ), # champs des bulletins PDF: ( "bul_pdf_title", { "initvalue": """ %(UnivName)s %(InstituteName)s RELEVÉ DE NOTES %(nomprenom)s %(demission)s Formation: %(titre_num)s Année scolaire: %(anneescolaire)s """, "title": "Bulletins PDF: paragraphe de titre", "explanation": "(balises interprétées, voir documentation)", "input_type": "textarea", "rows": 10, "cols": 64, "category": "bul", }, ), ( "bul_pdf_caption", { "initvalue": """%(situation)s""", "title": "Bulletins PDF: paragraphe sous table note", "explanation": '(visible seulement si "Faire figurer les décision" est coché)', "input_type": "textarea", "rows": 4, "cols": 64, "category": "bul", }, ), ( "bul_pdf_sig_left", { "initvalue": """La direction des études
%(responsable)s """, "title": "Bulletins PDF: signature gauche", "explanation": "(balises interprétées, voir documentation)", "input_type": "textarea", "rows": 4, "cols": 64, "category": "bul", }, ), ( "bul_pdf_sig_right", { "initvalue": """Le chef de département
%(ChiefDeptName)s """, "title": "Bulletins PDF: signature droite", "explanation": "(balises interprétées, voir documentation)", "input_type": "textarea", "rows": 4, "cols": 64, "category": "bul", }, ), ( "bul_pdf_mod_colwidth", { "initvalue": None, "title": "Bulletins PDF: largeur col. modules", "explanation": "en cm (vide ou 0 si auto)", "type": "float", "category": "bul", }, ), ( "bul_pdf_with_background", { "initvalue": 0, "title": "Mettre l'image de fond sur les bulletins", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "bul", }, ), ( "SCOLAR_FONT_BUL_FIELDS", { "initvalue": "Times-Roman", "title": "Police titres bulletins", "explanation": f"pour les pdf ({_INSTALLED_FONTS})", "size": 25, "category": "bul", }, ), # Bulletin court BUT # avec peu de réglages afin conserver la mise en page compacte... ( "bul_but_pdf_title", { "initvalue": """ %(UnivName)s %(InstituteName)s Bachelor Universitaire de Technologie """, "title": "Bulletins PDF BUT: paragraphe de titre", "explanation": "(balises interprétées, voir documentation)", "input_type": "textarea", "rows": 10, "cols": 64, "category": "bul_but_pdf", }, ), ( "bul_but_code_annuel", { "initvalue": 1, "title": "Bulletins BUT: afficher la décision annuelle", "explanation": "car en cours d'année elle n'a parfois pas de sens", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "bul_but_pdf", }, ), # XXX A COMPLETER, voir sco_formsemestre_edit.py XXX # bul_mail ( "email_copy_bulletins", { "initvalue": "", "title": "e-mail copie bulletins", "size": 40, "explanation": "adresse(s) recevant une copie des bulletins envoyés aux étudiants (si plusieurs, les séparer par des virgules)", "category": "bul_mail", }, ), ( "bul_intro_mail", { "initvalue": """%(nomprenom)s,\n\nvous trouverez ci-joint votre relevé de notes au format PDF.\nIl s\'agit d\'un relevé indicatif. Seule la version papier signée par le responsable pédagogique de l\'établissement prend valeur officielle.\n\nPour toute question sur ce document, contactez votre enseignant ou le directeur des études (ne pas répondre à ce message).\n\nCordialement,\nla scolarité du département %(dept)s.\n\nPS: si vous recevez ce message par erreur, merci de contacter %(webmaster)s""", "input_type": "textarea", "title": "Message d'accompagnement", "explanation": "%(DeptName)s est remplacé par le nom du département, %(nomprenom)s par les noms et prénoms de l'étudiant, %(dept)s par le nom du département, et %(webmaster)s par l'adresse mail du Webmaster.", "rows": 18, "cols": 85, "category": "bul_mail", }, ), ( "bul_mail_list_abs", { "initvalue": 0, "title": "Indiquer la liste des dates d'absences par mail", "explanation": "dans le mail envoyant le bulletin de notes", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "bul_mail", }, ), ( "bul_mail_list_abs_nb", { "initvalue": 10, "title": "Nombre maximum de dates par catégorie", "explanation": "dans la liste des absences dans le mail envoyant le bulletin de notes (catégories : abs,abs_just, retard,justificatifs)", "type": "int", "size": 3, "category": "bul_mail", }, ), ( "bul_mail_contact_addr", { "initvalue": "l'administrateur", "title": 'Adresse mail contact "webmaster"', "explanation": 'apparait dans le mail accompagnant le bulletin, voir balise "webmaster" ci-dessus.', "category": "bul_mail", "size": 32, }, ), ( "bul_mail_allowed_for_all", { "initvalue": 1, "title": "Autoriser tous les utilisateurs à expédier des bulletins par mail", "input_type": "boolcheckbox", "category": "bul_mail", "labels": ["non", "oui"], }, ), # bul_margins ( "left_margin", { "initvalue": 0, "size": 10, "title": "Marge gauche", "type": "float", "category": "bul_margins", }, ), ( "top_margin", { "initvalue": 0, "size": 10, "title": "Marge haute", "type": "float", "category": "bul_margins", }, ), ( "right_margin", { "initvalue": 0, "size": 10, "title": "Marge droite", "type": "float", "category": "bul_margins", }, ), ( "bottom_margin", { "initvalue": 0, "size": 10, "title": "Marge basse", "type": "float", "category": "bul_margins", }, ), # Mise en page feuilles absences/trombinoscopes ( "feuille_releve_abs_taille", { "initvalue": "A4", "input_type": "menu", "labels": ["A3", "A4"], "allowed_values": ["A3", "A4"], "title": "Taille feuille relevé absences", "explanation": "Dimensions du papier pour les feuilles de relevés d'absences hebdomadaire", "category": "feuilles", }, ), ( "feuille_releve_abs_format", { "initvalue": "Paysage", "input_type": "menu", "labels": ["Paysage", "Portrait"], "allowed_values": ["Paysage", "Portrait"], "title": "Format feuille relevé absences", "explanation": "Format du papier pour les feuilles de relevés d'absences hebdomadaire", "category": "feuilles", }, ), ( "feuille_releve_abs_samedi", { "initvalue": 1, "title": "Samedi travaillé", "input_type": "boolcheckbox", "labels": ["non", "oui"], "category": "feuilles", }, ), ( "feuille_releve_abs_AM", { "initvalue": "2", "title": "Créneaux cours matin", "explanation": "Nombre de créneaux de cours le matin", "size": 4, "type": "int", "convert_numbers": True, "category": "feuilles", }, ), ( "feuille_releve_abs_PM", { "initvalue": "3", "title": "Créneaux cours après-midi", "explanation": "Nombre de créneaux de cours l'après-midi", "size": 4, "type": "int", "convert_numbers": True, "category": "feuilles", }, ), ( "feuille_placement_emargement", { "initvalue": "625", "title": "Feuille d'émargement des contrôles - Signature étudiant", "explanation": "Hauteur de l'espace pour signer", "size": 4, "type": "int", "convert_numbers": True, "category": "feuilles", }, ), ( "feuille_placement_positions", { "initvalue": "45", "title": "Feuille des places lors des contrôles", "explanation": "Nombre maximum de lignes par colonne", "size": 4, "type": "int", "convert_numbers": True, "category": "feuilles", }, ), # Feuille prepa jury ( "prepa_jury_nip", { "initvalue": 0, "title": "Code NIP sur la feuille préparation jury", "input_type": "boolcheckbox", "category": "feuilles", "labels": ["non", "oui"], "only_global": True, }, ), ( "prepa_jury_ine", { "initvalue": 0, "title": "Code INE sur la feuille préparation jury", "input_type": "boolcheckbox", "category": "feuilles", "labels": ["non", "oui"], "only_global": True, }, ), ( "anonymous_lst_code", { "initvalue": "NIP", "input_type": "menu", "labels": ["NIP", "INE"], "allowed_values": ["NIP", "INE"], "title": "Code pour listes anonymes", "explanation": "à défaut, un code interne sera utilisé", "category": "feuilles", "only_global": True, }, ), # Exports pour Moodle: ( "moodle_csv_with_headerline", { "initvalue": 0, "title": "Inclure une ligne d'en-têtes dans les fichiers CSV pour Moodle", "input_type": "boolcheckbox", "labels": ["non", "oui"], "only_global": True, "category": "feuilles", }, ), ( "moodle_csv_separator", { "initvalue": ",", "title": "séparateur de colonnes dans les fichiers CSV pour Moodle", "size": 2, "only_global": True, "category": "feuilles", }, ), # Experimental: avis poursuite d'études ( "NomResponsablePE", { "initvalue": "", "title": "Nom du responsable des poursuites d'études", "size": 32, "explanation": "pour les avis pdf de poursuite", "category": "pe", }, ), ( "pe_avis_latex_tmpl", { "title": "Template LaTeX des avis", "initvalue": "", "explanation": "préparez-le dans un éditeur de texte puis copier le contenu ici (en utf8). Sinon, le fichier un_avis.tex du serveur sera utilisé.", "input_type": "textarea", "rows": 4, "cols": 80, "category": "pe", }, ), ( "pe_avis_latex_footer", { "title": "Code LaTeX en fin d'avis", "initvalue": "", "explanation": "", "input_type": "textarea", "rows": 5, "cols": 80, "category": "pe", }, ), ( "pe_tag_annotation_avis_latex", { "title": "Tag désignant l'avis PE", "initvalue": "PE>", "explanation": """ajoutez une annotation aux étudiants précédée du tag désigné ici pour qu'elle soit interprétée comme un avis de poursuites d'études et ajoutée aux avis LaTeX.""", "size": 25, "category": "pe", }, ), # Lien avec logiciel emplois du temps ( "edt_sem_ics_url", { "title": "Lien EDT", "initvalue": "", "explanation": "URL du calendrier ics emploi du temps du semestre (template)", "size": 80, "category": "edt", }, ), # Divers ( "ImputationDept", { "title": "Département d'imputation", "initvalue": "", "explanation": "optionnel: préfixe id de formsemestre (par défaut, le nom du département). Pour usages API avancés.", "size": 10, "category": "edt", }, ), ( "email_test_mode_address", { "title": "Adresse de test", "initvalue": "", "explanation": """si cette adresse est indiquée, TOUS les mails envoyés par ScoDoc de ce département vont aller vers elle AU LIEU DE LEUR DESTINATION NORMALE !""", "size": 60, "category": "debug", "only_global": True, }, ), ) self.prefs_name = set([x[0] for x in self.prefs_definition]) self.prefs_only_global = set( [x[0] for x in self.prefs_definition if x[1].get("only_global", False)] ) self.prefs_dict = dict(self.prefs_definition) def load(self): """Load all preferences from db""" # log(f"loading preferences for dept_id={self.dept_id}") cnx = ndb.GetDBConnexion() if self.dept_id: g.scodoc_dept_id = self.dept_id preflist = self._editor.list(cnx, {"dept_id": self.dept_id}) self.prefs = {None: {}} # { formsemestre_id (or None) : { name : value } } self.default = {} # { name : default_value } for p in preflist: if not p["formsemestre_id"] in self.prefs: self.prefs[p["formsemestre_id"]] = {} # Ignore les noms de préférences non utilisés dans le code: if p["name"] not in self.prefs_dict: continue # Convert types: if p["name"] in self.prefs_dict: _convert_pref_type(p, self.prefs_dict[p["name"]]) self.prefs[p["formsemestre_id"]][p["name"]] = p["value"] # add defaults for missing prefs for pref in self.prefs_definition: name = pref[0] # search preferences in configuration file if name and name[0] != "_" and name not in self.prefs[None]: value = _get_pref_default_value_from_config(name, pref[1]) self.default[name] = value self.prefs[None][name] = value if not current_app.testing: log(f"creating missing preference for {name}={value}") # add to db table self._editor.create( cnx, {"dept_id": self.dept_id, "name": name, "value": value} ) def get(self, formsemestre_id, name): """Returns preference value. when no value defined for this semestre, returns global value. """ if formsemestre_id in self.prefs: return self.prefs[formsemestre_id].get(name, self.prefs[None][name]) return self.prefs[None][name] def __contains__(self, item): return item in self.prefs[None] def __len__(self): return len(self.prefs[None]) def is_global(self, formsemestre_id, name): "True if name if not defined for semestre" params = { "dept_id": self.dept_id, "name": name, "formsemestre_id": formsemestre_id, } cnx = ndb.GetDBConnexion() plist = self._editor.list(cnx, params) return len(plist) == 0 def save(self, formsemestre_id=None, name=None): """Write one or all (if name is None) values to db""" modif = False cnx = ndb.GetDBConnexion() if name is None: names = list(self.prefs[formsemestre_id].keys()) else: names = [name] for name in names: value = self.prefs[formsemestre_id][name] if self.prefs_dict[name].get("input_type", None) == "boolcheckbox": # repasse les booleens en chaines "0":"1" value = "1" if value else "0" # existe deja ? pdb = self._editor.list( cnx, args={ "dept_id": self.dept_id, "formsemestre_id": formsemestre_id, "name": name, }, ) if len(pdb) > 1: # suppress buggy duplicates (may come from corrupted database for ice ages) log( f"**oups** detected duplicated preference !\n({self.dept_id}, {formsemestre_id}, {name}, {value})" ) for obj in pdb[1:]: self._editor.delete(cnx, obj["id"]) pdb = [pdb[0]] if not pdb: # crée préférence log(f"create pref sem={formsemestre_id} {name}={value}") self._editor.create( cnx, { "dept_id": self.dept_id, "name": name, "value": value, "formsemestre_id": formsemestre_id, }, ) modif = True else: # edit existing value existing_value = pdb[0]["value"] # old stored value if ( (existing_value != value) and (existing_value != str(value)) and (existing_value or str(value)) ): self._editor.edit( cnx, { "pref_id": pdb[0]["pref_id"], "formsemestre_id": formsemestre_id, "name": name, "value": value, }, ) modif = True log("save pref sem=%s %s=%s" % (formsemestre_id, name, value)) # les preferences peuvent affecter les PDF cachés et les notes calculées: if modif: sco_cache.invalidate_formsemestre() def set(self, formsemestre_id: int, name: str, value: str): """Set and save a preference value. If formsemestre_id is None, global pref. """ if not name or name[0] == "_" or name not in self.prefs_name: raise ValueError(f"invalid preference name: {name}") if formsemestre_id and name in self.prefs_only_global: raise ValueError("pref %s is always defined globaly") if not formsemestre_id in self.prefs: self.prefs[formsemestre_id] = {} self.prefs[formsemestre_id][name] = value self.save(formsemestre_id, name) # immediately write back to db def delete(self, formsemestre_id, name): if not formsemestre_id: raise ScoException() if formsemestre_id in self.prefs and name in self.prefs[formsemestre_id]: del self.prefs[formsemestre_id][name] cnx = ndb.GetDBConnexion() pdb = self._editor.list( cnx, args={"formsemestre_id": formsemestre_id, "name": name} ) if pdb: log(f"deleting pref sem={formsemestre_id} {name}") assert pdb[0]["dept_id"] == self.dept_id self._editor.delete(cnx, pdb[0]["pref_id"]) sco_cache.invalidate_formsemestre() # > modif preferences def edit(self): """HTML dialog: edit global preferences""" self.load() H = [ f"

Préférences globales pour le département {g.scodoc_dept}

", # f"""

modification des logos du département (pour documents pdf)

""" # if current_user.is_administrator() # else "", """

Ces paramètres s'appliquent par défaut à tous les semestres, sauf si ceux-ci définissent des valeurs spécifiques.

Attention: cliquez sur "Enregistrer les modifications" en bas de page pour appliquer vos changements !

""", ] form = self.build_tf_form() tf = TrivialFormulator( request.base_url, scu.get_request_args(), form, initvalues=self.prefs[None], submitlabel="Enregistrer les modifications", title="Département et institution", before_table="
{title}", after_table="
", ) dest_url = url_for("scolar.index_html", scodoc_dept=g.scodoc_dept) if tf[0] == 0: return render_template( "sco_page_dept.j2", content="\n".join(H) + tf[1], title=f"Préférences {g.scodoc_dept}", javascripts=["js/detail_summary_persistence.js"], ) if tf[0] == -1: return flask.redirect(dest_url) # cancel # for pref in self.prefs_definition: self.prefs[None][pref[0]] = tf[2][pref[0]] self.save() flash("Préférences modifiées") return flask.redirect(dest_url) def build_tf_form(self, categories: list[str] = None, formsemestre_id: int = None): """Build list of elements for TrivialFormulator. If formsemestre_id is not specified, edit global prefs. """ form = [] for cat, cat_descr in PREF_CATEGORIES: if categories and cat not in categories: continue # skip this category # cat_elems = [] for pref_name, pref in self.prefs_definition: if pref["category"] == cat: if pref.get("only_global", False) and formsemestre_id: continue # saute les prefs seulement globales descr = pref.copy() descr["comment"] = descr.get("explanation", None) if "explanation" in descr: del descr["explanation"] if formsemestre_id: descr[ "explanation" ] = f"""ou utiliser paramètre global""" if formsemestre_id and self.is_global(formsemestre_id, pref_name): # valeur actuelle globale (ou vient d'etre supprimée localement): # montre la valeur et menus pour la rendre locale descr["readonly"] = True menu_global = f""" {descr["comment"] or ''} """ descr["explanation"] = menu_global cat_elems.append((pref_name, descr)) if cat_elems: # category titles: title = cat_descr.get("title", None) if title: form.append( ( f"table_{cat}", { "input_type": "table_separator", "title": f"{title}", }, ) ) subtitle = cat_descr.get("subtitle", None) if subtitle: form.append( ( f"sepsub_{cat}", { "input_type": "separator", "title": f'

{subtitle}

', }, ) ) form.extend(cat_elems) return form class SemPreferences: """Preferences for a formsemestre""" def __init__(self, formsemestre_id=None, dept_id=None): self.formsemestre_id = formsemestre_id if dept_id is None and g.scodoc_dept is None: self.base_prefs = {} else: self.base_prefs = get_base_preferences(dept_id=dept_id) def __getitem__(self, name): return self.base_prefs.get(self.formsemestre_id, name) def __contains__(self, item): "check if item is in (global) preferences" return item in self.base_prefs def get(self, name, defaultvalue=None): # utilisé seulement par TF try: return self[name] # ignore supplied default value except: return defaultvalue def is_global(self, name): "True if preference defined for all semestres" return self.base_prefs.is_global(self.formsemestre_id, name) # The dialog def edit(self, categories=[]): """Dialog to edit semestre preferences in given categories""" if not self.formsemestre_id: raise ScoValueError( "sem_preferences.edit doit etre appele sur un semestre !" ) # a bug ! H = [ """

Les paramètres définis ici ne s'appliqueront qu'à ce semestre.

Attention: cliquez sur "Enregistrer les modifications" en bas de page pour appliquer vos changements !

""", ] # build the form: form = self.base_prefs.build_tf_form( categories=categories, formsemestre_id=self.formsemestre_id ) form.append(("suppress", {"input_type": "hidden"})) form.append(("create_local", {"input_type": "hidden"})) form.append(("destination", {"input_type": "hidden"})) form.append(("formsemestre_id", {"input_type": "hidden"})) tf = TrivialFormulator( request.base_url, scu.get_request_args(), form, initvalues=self, cssclass="sco_pref", submitlabel="Enregistrer les modifications", title="Département et institution", before_table="
{title}", after_table="
", ) dest_url = url_for( "notes.formsemestre_status", scodoc_dept=g.scodoc_dept, formsemestre_id=self.formsemestre_id, ) if tf[0] == 0: return render_template( "sco_page.j2", content="\n".join(H) + tf[1], title="Préférences du semestre", javascripts=["js/detail_summary_persistence.js"], ) elif tf[0] == -1: flash("Annulé") return flask.redirect(dest_url) else: # Supprime pref locale du semestre (retour à la valeur globale) if tf[2]["suppress"]: self.base_prefs.delete(self.formsemestre_id, tf[2]["suppress"]) # Cree pref local (copie valeur globale) if tf[2]["create_local"]: cur_value = self[tf[2]["create_local"]] self.base_prefs.set( self.formsemestre_id, tf[2]["create_local"], cur_value ) # Modifie valeurs: for pref_name, descr in self.base_prefs.prefs_definition: if ( pref_name in tf[2] and not descr.get("only_global", False) and pref_name != tf[2]["suppress"] ): form_value = tf[2][pref_name] cur_value = self[pref_name] if cur_value is None: cur_value = "" else: cur_value = str(cur_value) if cur_value != str(form_value): # log('cur_value=%s (type %s), form_value=%s (type %s)' % (cur_value,type(cur_value),form_value, type(form_value))) self.base_prefs.set(self.formsemestre_id, pref_name, form_value) # destination: # global: change pref and redirect to global params # again: change prefs and redisplay this dialog # done: change prefs and redirect to semestre status destination = tf[2]["destination"] if destination == "done" or destination == "": flash("Préférences modifiées") return flask.redirect(dest_url) elif destination == "again": return flask.redirect( request.base_url + "?formsemestre_id=" + str(self.formsemestre_id) ) elif destination == "global": return flask.redirect( url_for("scolar.edit_preferences", scodoc_dept=g.scodoc_dept) ) # def doc_preferences(): """Liste les preferences en MarkDown, pour la documentation""" L = [] for cat, cat_descr in PREF_CATEGORIES: L.append([""]) L.append(["## " + cat_descr.get("title", "")]) L.append([""]) L.append(["Nom", " ", " "]) L.append(["----", "----", "----"]) for pref_name, pref in get_base_preferences().prefs_definition: if pref["category"] == cat: L.append( ["`" + pref_name + "`", pref["title"], pref.get("explanation", "")] ) return "\n".join([" | ".join(x) for x in L]) def bulletin_option_affichage( formsemestre: "FormSemestre", prefs: SemPreferences ) -> dict: "dict avec les options d'affichages (préférences) pour ce semestre" fields = ( "bul_show_abs", "bul_show_abs_modules", "bul_show_ects", "bul_show_codemodules", "bul_show_matieres", "bul_show_rangs", "bul_show_ue_rangs", "bul_show_mod_rangs", "bul_show_moypromo", "bul_show_minmax", "bul_show_minmax_mod", "bul_show_minmax_eval", "bul_show_coef", "bul_show_ue_cap_details", "bul_show_ue_cap_current", "bul_show_temporary", "bul_temporary_txt", "bul_show_uevalid", "bul_show_date_inscr", ) # on enlève le "bul_" de la clé: fields = {field[4:]: prefs[field] for field in fields} # Ajoute les réglages du formsemestre qui ne sont pas des préférences: fields["block_moyenne_generale"] = formsemestre.block_moyenne_generale fields["bgcolor"] = formsemestre.bul_bgcolor return fields