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
Colonne | Description | Remarques |
---|---|---|
COD_ANU * | Code Année | |
COD_NNE | Identifiant National Etudiant | |
COD_NNI | Numéro INSEE | |
COD_ETU | Code étudiant | |
NOM * | Nom patronymique | |
NOMUSAGE | Nom courant | |
PRENOM1 * | Prénom 1 | |
PRENOM2 | Prénom 2 | |
PRENOM3 | Pré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) | |
SITUAFAM | Code situation familiale (en rapport avec la nomenclature SITUATION FAMILIALE DE L ETUDIANT dans Calcium) | |
CODEBRS | Code bourse | |
CODEFINANC | Code aide financière | |
TEM_AFFL_SSO | Affiliation à la sécurité sociale (O ou N) | |
CENTREPAYEUR | Code centre payeur | |
CODEMUT | Code du droit mutuelle | |
ADR1 | Champ adresse 1 de l’adresse personnelle | <= 50 caractères |
ADR2 | Champ adresse 2 de l’adresse personnelle | <= 50 caractères |
ADR3 | Champ adresse 3 de l’adresse personnelle | <= 50 caractères |
COD_BDI | Code postal de l’adresse personnelle | |
COMMUNE | Commune de l’adresse personnelle | |
PAYS | Code pays de l’adresse personnelle (en rapport avec la nomenclature PAYS dans Calcium) | |
TELEPH | Numéro de téléphone de l’étudiant | |
Email de l’étudiant | ||
PCS | Code profession du parent principal (en rapport avec la nomenclature PROFESSION dans Calcium) | |
ADR1FIX | Champ adresse 1 de l’adresse familiale | <= 50 caractères |
ADR2FIX | Champ adresse 2 de l’adresse familiale | <= 50 caractères |
ADR3FIX | Champ adresse 3 de l’adresse familiale | <= 50 caractères |
BDIFIX | Code postal de l’adresse familiale | |
COMMUNEFIX | Commune de l’adresse familiale | |
PAYSFIX | Code pays de l’adresse familiale (en rapport avec la nomenclature PAYS dans Calcium) | |
TELEPHFIX | Numé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) | |
CURSUS | Cursus de l’étudiant | |
ANNEE | Année dans le cursus de l’étudiant | |
DIPLOME | Diplôme préparé | <= 45 caractères |
ETABLISSEMENT | Etablissement secondaire | |
BAC | Code bac (en rapport avec la nomenclature BACCAULAUREAT dans Calcium) | |
DATEBAC | Année du bac | |
ETB_BAC | Code établissement du bac | |
DAA_ETB | Année de l’entrée dans l’établissement | format YYYY |
DAA_ENS_SUP | Année de l’entrée dans l’Enseignement Supérieur en France | format YYYY |
IDENTIFIANT | Identifiant 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'