03 - Règles de gestion

Modifié par Cédric Champmartin le 23/07/2024 - 15:15

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

Constitution d'une campagne de dématérialisation

Pour générer des attestations de réussite au diplôme, 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).

Les étudiants candidats à génération d'une attestation sont regroupés par versions d'étape (VET). Il s'agit des 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(), permettant de récupérer les étudiants, l'impose. Il est appelé avec les paramètres suivants : code de l'année, code et version de diplôme, code et version d'étape
  • 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é

Données administratives

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.

Résultats d'admission, mention et ECTS

3 cas sont possibles pour le résultat d'admission :

  • 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 le 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. Si le résultat d'admission est positif et que la délivrance du diplôme est autorisée, nous récupérons la mention et les crédits ECTS au niveau de la VDI.

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 recupererContratPedagogiqueResultatVdiVet_v2() appelé avec les paramètres suivants : code de l'étudiant, code de l'année, source "Apogée", état "délibération terminée", session à null, type de résultat à null, état de l'inscription à "En cours"

Les résultats sont alors filtrés sur cod_adm à 1 (Admission).

Pour être considéré comme admis, l'étudiant doit également avoir le témoin tem_dlv_aut_vdi à O pour au moins une session d'admission (table RESULTAT_VDI pour cod_ind, cod_dip, cod_vrs_vdi, cod_anu et cod_adm).

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 n'est ni générée ni envoyée.

Les blocages sont récupérés via le ws Apogée EtudiantMetier, méthode recupererInfosAdmEtuV2(). Voir table apogée TYP_BLOCAGE

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

Les mails suivant sont envoyés par l'application :

  • Notification des créations de campagne lorsque le gestionnaire demande la génération d'attestations pour un diplôme
  • Notification de fin de campagne pour le gestionnaire l'ayant lancé
  • Si l'envoi sur Digiposte est activé, notification de l'étudiant lorsque son coffre est créé chez Digiposte 
  • Si l'envoi par mail est activé, envoi de l'attestation PDF à l'étudiant

Process

hypercerts_schema.png

Digiposte

Succession des étapes :

  • Lors du processus de génération (cron), après le contrôle des blocages, l'application envoi les demandes d'adhésions à Digiposte pour les étudiants (sous forme d'un fichier zip déposé en sftp)
    • Les encours concernés sont alors en attente d'ouverture des coffres
  • A l'exécution suivante du cron, les coffres seront synchronisés dans Hypercerts
    • Pour les étudiants synchronisés, l'application enverra un mail pour les avertir de la création de leur coffre Digiposte
    • L'application génère les attestations pdf et les dépose chez Digiposte (sous forme d'un fichier zip déposé en sftp)
  • Après prise en compte du dépôt de l'attestation, Digiposte enverra pour chaque étudiant une notification par mail et les étudiants pourront accéder à leur coffre

Résiliation :

  • Les étudiants peuvent demander la résiliation du service Digiposte après l'envoi du mail Hypercerts
  • Si un document est présent dans le coffre Digiposte, l'étudiant devra télécharger le document (et le supprimer) de son coffre pour engager la résiliation
  • La synchronisation des coffres se chargera d'acquitter les demandes de résiliation pour que la suppression soit effective
  • Une fois résilié, plus aucune création de coffre ne sera effectuée pour l'étudiant par Hypercerts

Délais :

  • En prod, Digiposte conseille de limiter les envois d'adhésions et de routage à 1 par jour
    • Un étudiant avec admission aura donc son attestation sur un délai de 2 à 3 jours
  • En test, le passage du cron peut être réduit, par exemple toutes les 10 minutes
    • Un étudiant avec admission devrait avoir son attestation sur un délai de 20/30 minutes