############################################################################## # ScoDoc # Copyright (c) 1999 - 2022 Emmanuel Viennet. All rights reserved. # See LICENSE ############################################################################## """ ScoDoc 9 API : accès aux formations """ from flask import jsonify import app from app import models from app.api import bp from app.api.errors import error_response from app.api.auth import permission_required_api from app.models.formations import Formation from app.scodoc import sco_formations from app.scodoc.sco_permissions import Permission @bp.route("/formations", methods=["GET"]) @permission_required_api(Permission.ScoView, Permission.APIView) def formations(): """ Retourne la liste de toutes les formations (tous départements) """ data = [d.to_dict() for d in models.Formation.query] return jsonify(data) @bp.route("/formations_ids", methods=["GET"]) @permission_required_api(Permission.ScoView, Permission.APIView) def formations_ids(): """ Retourne la liste de toutes les id de formations (tous départements) Exemple de résultat : [ 17, 99, 32 ] """ data = [d.id for d in models.Formation.query] return jsonify(data) @bp.route("/formation/<int:formation_id>", methods=["GET"]) @permission_required_api(Permission.ScoView, Permission.APIView) def formation_by_id(formation_id: int): """ La formation d'id donné formation_id : l'id d'une formation Exemple de résultat : { "id": 1, "acronyme": "BUT R&T", "titre_officiel": "Bachelor technologique réseaux et télécommunications", "formation_code": "V1RET", "code_specialite": null, "dept_id": 1, "titre": "BUT R&T", "version": 1, "type_parcours": 700, "referentiel_competence_id": null, "formation_id": 1 } """ formation = models.Formation.query.get_or_404(formation_id) return jsonify(formation.to_dict()) @bp.route( "/formation/formation_export/<int:formation_id>", methods=["GET"], defaults={"export_ids": False}, ) @bp.route( "/formation/formation_export/<int:formation_id>/with_ids", methods=["GET"], defaults={"export_ids": True}, ) @permission_required_api(Permission.ScoView, Permission.APIView) def formation_export_by_formation_id(formation_id: int, export_ids=False): """ Retourne la formation, avec UE, matières, modules formation_id : l'id d'une formation export_ids : True ou False, si l'on veut ou non exporter les ids Exemple de résultat : { "id": 1, "acronyme": "BUT R&T", "titre_officiel": "Bachelor technologique r\u00e9seaux et t\u00e9l\u00e9communications", "formation_code": "V1RET", "code_specialite": null, "dept_id": 1, "titre": "BUT R&T", "version": 1, "type_parcours": 700, "referentiel_competence_id": null, "formation_id": 1, "ue": [ { "acronyme": "RT1.1", "numero": 1, "titre": "Administrer les r\u00e9seaux et l\u2019Internet", "type": 0, "ue_code": "UCOD11", "ects": 12.0, "is_external": false, "code_apogee": "", "coefficient": 0.0, "semestre_idx": 1, "color": "#B80004", "reference": 1, "matiere": [ { "titre": "Administrer les r\u00e9seaux et l\u2019Internet", "numero": 1, "module": [ { "titre": "Initiation aux r\u00e9seaux informatiques", "abbrev": "Init aux r\u00e9seaux informatiques", "code": "R101", "heures_cours": 0.0, "heures_td": 0.0, "heures_tp": 0.0, "coefficient": 1.0, "ects": "", "semestre_id": 1, "numero": 10, "code_apogee": "", "module_type": 2, "coefficients": [ { "ue_reference": "1", "coef": "12.0" }, { "ue_reference": "2", "coef": "4.0" }, { "ue_reference": "3", "coef": "4.0" } ] }, { "titre": "Se sensibiliser \u00e0 l'hygi\u00e8ne informatique et \u00e0 la cybers\u00e9curit\u00e9", "abbrev": "Hygi\u00e8ne informatique", "code": "SAE11", "heures_cours": 0.0, "heures_td": 0.0, "heures_tp": 0.0, "coefficient": 1.0, "ects": "", "semestre_id": 1, "numero": 10, "code_apogee": "", "module_type": 3, "coefficients": [ { "ue_reference": "1", "coef": "16.0" } ] }, ... ] }, ... ] }, ] } """ formation = Formation.query.get_or_404(formation_id) app.set_sco_dept(formation.departement.acronym) try: data = sco_formations.formation_export(formation_id, export_ids) except ValueError: return error_response(500, message="Erreur inconnue") return jsonify(data) @bp.route("/formation/moduleimpl/<int:moduleimpl_id>", methods=["GET"]) @permission_required_api(Permission.ScoView, Permission.APIView) def moduleimpl(moduleimpl_id: int): """ Retourne un module moduleimpl en fonction de son id moduleimpl_id : l'id d'un moduleimpl Exemple de résultat : { "id": 1, "formsemestre_id": 1, "module_id": 1, "responsable_id": 2, "moduleimpl_id": 1, "ens": [], "module": { "heures_tp": 0, "code_apogee": "", "titre": "Initiation aux réseaux informatiques", "coefficient": 1, "module_type": 2, "id": 1, "ects": null, "abbrev": "Init aux réseaux informatiques", "ue_id": 1, "code": "R101", "formation_id": 1, "heures_cours": 0, "matiere_id": 1, "heures_td": 0, "semestre_id": 1, "numero": 10, "module_id": 1 } } """ modimpl = models.ModuleImpl.query.get_or_404(moduleimpl_id) return jsonify(modimpl.to_dict()) @bp.route( "/formation/<int:formation_id>/referentiel_competences", methods=["GET"], ) @permission_required_api(Permission.ScoView, Permission.APIView) def referentiel_competences(formation_id: int): """ Retourne le référentiel de compétences formation_id : l'id d'une formation return null si pas de référentiel associé. """ formation = models.Formation.query.get_or_404(formation_id) if formation.referentiel_competence is None: return jsonify(None) return jsonify(formation.referentiel_competence.to_dict())