Interface scolarité – APOGÉE

Procédure

L’export des données d’Apogée doit se faire au format CSV dont le contenu est précisé ci dessous.

Ce fichier doit ensuite être déposé par vos soins dans le répertoire tel que défini dans le paramétrage applicatif.

Il faut également configurer le batch d’import des données comme précisé dans la partie Batch et Planification.

Caractère à remplacer

Dans l’export des données venant d’Apogée il faut remplacer :

  • le caractère dit apostrophe courbe ’ par l’apostrophe droit ‘

Format du fichier d’import

Le fichier requis par Calcium doit être basé sur l’ISO-8859-1.

Il doit être au format CSV dont le séparateur est le point-virgule, et dont les données ne contiennent pas de point-virgule (des données entre guillemets ne seront pas protégées).

Exemple vierge : Calcium.csv

Il doit impérativement comprendre les colonnes suivantes :

Entête & Orthographe

La ligne d’entête est OBLIGATOIRE.

Attention à bien respecter le nom EXACT des colonnes comme préciser ci dessous.

* données requises

ColonneDescriptionRemarques
COD_ANU *Code Année
COD_NNEIdentifiant National Etudiant
COD_NNINuméro INSEE
COD_ETUCode étudiant
NOM *Nom patronymique
NOMUSAGENom courant
PRENOM1 *Prénom 1
PRENOM2Prénom 2
PRENOM3Prénom 3
SEXE *Genre (M, F, INCONNU)
DATENAI *Date de naissance au format JJ/MM/AAAA
CODE_NATIO *Code nationalité (en rapport avec la nomenclature PAYS dans Calcium)
SITUAFAMCode situation familiale (en rapport avec la nomenclature SITUATION FAMILIALE DE L ETUDIANT dans Calcium)
CODEBRSCode bourse
CODEFINANCCode aide financière
TEM_AFFL_SSOAffiliation à la sécurité sociale (O ou N)
CENTREPAYEURCode centre payeur
CODEMUTCode du droit mutuelle
ADR1Champ adresse 1 de l’adresse personnelle<= 50 caractères
ADR2Champ adresse 2 de l’adresse personnelle<= 50 caractères
ADR3Champ adresse 3 de l’adresse personnelle<= 50 caractères
COD_BDICode postal de l’adresse personnelle
COMMUNECommune de l’adresse personnelle
PAYSCode pays de l’adresse personnelle (en rapport avec la nomenclature PAYS dans Calcium)
TELEPHNuméro de téléphone de l’étudiant
MAILEmail de l’étudiant
PCSCode profession du parent principal (en rapport avec la nomenclature PROFESSION dans Calcium)
ADR1FIXChamp adresse 1 de l’adresse familiale<= 50 caractères
ADR2FIXChamp adresse 2 de l’adresse familiale<= 50 caractères
ADR3FIXChamp adresse 3 de l’adresse familiale<= 50 caractères
BDIFIXCode postal de l’adresse familiale
COMMUNEFIXCommune de l’adresse familiale
PAYSFIXCode pays de l’adresse familiale (en rapport avec la nomenclature PAYS dans Calcium)
TELEPHFIXNuméro de téléphone de l’adresse familiale
ETB *Code établissement (en rapport avec la nomenclature ETABLISSEMENT dans Calcium)
CMP *Code composante (en rapport avec la nomenclature ETABLISSEMENT (sous niveau) dans Calcium)
CURSUSCursus de l’étudiant
ANNEEAnnée dans le cursus de l’étudiant
DIPLOMEDiplôme préparé<= 45 caractères
ETABLISSEMENTEtablissement secondaire
BACCode bac (en rapport avec la nomenclature BACCAULAUREAT dans Calcium)
DATEBACAnnée du bac
ETB_BACCode établissement du bac
DAA_ETBAnnée de l’entrée dans l’établissementformat YYYY
DAA_ENS_SUPAnnée de l’entrée dans l’Enseignement Supérieur en Franceformat YYYY
IDENTIFIANTIdentifiant CAS de l’étudiant (authentification de l’université)Login de l’étudiant

Fichiers de logs

ATTENTION, l’import de données peut créer jusqu’à 3 fichiers de logs dans le répertoire import.repertoire (cf. configuration context.xml) . Ces fichiers sont notamment ceux reçus dans le rapport de mail.

Il faut penser à prévoir un nettoyage au niveau du système de ces fichiers.

Fichier « log_XXX.txt »

Fichier de log « classique », on y trouve les opérations effectuées ainsi que les erreurs que l’import a pu soulever.

A la fin de ce fichier, on y trouve le nombre de lignes traitées

Fichier « erreurLogs_XXX.txt »

La principale information pour vérifier si un étudiant a déjà été importé est le NUMERO_INE

Viens ensuite les informations secondaires : le Patronyme, le Prénom, la Date de naissance et la Nationalité

Ce fichier de log ne contient que les erreurs remontées. Voici les erreurs que vous pouvez rencontrer :

Fichier d’import introuvable !

Comme son nom l’indique, le fichier d’import est introuvable. Veuillez vérifier le chemin renseigné dans le fichier de configuration application.yml concernant l’import de scolarité (cf Paramétrage applicatif)

Erreur de cohérence dans le fichier d’import

Soit le fichier d’import ne comporte pas le nombre nécessaire de colonnes (« Le fichier d’import doit contenir 46 colonnes« ), soit une erreur de frappe sur une colonne ou un échange entre les colonnes (« Colonne X doit être égale a CHAMP« )

  • La donnée ‘Patronyme’ est absente pour : XXX
  • La donnée ‘Prénom’ est absente pour : XXX
  • La donnée ‘Date de naissance’ est absente pour : XXX
  • La donnée ‘Nationalité’ est absente pour : XXX

