Authentification et droits utilisateurs
L'authentification se fait via le CAS de l'établissement.
Les droits proviennent d'Apogée. L'utilisateur doit disposer du droit d'édition dans Apogée pour les composantes qu'il gère dans l'application. Sans ce droit, aucune action n'est possible.
La récupération des droits se fait par une requête SQL.
A partir du type Apogée de l'utilisateur connecté, on recherche s'il dispose du traitement TRAREF10 (Edition d'attestations de réussite) pour le domaine RE (Collecte et diffusion des résultats) et ce pour quelles composantes.
Tables utilisées : UTILISATEUR, TYP_UTILISATEUR, TUT_AVOIR_DROIT_FCT, UTI_COLLECTER_CTN et COMPOSANTE
Attestations de réussite au diplôme
Pour générer des attestations, il convient de sélectionner une année (parmi les années ouvertes dans Apogée), une composante (selon ses droits) et une version de diplôme (VDI).
Les version de diplômes proposées sont celles associées à la composante et identifiées comme terminales dans Apogée ou sans diplôme intermédiaire (comme par exemple les licences pro). Leur nature doit également être différente de "Absence de diplôme" (code 9, paramétrable dans l'application).
Ces attestations sont ventilées en campagnes,. Les campagnes correspondent aux versions d'étape (VET) diplômantes de la VDI sélectionnée.
La récupération des VDI se fait via une requête SQL sur les tables VERSION_DIPLOME et CMP_HABILITER_VDI. Seules les VDI dont l'année de fin d'habilitation est supérieure ou égale à l'année demandée dans l'application sont considérées. Le libellé récupéré est lib_web_vdi.
La récupération des VET se fait via le ws Apogée OffreFormation, méthode recupererSE_v3(). Ce ws est appelé avec les paramètres suivants :
- code de l'année demandée
- code et version du diplôme demandé
- code et version d'étape ; tous
- code élément pédagogique : aucun
- témoin ouvert recrutement : null
Parmi les VET résultats, seules les diplômantes sont prises en compte (requête SQL complémentaire sur la table version_etape, témoin tem_dip_vet à 'O')
Note :
- Nous travaillons au niveau VET car le ws Apogée EtudiantMetier, méthode recupererListeEtudiants() l'impose.
- Les ws Apogée ne permettent pas d'obtenir le libelle officiel d'un diplôme pour une VDI. Pour cela, nous utilisons les tables PERIODE_PARAM_EDITION, PREFIXE_INT, VERSION_DIPLOME et PARCOURS_TYPE (cf la requête SQL des reports Oracle pour générer les attestations de réussite). Les 5 colonnes de libellés et le parcours type sont mis bout à bout, en terminant par le parcours type. Les virgules et la capitalisation sont conservées telles qu'elles sont dans Apogée.
- Les données des étudiants (prénom1, prénom2, nom, date de naissance, email...) sont récupérées via le ws Apogée EtudiantMetier, méthode recupererIdentifiantsEtudiant().
Les adresses mail des étudiant•es sont sujettes à expiration / modification. On admet qu'elles sont valides car elles sont maintenues à jour dans Apogée par synchronisation avec le LDAP. Cela se fait via le package PKB_ANNU dans lequel chaque établissement peut indiquer la façon de récupérer cette info. Il est possible lors de la phase de test de vérifier les adresses qui seront destinataires en réel. Elles sont loggées en INFO lorsque l'application est en mode test.
Il est possible si nécessaire de relancer la génération des attestations. Cette relance ne prendra en compte que les étudiants pour lesquels l'envoi du mail ou le dépôt digiposte (selon la configuration de l'application) n'a pas été réalisé
Résultats d'admission
3 cas sont possibles :
- L'étudiant•e est reçu•e
- L'étudiant•e n' est pas reçu•e
- Pas de verdict (les résultats ne sont pas dans Apogée)
Pour les déterminer, nous récupérons la liste des contrats pédagogiques pour cet•te étudiant•e et l'année considérée. Nous filtrons cette liste par diplôme et VDI pour obtenir le contrat pédagogique qui nous intéresse. Nous avons alors autant de résultats qu'il y a de sessions (0 : session unique, session 1, session 2 : rattrapage). Ces résultats étant triés dans l'ordre des sessions, nous conservons la dernière.
Les cas d'admission et de non-admission sont très variés (admis, ajourné, défaillant, démission etc.). Pour ne pas avoir à tous les gérer, nous utilisons le témoin codNegTre qui permet de savoir facilement si les résultats d'admissions sont favorables ou non:
- Si codNegTre == 1: étudiant•e reçu•e
- Si codNegTre == 0: étudiant•e non reçu•e
- Si null: pas de résultats
Il est récupéré via le ws Apogée PedagogiqueMetier, méthode recupererResultatsVDIVET_v6().
Blocages
Il existe différents types de blocages :
- Blocage sur examens
- Blocage sur inscription administrative et/ou pédagogique
- Blocage sur inscription administrative à distance
- Blocage sur délivrance auto. diplôme
En cas de blocage, l'attestation est générée mais pas envoyée.
Les blocages sont récupérés via le ws Apogée EtudiantMetier, méthode recupererInfosAdmEtuV2().
Signataire
Le signataire apposé aux attestations est le Président de l'Université. Sa signature numérique est récupérée de la base Apogée.
La récupération du signataire se fait par une requête SQL.
Tables utilisées : SIGNATAIRE et SIGN_TAMP_DIGITALISE
Note : il n'y a pas de méthode pour trouver le code signataire du Président dans Apogée. Il faut donc le préciser dans le fichier application.yaml de l'application avec la clé pour déchiffrer le blob de la signature.
Mails
Des mails sont envoyés pour :
- Accuser le lancement d'une campagne quand le/la gestionnaire demande la génération d'attestations pour une VDI
- Notifier le/la gestionnaire qui a lancé une campagne du résultat de celle-ci (nombre d'attestations envoyées, étudiant•es en erreurs etc.)
- Transmettre les attestations au format PDF aux étudiant•es (si cet envoi est activé dans la configuration de l'application)
