Skip to content

Latest commit

 

History

History
131 lines (98 loc) · 6.14 KB

connecteurs.md

File metadata and controls

131 lines (98 loc) · 6.14 KB
Raw

Connecteurs

Oasis s'intègre dans le SI de l'établissement en s'appuyant sur plusieurs briques existantes. Cette section décrit ces connexions et comment il est possible de les configurer / adapter.

Serveur OAuth

L'application utilise une authentification OAuth, testée avec un serveur CAS v5.
Le seul champ utilisé est l'id de l'utilisateur, qui doit correspondre au champ uid coté LDAP.

Annuaire LDAP

L'annuaire LDAP est utilisé dans plusieurs contextes :

  • lors de l'authentification d'un utilisateur non déjà connu, récupération des champs uid, sn, givenname, mail et supannetuid.
  • lors de la recherche d'un utilisateur en vue de lui attribuer un rôle, recherche textuelle sur les champs uid et cn (par défaut, cf plus bas) pour récupération des mêmes champs que précédemment.

La liste des champs de recherche est adaptable via la variable d'environnement LDAP_CHAMPS_RECHERCHE, et vous pouvez également personnaliser la recherche en ajoutant des critères via la variable LDAP_CRITERES_RECHERCHE_SUP.
Par exemple pour les valeurs suivantes :

LDAP_CHAMPS_RECHERCHE='["uid", "cn"]'
LDAP_CRITERES_RECHERCHE_SUP="(eduPersonAffiliation=member)(|(ubxstatutcompte=ACTIF)(ubxstatutcompte=NOUVEAU))"

la recherche de la chaine de caractères "toto" se fera avec la requête (&(eduPersonAffiliation=member)(|(ubxstatutcompte=ACTIF)(ubxstatutcompte=NOUVEAU))(|(uid=*toto*)(cn=*toto*)))

SI scolarité

Oasis récupère des informations relatives à l'identité et aux inscriptions des étudiants dans le SI Scolarité. À ce jour un connecteur Apogée via connexion à la base Oracle est disponible.

Données récupérées

Oasis récupère actuellement dans Apogée :

  • les inscriptions :
    • composantes de formation (table composante)
    • étape, version d'étape, libellé web de version d'étape, discipline, libellé de diplôme, niveau LMD (basé sur une table locale ! ) (table formation)
    • inscription d'un étudiant à une formation pour une période donnée (table inscription - les début et fin de période sont figées au 01/09 et 31/08 de l'année universitaire)
    • statut boursier (déprécié, plus montré dans l'interface)
    • régime d'inscription
  • des données personnelles complémentaires non présentes dans l'annuaire :
    • numéro de téléphone perso
    • date de naissance
    • civilité d'usage

Ces données sont récupérées à la création initiale de l'utilisateur dans l'application, puis rafraichies par un traitement hebdomadaire.
Un rafraichissement est également déclenché à la connexion si l'utilisateur qui se connecte est un étudiant déjà connu pour lequel on n'a pas d'inscription en cours en base.

Personnalisation

Plusieurs possibilités:

  • personnaliser la requête Apogée
  • écrire sa propre classe de récupération des données

Personnaliser la requête

Deux requêtes sont utilisées et adaptables pour vos besoins en modifiant simplement les fichiers sql disponibles dans le dossier config/apogee (attention à bien respecter les noms des champs retournés !) :

  • apogee_get_formation.sql : récupère le diplôme, la discipline, et le niveau LMD d'une version d'étape
  • apogee_get_inscriptions.sql : récupère pour un étudiant la liste de ses inscriptions et données personnelles complémentaires entre deux dates
    • année
    • version d'étape
    • composante
    • diplôme
    • discipline
    • composante
    • date de naissance
    • civilité d'usage
    • numéro de téléphone perso
    • témoin "boursier"
    • régime d'inscription

Les versions livrées de ces requêtes s'appuient sur une table locale extern_niveau_etape pour remonter le niveau LMD, vous devrez donc les adapter. Le niveau LMD peut être simplement laissé vide.

Implémentation sa propre classe

Vous pouvez aussi opter pour une réimplémentation locale de l'interfaçage avec le SI scolarité (pour utiliser les WS apogée, pour un établissement utilisant Pegase...) en étendant la classe abstraite App\Service\SiScol\AbstractSiScolDataProvider.

Les méthodes à implémenter sont le miroir des deux requêtes plus haut : getInscriptions doit retourner un tableau des inscriptions, getFormation retourne un tableau contenant les informations de cette formation. Attention à respecter le format de tableau en prenant exemple sur l'implémentation fournie.

GED Nuxeo

Voir la section dédiée aux pièces justificatives

Photos

Oasis peut récupérer et afficher les photos des étudiants (aux utilisateurs ayant un rôle gestionnaire ou supérieur).
Cette fonctionnalité est totalement optionnelle, si vous laissez la configuration par défaut l'application affichera des silhouettes à la place des photos.

La récupération des photos est réalisée à l'Université de Bordeaux en interrogeant directement la base de données Oracle de l'application Uni'Campus de Monécarte, mais cette solution est spécifique à nos usages et peut difficilement être généralisée.

Il est donc prévu de pouvoir implémenter la récupération des photos avec la méthode de votre choix, simplement en implémentant l'interface App\Service\Photo\PhotoProviderInterface et en référençant votre propre implémentation comme celle par défaut de l'interface dans la configuration de symfony : dans le fichier config/services.yaml ajoutez dans les bindings par défaut un binding de l'interface vers votre implémentation locale :

services:
  _defaults:
    autowire: true      # Automatically injects dependencies in your services.
    autoconfigure: true # Automatically registers your services as commands, event subscribers, etc.
    bind:
      App\Service\FileStorage\StorageProviderInterface $storageProvider: '@App\Service\FileStorage\NuxeoStorageProvider'
      App\Service\Photo\PhotoProviderInterface $photoProvider: '@App\Service\Photo\MonImplementationLocale'
      $startScheduleNow: '%env(resolve:APP_SCHEDULER_START_NOW)%'

Cette interface ne contient qu'une méthode, retournant pour l'utilisateur passé en paramètre le contenu d'une image JPEG.