XXX représente la ligne concernée. Au moins un des quatre champs obligatoires est absent, le dossier ne peut être créé.

Multiple code INE présent en base pour NUM_INE

Il existe au moins 2 étudiants dans la base de données qui ont comme numéro INE NUM_INE.

Il est possible de modifier un dossier étudiant, soit via l’application avec le droit nécessaire (Droit de modification d’info scolarité), soit via votre base de donnée.

Date de naissance non lisible – dossier non traité poue l’INE suivant : NUM_INE

La date de naissance de l’étudiant de numéro INE NUM_INE est dans un mauvais format, non reconnaissable ou un décalage a eu lieu sur la ligne qui a provoquée cette erreur.

Les clés secondaires (Patronyme, Prenom, DateNaiss et Nationalite) ne correspondent pas – dossier non traité pour l’INE suivant : NUM_INE

Ici, un étudiant avec le numéro INE NUM_INE existe dans la base de donnée, mais les clés secondaires ne correspondent pas.

C’est à vous de modifier les données du dossier étudiant, soit via l’application via la fiche Identité avec le droit nécessaire (Droit de modification d’info scolarité), soit via votre base de donnée.

Doublons potentiels car plusieurs réponses selon les clés secondaires – dossier non traité pour l’INE suivant : NUM_INE

Au moins deux étudiants existent déjà dans la base de données, avec le même patronyme, le même prénom, la même date de naissance et la même nationalité.

Erreur lors de la mise à jour (modèle importation) de : NUM_INE => MSG_ERR

Une erreur s’est produite lors de la liaison entre l’étudiant et le modèle d’importation utilisé. Veuillez contacter le support Calcium à propos de cette erreur.

Erreur de la modification de la date de naissance : DATE_NAISS pour : NUM_INE

Le champ DATE_NAISSANCE de l’étudiant NUM_INE n’a pas pu être traduit correctement, dû à un mauvais format de la date renseignée.

Fichier « erreurFile_XXX.csv »

Fichier CSV contenant les lignes non pris en compte lors de l’import, notamment car celles-ci ont été sources d’erreurs.

Une fois les corrections effectuées, vous pouvez utiliser ce fichier pour tenter d’importer de nouveau ces étudiants.

Exemples de requêtes d’extraction

Requête info étudiants

select Ind.cod_ind,
  decode(Etape.cod_cur,null,Etape.cod_cyc,Etape.cod_cur),
  Vet.Cod_sis_daa_min,
  rtrim(Dip.Lic_dip),
  Bac.Cod_bac,
  Bac.Daa_obt_bac_iba,
  Bac.Cod_Etb
FROM
INDIVIDU Ind,
INS_ADM_ANU Anu,
INS_ADM_ETP Etp,
ETAPE,
VDI_FRACTIONNER_VET Vet,
DIPLOME Dip,
VERSION_DIPLOME Vdi,
IND_BAC Bac,
ANNEE_UNI An
WHERE
Ind.COD_IND=Etp.COD_IND
AND Bac.COD_IND=Etp.COD_IND
AND Etp.COD_ETP=ETAPE.COD_ETP
AND Etp.COD_ETP=Vet.COD_ETP
AND Etp.COD_VRS_VET=Vet.COD_VRS_VET
AND Etp.COD_DIP=Vet.COD_DIP
AND Etp.COD_VRS_VDI=Vet.COD_VRS_VDI
AND Etp.COD_DIP=Dip.COD_DIP
and Etp.COD_DIP=Vdi.COD_DIP
AND Etp.COD_VRS_VDI=Vdi.COD_VRS_VDI
AND Etp.COD_ANU=Anu.COD_ANU
AND Etp.COD_IND=Anu.COD_IND
AND Etp.COD_ANU=An.cod_anu and An.eta_anu_iae='O'

Requêtes d’adresses annuelles

select  Adr_annu.cod_ind_ina,
rtrim(replace(Adr_annu.lib_ad1,';','-')),
rtrim(replace(Adr_annu.lib_ad2,';','-')),
rtrim(replace(Adr_annu.lib_ad3,';','-')),
rtrim(Adr_annu.COD_BDI),
rtrim(Com.LIB_COM),
Adr_annu.Cod_pay,
rtrim(Adr_annu.num_TEL)
from adresse Adr_annu,
INS_ADM_ANU Anu,
COMMUNE Com,
ANNEE_UNI An
where Com.COD_COM(+)=Adr_annu.COD_COM
and Anu.COD_IND=Adr_annu.COD_IND_INA
AND Anu.COD_ANU=Adr_annu.cod_anu_ina
and Adr_annu.cod_anu_ina=AN.cod_anu and AN.eta_anu_iae='O'

Requêtes adresse fixes

select  Adr_fixe.cod_ind,
rtrim(replace(Adr_fixe.lib_ad1,';','-')),
rtrim(replace(Adr_fixe.lib_ad2,';','-')),
rtrim(replace(Adr_fixe.lib_ad3,';','-')),
rtrim(Adr_fixe.COD_BDI),
rtrim(Com.LIB_COM),
Adr_fixe.Cod_pay,
rtrim(Adr_fixe.num_TEL)
from adresse Adr_fixe,
COMMUNE Com,
INS_ADM_ANU Anu,
ANNEE_UNI An
where Com.COD_COM(+)=Adr_fixe.COD_COM
and Anu.COD_IND=Adr_fixe.COD_IND
and Anu.COD_ANU=AN.cod_anu and AN.eta_anu_iae='O'