Generazione Token da Sistema Esterno
Premessa
Il presente documento descrive il processo di import anagrafiche da sistema esterno per gestirne il caricamento dei dati anagrafici, dei titoli di studio e la chiamata al processo di generazione del Token di Mobilità in ingresso.
E' stata prevista la gestione di due differenti tipologie di interfaccia del processo:
- import tramite file XML
- import tramite chiamata ad un Web service.
Importazione Tramite file XML
Di seguito il flusso del processo gestito per effettuare l’import di file XML:
| Attività | Operatore |
|---|---|
| Estrazione dei dati da sistema esterno, con identificativi proprietari del sistema | SISTEMA ESTERNO |
| Transcodifica dati strutturati da identificativi proprietari a identificativi generici (MIUR, ISTAT, etc)per le specifiche di transcodifica vedere capitolo Specifiche tracciato XML | SISTEMA ESTERNO |
| Generazione di un file XML per ogni studente (vedere specifiche del tracciato)per le specifiche di transcodifica vedere capitolo Specifiche tracciato XML | SISTEMA ESTERNO |
| Spostamento file in una cartella accessibile ad Esse3 (possibilmente FTP) | SISTEMA ESTERNO |
| Schedulazione del processo che prende in carico i file presenti nella cartella condivisa (ELABORAZIONE BATCH, processo "GEN_TOKEN_XML") | ESSE3 |
| Elaborazione di ogni tracciato, con indicazione di corretta / errata elaborazione | ESSE3 |
Web Service
Di seguito il flusso gestito dal processo di import di tracciati XML tramite chiamata Web Service:
| Estrazione dei dati da sistema esterno, con identificativi proprietari del sistema | SISTEMA ESTERNO |
| Transcodifica dati strutturati da identificati proprietari a identificativi generici (MIUR, ISTAT, etc)per le specifiche di transcodifica vedere capitolo Specifiche tracciato XML | SISTEMA ESTERNO |
| Chiamata al WS esposto da Esse3 inserendo come parametro di chiamata il tracciato XML (vedere specifiche del tracciato), richiamando per ogni studente il servizio.per le specifiche di transcodifica vedere capitolo Specifiche tracciato XML | SISTEMA ESTERNO |
| Il Servizio esposto salverà la copia del tracciato inviato | ESSE3 |
| Elaborazione del tracciato, con indicazione di corretta / errata elaborazione | ESSE3 |
Specifiche del tracciato
Per le specifiche relative ai blocchi comuni con l'import Immatricolati da sistema esterno, consultare la documentazione pubblicata al seguente link:
http://docs.kion.it/bin/view/KionDocs/ImmatricolazioneDaSistemaEsterno
DATA SET | ATTRIBUTO | TIPO | OBBLIGATORIO | VALORI AMMESSI | COMMENTO | NOTE TECNICHE |
ANAPER
Contiene i dati anagrafici dello studente. |
|
| SI |
|
|
|
Per dettaglio vedi analisi Specifiche_tracciato_XML_import_preimmatricolati_standard.doc | ||||||
ANAPER_DATI_BANCA
Contiene i dati bancari relativi all’anagrafica dello studente. |
|
| NO |
|
|
|
Per dettaglio vedi analisi Specifiche_tracciato_XML_import_preimmatricolati_standard.doc | ||||||
MATUR
Contiene i dati relativi al titolo di scuola superiore dello studente. |
|
| NO |
|
|
|
Per dettaglio vedi analisi Specifiche_tracciato_XML_import_preimmatricolati_standard.doc | ||||||
TIT_IT_TITITA
Contiene i dati relativi al titolo/i universitario/i italiano/i dello studente. |
|
| NO |
|
|
|
Per dettaglio vedi analisi Specifiche_tracciato_XML_import_preimmatricolati_standard.doc | ||||||
TIT_STRA
Contiene i dati relativi al titolo/i universitario/i straniero/i dello studente. |
|
| NO |
|
|
|
Per dettaglio vedi analisi Specifiche_tracciato_XML_import_preimmatricolati_standard.doc | ||||||
DATI_GENERA_TOKEN
Contiene i dati relativi al bando di mobilità di iscrizione dello studente. |
|
| NO |
|
|
|
| <aa_iscr_id/> | NUMBER (10) | SI | L’anno passato deve essere presente nella tabella P06_AA. | Anno Accademico di elaborazione. |
|
| <aa_ord_id/> | NUMBER (10) | NO |
| Ordinamento di iscrizione dello studente. | Sempre a NULL. Associo automaticamente quello attivo collegato al corso di studio. |
| <cds_cod/> | STRING (10) | SI | Il codice passato deve essere presente nella tabella P06_CDS. | Corso di iscrizione dello studente. Codice interno del corso di studi. |
|
| <pds_cod/> | STRING (10) | NO | Il codice passato deve essere presente nella tabella P06_PDSORD. | Percorso di iscrizione dello studente. Codice interno del percorso di studi. | Sempre a NULL. Iscrivere lo studente al percorso COMUNE (9999).
|
| <aa_bando_id/> | NUMBER(4) | NO |
|
| Anno accademico del bando per studenti ERASMUS e DOUBLE DEGREE. |
| <n_bando/> | NUMBER | NO |
|
| Numero bando per studenti ERASMUS e DOUBLE DEGREE. |
| <erasmus_cod/> | STRING | NO |
|
| Ateneo straniero di provenienza per studenti ERASMUS e DOUBLE DEGREE. |
Codifica dati
Per le codifiche dei blocchi:
· ANAPER
· ANAPER_DATI_BANCA
· MATUR
· TIT_IT_TITITA
· TIT_STRA
consultare la documentazione pubblicata al seguente link:
http://docs.kion.it/bin/view/KionDocs/ImmatricolazioneDaSistemaEsterno
1. Codifica Atenei Stranieri:
Il dato sarà decodificato per indicare:
DESCRIZIONE | IDENTIFICATIVO DA CODIFICARE | CAMPO TRACCIATO XML |
Ateneo straniero di provenienza studenti incoming. | P01_STU.ATENEO_STRANIERO_ID | <erasmus_cod/> |
La codifica degli Atenei Stranieri sarà gestita tramite la codifica ERASMUS_COD (es. D FREIBUR02 – PÄDAGOGISCHE HOCHSCHULE FREIBURG IM BREISGAU).
Configurazione Web Service
Il servizio è raggiungibile ai seguenti URL:
- https://XXX/services/AnagCarXmlService (via https)
- http://XXX/services/AnagCarXmlServiceXXX è da intendersi l'URL base della home del portale di ateneo es. https://XXX/Home.do.
I parametri di configurazione ANAGCARXML_WS_USERNAME e ANAGCARXML_PASSWORD contengono rispettivamente utente e password di autenticazione del servizio.
WSDL: http://XXX/services/AnagCarXmlService/AnagCarXmlService?wsdl
Il ritorno del servizio conterrà: ret (risultato 1- positivo -1- negativo), identificativo testata elenco generato,visualizzabile dalla funzione client 'Risultato elaborazione import XML'.
<AnagCarXmlService>
<ret>1</ret> <id_tst_elenco>12345</id_tst_elenco> </AnagCarXmlService>Parametri di contesto
I parametri che regolano il processo di Generazione Token da sistema esterno sono legati al contesto 'GEN_TOKEN_XML'.
Parametri di configurazione import dati XML
I parametri di configurazione che gestiscono la configurazione dei dati importati sono:
NOME | NOTA |
IMP_ANA_EXIST | Indica che l’import delle anagrafiche è abilitato anche per anagrafiche già presenti a sistema. 0- l’import di una anagrafica con codice fiscale già presente a sistema NON è abilitato. 1- l’import di una anagrafica con codice fiscale già presente a sistema è abilitato. Default 1. |
UPD_ANA | Indica che l’import delle anagrafiche aggiorna i dati presenti a sistema.
Default 1. |
CHK_CF | Indica se nell’import delle anagrafiche deve essere effettuata la verifica del codice fiscale presente nel file importato. 0- l’import NON effettua il controllo 1- l’import effettua il controllo. Default 1. |
CALC_CF_STRA | Indica se nell’import delle anagrafiche deve essere effettuato il ricalcolo del codice fiscale per studenti con nazione di nascita differente da Italia, e con codice non coerente rispetto ai dati inseriti. 0- il ricalcolo del codice fiscale non viene effettuato 1- il ricalcolo del codice fiscale viene effettuato. |
UPD_MATUR | Indica che l’import dei titoli di scuola superiore aggiorna i dati presenti a sistema.
Default 1. |
UPD_TIT_IT | Indica che l’import dei titoli universitari italiani aggiorna i dati presenti a sistema.
Default 1. |
UPD_TIT_STRA | Indica che l’import dei titoli universitari straniero aggiorna i dati presenti a sistema.
Default 1. |
AGG_MOBIL | Indica che l’import dei dati di generazione TOKEN aggiorna gli atenei stranieri di provenienza dell’organizzazione della mobilità e del bando associato.
Default 0. |
Parametri import via Web Service
NOME | NOTA |
ANAGCARXML_WS_USERNAME | Indica la password di accesso al Web Service AnagCarXmlService (Import dati Anagrafica e Carriera Area Amministrativa). |
ANAGCARXML_WS_PASSWORD | Indica l'utenza di accesso al Web Service AnagCarXmlService (Import dati Anagrafica e Carriera Area Amministrativa). |