La funzione di acquisizione delle anagrafiche persona da file xlsx è accessibile cliccando su apposito bottone Importa da file da pagina Persone.
E' possibile importare le anagrafiche per studenti, docenti e tecnici-amministrativi (anche denominati PTA) oppure importare le sole associazioni elezioni ovvero l'elettorato statico attivo e passivo su anagrafiche già presenti a sistema.
Ogni tipologia di profilo elettore prevede delle specifiche proprietà tipiche del profilo (ad esempio per uno studente è presente il numero di anni fuori corso, per un docente il ruolo ordinario/associato/ricercatore, ecc.) quindi, per ogni tipologia di caricamento, è necessario importare un file che prevede un apposito formato (sono disponibili i template di esempio da scaricare).
Per tutte le tipologie di caricamento (studenti, docenti, tecnici-amministrativi e associazioni elezioni) sono previsti i dati identificativi della persona (identificativo della persona, dati anagrafici, indirizzi email, per le associazioni elezioni il solo codice fiscale sulla colonna fiscalCode) e due colonne, activeElections e passiveElections, che possono contenere i codici dei collegi per cui la persona risulta essere rispettivamente elettore attivo e elettore passivo (è necessario prevedere un apposito filtro nelle regole di elettorato); specificando in tali colonne le associazioni di elettorato ai collegi, essendo i codici legati alla configurazione dei collegi nell'evento elettorale, è necessario indicare in fase di caricamento del file l'evento elettorale per cui si intende eseguire il caricamento e la modalità, in sovrascrittura (le associazioni alle elezioni dell'evento vengono sovrascritte) oppure in integrazione (le associazioni alle elezioni dell'evento vengono aggiunte a quelle preesistenti); se all'interno dell'evento non è presente il codice collegio viene segnalato l'errore e l'anagrafica non viene importata.
Selezionati i parametri per il caricamento, è possibile importare il file tramite apposito bottone di import (esempio Importa file studenti).
Alla selezione del file parte l'importazione delle anagrafiche presenti nel file e l'avanzamento della elaborazione è evidenziato tramite uno spinner con percentuale.
Al termine viene visualizzato il risultato della importazione:
- N° righe elaborate (con n° inserimenti e n° aggiornamenti)
- N° righe non elaborate/in errore
- eventuale grid con anteprima (di massimo 100 elementi) delle righe in errore
Di seguito sono descritte le colonne previste per ogni formato di file relativo allo specifico tipo elettore.
Importazione studenti
Il file xlsx relativo agli studenti contiene le seguenti colonne:
personId (*): identificativo anagrafica (necessario per riconciliare anagrafiche di più tipologie)
fiscalCode (*): codice fiscale
lastName (*): cognome
firstName (*): nome
gender (*): sesso
birthDate (*): data di nascita
birthPlace: luogo di nascita
birthCountry: nazione di nascita
euCitizen: indicazione possesso cittadinanza in paese dell'unione europea (opzioni: YES , NO)
email: email
instEmail: email istituzionale di ateneo dello studente
user: utente
activeElections: elenco di codici collegi di elettorato attivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
passiveElections: elenco di codici collegi di elettorato passivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
institute: sigla/acronimo ente scolastico (esempio UNIBO)
enrollmentId (*): identificativo studente
enrollmentStatus: codice stato studente
enrollmentStatusReason: codice motivo stato studente
regNumber: matricola
regNumberStatus: codice stato matricola
regNumberStatusReason: codice motivo stato matricola
cohort: anno coorte
ayReg (*): anno di iscrizione
registrationStatus: codice stato iscrizione
registrationStatusReason: codice motivo stato iscrizione
courseYear: anno di corso
regKindCod: codice tipo iscrizione
regKindDes: decodifica tipo iscrizione
yearsOverCourseLen: numero anni fuori corso
regDate: data iscrizione
depCod: codice dipartimento/facoltà
depDes: descrizione dipartimento/facoltà
courseId (*): identificativo corso di studio
courseCod: codice corso di studio
courseDes: descrizione corso di studio
courseKindCod: codice tipo corso di studio
courseKindDes: descrizione tipo corso di studio
specKindCod: codice tipo specializzazione
specKindDes: descrizione tipo specializzazione
sysYear (*): anno di ordinamento
sysCod: codice ordinamento
sysDes: descrizione ordinamento
studyPlanId (*): identificativo percorso di studio
studyPlanCod: codice percorso di studio
studyPlanDes: descrizione percorso di studio
registrationId (*): identificativo iscrizione
location: sede
taxStatus: stato tasse
exemptionKindCod: codice esonero
exemptionKindDes: descrizione esonero
applicationForQualificationStatus: stato della domanda di conseguimento titolo
enrCourseNumber: numero carriere studente per corso di studio
waitGrad: indica se lo studente è iscritto in attesa di laurea (ammessi i valori YES e NO)
L'identificativo della anagrafica (personId) e i dati anagrafici relativi a codice fiscale, cognome, nome, sesso, data di nascita (fiscalCode, lastName, firstName, gender, birthDate) sono obbligatori. Sono altresì obbligatori gli identificativi della carriera e della iscrizione studente (enrollmentId, courseId, sysYear, studyPlanId, registrationId, ayReg). Tutte le colonne sono di tipo stringa (le date sono presenti sul file come stringhe nel formato dd/mm/yyyyy) ad eccezione di anno di iscrizione (ayReg), numero anni fuori corso (yearsOverCourseLen), anno di ordinamento (sysYear) e numero carriere studente per corso di studio (enrCourseNumber).
L'aggiornamento della anagrafica si basa sull'identificativo chiave personId; l'aggiornamento della specifica carriera/iscrizione studente si base sulle chiavi enrollmentId, courseId, sysYear, studyPlanId, registrationId.
Importazione docenti
Il file xlsx relativo ai docenti contiene le seguenti colonne:
personId (*): identificativo anagrafica (necessario per riconciliare anagrafiche di più tipologie)
teacherId (*): identificativo anagrafica docente
fiscalCode (*): codice fiscale
lastName (*): cognome
firstName (*): nome
gender: sesso (*)
birthDate (*): data di nascita
birthPlace: luogo di nascita
birthCountry: nazione di nascita
euCitizen: indicazione possesso cittadinanza in paese dell'unione europea (opzioni: YES , NO)
email: email
instEmail: email istituzionale di ateneo del docente
user: utente
activeElections: elenco di codici collegi di elettorato attivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
passiveElections: elenco di codici collegi di elettorato passivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
institute: sigla/acronimo ente scolastico (esempio UNIBO)
regNumber: matricola
areaCod: codice area CUN
areaDes: descrizione area CUN
sectorCod: codice settore
sectorDes: descrizione settore
roleCod: codice ruolo
roleDes: descrizione ruolo
teacherKind: tipo docente
teachingStart: data di inizio attività
teachingEnd: data di fine attività
roleStart: data di inizio ruolo
depCod: codice dipartimento
depDes: descrizione dipartimento
hyperlink: link pagina docente
L'identificativo della anagrafica docente (teacherId) e i dati anagrafici relativi a codice fiscale, cognome, nome, sesso, data di nascita (fiscalCode, lastName, firstName, gender, birthDate) sono obbligatori.
Se si intende riconciliare l'anagrafica del docente con l'anagrafica dello studente/tecnico-amministrativo è necessario passare obbligatoriamente anche l'identificativo anagrafica personId.
Tutte le colonne sono di tipo stringa (le date sono presenti sul file come stringhe nel formato dd/mm/yyyyy).
L'aggiornamento della anagrafica si basa sugli identificativi personId e teacherId.
Importazione tecnici-amministrativi (PTA)
Il file xlsx relativo ai PTA contiene le seguenti colonne:
personId (*): identificativo anagrafica (necessario per riconciliare anagrafiche di più tipologie)
admTecId (*): identificativo anagrafica PTA
fiscalCode (*): codice fiscale
lastName (*): cognome
firstName (*): nome
gender: sesso (*)
birthDate (*): data di nascita
birthPlace: luogo di nascita
birthCountry: nazione di nascita
euCitizen: indicazione possesso cittadinanza in paese dell'unione europea (opzioni: YES , NO)
email: email
instEmail: email istituzionale di ateneo del tecnico-amministrativo
user: utente
activeElections: elenco di codici collegi di elettorato attivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
passiveElections: elenco di codici collegi di elettorato passivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
institute: sigla/acronimo ente scolastico (esempio UNIBO)
regNumber: matricola
roleCod: codice ruolo
roleDes: descrizione ruolo
structureCod: codice struttura di afferenza (esempio ABIS)
structureDes: descrizione struttura di afferenza (esempio ABIS - Area Biblioteche e Servizi allo Studio)
careerStart: data di inizio attività
careerEnd: data di fine attività
hyperlink: link pagina tecnico-amministrativo
L'identificativo della anagrafica docente (admTecId) e i dati anagrafici relativi a codice fiscale, cognome, nome, sesso, data di nascita (fiscalCode, lastName, firstName, gender, birthDate) sono obbligatori.
Se si intende riconciliare l'anagrafica del PTA con l'anagrafica dello studente/docente è necessario passare obbligatoriamente anche l'identificativo anagrafica personId.
Tutte le colonne sono di tipo stringa (le date sono presenti sul file come stringhe nel formato dd/mm/yyyyy).
L'aggiornamento della anagrafica si basa sugli identificativi personId e admTecId.
Importazione associazioni elezioni
Il file xlsx relativo ai PTA contiene le seguenti colonne:
fiscalCode (*): codice fiscale
activeElections: elenco di codici collegi di elettorato attivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
passiveElections: elenco di codici collegi di elettorato passivo separati da virgola (esempio: SA-DIR1,SA-AREA2)
Eliminazione associazioni elezioni
All'interno della pagina di importazione è presente, inoltre, la funzione Elimina associazioni alle elezioni. In particolare, dopo aver selezionato l'evento elettorale, tramite apposito bottone è possibile eliminare le associazioni ai codici collegi (elezioni) di tutte le anagrafiche legate ad uno specifico evento elettorale.