Func: setInterscambio

Per mandare il file interscambio in modo automatico è necessario chiamare la funzione setInterscambio del webService passando i seguenti 5 parametri:

  • xml: la stringa XML equivalente al vecchio file di interscambio
  • idScuola: l’id della scuola. Puo esser richiesto a Formedil o al tecnico di e-land se non conosciuto, serve come ulteriore controllo rispetto a chi invia il file di interscambio
  • nomeFile: l’equivalente al vecchio nome del file XML. Visto che tutti i file di interscambio vengono salvati nel sistema, questo parametro serve per identificare il futuro nome con il quale si salverà il file stesso.
  • username: username per inviare richieste
  • password: la password per inviare richieste

    • Username e password sono personali di ogni scuola. Verranno fornite da e-land alle varie scuole che richiederanno l’utilizzo del WebService. Il sistema è stato protetto da username e password per evitare che agenti esterni possano caricare o richiedere i dati presenti.



    Rispetto al vecchio file di interscambio le modifiche sono le seguenti:
    Attribubuto version del tag <interscambio> deve essere impostato a 10 per poter caricare usando il webservice

    Tag <validato> puo aver due valori:

  • 0: il corso viene caricato come non validato
  • 1: il corso viene caricato come già validato.

    • Questa funzione è disponibile sono per le scuole che hanno fatto esplicita richiesta di caricare i corsi come già chiusi.
    Il dato non è obbligatorio ma, se non specificato, viene assunto come “0″, quindi il corso viene caricato come non validato (cioè come avviene attualmente nel file di interscambio).

    Tag <sedi_operative>:
    Ora ogni impresa può aver indicato da 0 ad N sedi operative differenti. Per questo motivo e’ stato creato il nodo padre di nome “sedi_operative” il quale puo aver presenti da 1 ad N nodi “sede_operativa“.
    Nel caso la sede operativa venga indicata, i campi indirizzo, comune e stato sono obbligatori.



    Un esempio del formato del parametro XML (quindi il nuovo file interscambio) può esser il seguente:

    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

    <?xml version="1.0" encoding="UTF-8"?>
<interscambio version="10">
    <corso>
        <validato>..</validato>
        <sys_scuola_id>..</sys_scuola_id>
        <scuola_id>..</scuola_id>
		<tipo_corso cpt="valore">..</tipo_corso>
		<attributi_corso>
			<tirocinio>..</tirocinio>
			<processo_valutativo>..</processo_valutativo>
			<progetto_formedil>..</progetto_formedil>
		</attributi_corso>
        <nome_corso>..</nome_corso>
        <durata>..</durata>
        <data_inizio>..</data_inizio>
        <data_fine>..</data_fine>
        <m_formative>..</m_formative>
        <sede>..</sede>
        <attestazione>..</attestazione>
        <finanziamento>
            <canale tipo="valore">..</canale>
            <tipologia_fondo_interprof>..</tipologia_fondo_interprof>
            <codice>..</codice>
        </finanziamento>
        <studenti>
            <studente>
            	<cf_provvisorio>..</cf_provvisorio>
               <cf>..</cf>
			   <cittadinanza>..</cittadinanza>
               <cognome>..</cognome>
               <nome>..</nome>
               <sesso>..</sesso>
               <nascita>
                	<stato>..</stato>
              	 	<comune>..</comune>
               		<data>..</data>
               </nascita>
               <residenza domicilio="valore">
                  <indirizzo>..</indirizzo>
                  <comune>..</comune>
                  <stato>..</stato>
                  <cap>..</cap>
               </residenza>
               <domicilio>
                   <indirizzo>..</indirizzo>
                   <comune>..</comune>
                   <stato>..</stato>
                   <cap>..</cap>
               </domicilio>
               <contatti>
                   <telefono>..</telefono>
                   <cellulare>..</cellulare>
                   <fax>..</fax>
                   <email>..</email>
               </contatti>
			   <status>..</status>
			   <qualifica>..</qualifica>
			   <impresa>
			   		<soggetto>..</soggetto>
					<cassa>..</cassa>
					<ccnl>..</ccnl>
					<tipologia_impresa>..</tipologia_impresa>
					<tip_pa>..</tip_pa>
					<denominazione>..</denominazione>
					<cf_impresa>..</cf_impresa>
					<piva>..</piva>
					<sede_legale>
						<indirizzo>..</indirizzo>
						<comune>..</comune>
						<stato>..</stato>
						<cap>..</cap>
						<telefono>..</telefono>
						<fax>..</fax>
						<email>..</email>
					</sede_legale>
					</sedi_operative>
						<sede_operativa>
							<indirizzo>..</indirizzo>
							<comune>..</comune>
							<stato>..</stato>
							<cap>..</cap>
							<telefono>..</telefono>
							<fax>..</fax>
							<email>..</email>
						</sede_operativa>
						<sede_operativa>
							<indirizzo>..</indirizzo>
							<comune>..</comune>
							<stato>..</stato>
							<cap>..</cap>
							<telefono>..</telefono>
							<fax>..</fax>
							<email>..</email>
						</sede_operativa>
					</sedi_operative>
					<referente>
						<nominativo>..</nominativo>
						<ruolo>..</ruolo>
					</referente>
					<registro_imprese>..</registro_imprese>
					<sito>..</sito>
			    </impresa>
			   <ud>
				<ud>..</ud>
			   </ud>
			   <uc>
				<uc>..</uc>
			   </uc>
			   <ad>
				<ad>..</ad>
			   </ad>
			   <frequenza>..</frequenza>
			   <proc_valutativo>..</proc_valutativo>
            </studente>
        </studenti>
	<ud>
		<ud>..</ud>
	</ud>
	<uc>
		<uc>..</uc>
	</uc>
	<ad>
		<ad>..</ad>
	</ad>
    </corso>
</interscambio>