Guia MAT d’FPeducacio.gencat.cat/.../ManualsAplicacions/Guia_MAT_FP.pdf · SISTEMA D’INTERCANVI...

Guia MAT d’FP Recollida de dades. Descripció del fitxer de dades de matrícula i avaluació d’FP. Curs 2018-2019

30/08/2018

SISTEMA D’INTERCANVI D’INFORMACIÓ (SII)

GUIA-MAT-FP CURS 2018-2019

Agost 2018 Pàg. 2 / 30

Guia-MAT-FP 1819

Í N D E X

1. INTRODUCCIÓ ............................................................................................................................... 3

1.1 Objecte del document 3

2. SERVEI WEB VALIDACIÓ FITXER D’ALUMNAT DE FORMACIÓ PROFESSIONAL .................. 4

2.1 Descripció del servei 4

2.2 Petició 4

2.3 Resposta 4

2.4 Exemples 4

2.5 Accés al WSDL 5

2.6 Com provar el servei Web 5

3. FORMAT DEL FITXER D’ALUMNAT DE FORMACIÓ PROFESSIONAL ...................................... 9

3.1 Format arxiu XML 9

3.2 Descripció dels camps 12

3.3 Canvis respecte al curs anterior 25

4. ANNEXOS ..................................................................................................................................... 26

4.1 Guió d’ús 26

4.2 Exemple de matrícula de formació professional 28



Agost 2018 Pàg. 3 / 30

Guia-MAT-FP 1819

1. INTRODUCCIÓ

1.1 Objecte del document Aquest document detalla el funcionament del servei del Sistema d'Intercanvi d'Informació (SII) encarregat de validar fitxers XML amb informació de matriculacions i avaluacions per als alumnes de formació professional.

Els principals objectius d’aquest manual són:

• Utilització i consum del servei Web del SII de validació del fitxer de formació professional.. • Descripció de l'estructura i contingut que ha de tenir el fitxer de formació professional.



Agost 2018 Pàg. 4 / 30

Guia-MAT-FP 1819

2. SERVEI WEB VALIDACIÓ FITXER D’ALUMNAT DE FORMACIÓ PROFESSIONAL

Aquest servei Web valida un fitxer XML amb informació d’alumnat de formació professional. Aquesta validació consisteix a comprovar que una instància d’un document XML s’ajusta a un document esquema de XML (XSD), és a dir, que té el format esperat. L’objectiu de l’operació és validar el seu contingut (sense processar-lo) i per tant pot ser utilitzada per verificar que la construcció del fitxer amb matrícules i avaluacions de formació profession al s’ha fet correctament .

2.1 Descripció del servei En realitzar la crida al servei Web de validació, s'haurà d'informar de manera obligatòria com a paràmetre el fitxer amb el contingut XML a validar. Si el fitxer té el format esperat (segons l’XSD corresponent) es retorna un missatge de confirmació. En cas contrari retornarà un llistat amb els errors detectats durant la validació.

2.2 Petició La petició consisteix en un fitxer codificat en base64.

2.3 Resposta Si el format del document XML és correcte segons el corresponent XSD llavors el servei Web retorna un missatge indicant l’èxit de l’operació de validació de les dades. En cas contrari retornarà un llistat amb els errors de validació detectats.

Missatge Resposta Descripció Resposta

XML validation success Indica que el document XML s’ha validat correctament (s'ajusta al seu XSD)

XML validation error: <missatge error>

Indica que durant el procés de validació del document XML s'ha detectat l'error <missatge error>

Parse error: <missatge error> Indica que durant el parseig inicial del document XML s'ha detectat l'error <missatge error>

Web Service unexpected error: <missatge error>

Indica que durant l'execució del servei Web s'ha produït de manera inesperada l'error <missatge error>.

2.4 Exemples Petició SOAP:

<soapenv:Envelope xmlns:soapenv=http://schemas.xmlsoap.org/soap/envelope/ xmlns:cat="http://cat.gencat.ensenyament.sii.ws.validacio/"> <soapenv:Header/> <soapenv:Body> <cat:validarFP> <arg0> PD94bWwgdmVyc2l ...</arg0> </cat:validarFP> </soapenv:Body> </soapenv:Envelope>

Resposta SOAP (validació sense errors):

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns0:validarFPResponse xmlns:ns0="http://cat.gencat.ensenyament.sii.ws.validacio/"> <return>XML validation success </return> </ns0:validarFPResponse> </S:Body> </S:Envelope>



Agost 2018 Pàg. 5 / 30

Guia-MAT-FP 1819

Resposta SOAP (validació amb errors):

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns0:validarFPResponse xmlns:ns0="http://cat.gencat.ensenyament.sii.ws.validacio/"> <return>XML validation error: Element has xsi:nil attribute but is not nillable in element DadesAlumne@ http://ens.gencat.cat/sii/guiamat/fp/ </return> <return>XML validation error: string value 'M' is not a val id enumeration value for sexeType in namespace http://ens.gencat.c at/sii/guiamat/fp/ </return> </ns0:validarFPResponse> </S:Body> </S:Envelope>

2.5 Accés al WSDL Per obtenir el WSDL del servei Web cal accedir a la següent adreça:

https://aplicacions.ensenyament.gencat.cat/e13_sii_WS/ValidacionsFitxerWS?wsdl

2.6 Com provar el servei Web Per poder provar el servei Web farem servir l’aplicació SOAPUI, que la podem descarregar des de la direcció http://www.soapui.org/. SOAPUI és una aplicació gratuïta de codi obert per al testeig de serveis Webs. Un cop descarregada i instal·lada l’aplicació, creem un nou projecte a File>New soapUI Project:

En aquest formulari omplirem las següents dades:

• Project Name . El nom que li volem donar al nostre projecte. Per exemple: TestWSFP. • Initial WSDL/WADL . Direcció des d’on soapUI pot obtenir el WSDL del servei Web. En el

nostre cas indiquem: https://aplicacions.ensenyament.gencat.cat/e13_sii_WS/ValidacionsFitxerWS?wsdl



Agost 2018 Pàg. 6 / 30

Guia-MAT-FP 1819

Si acceptem, soapUI generarà una plantilla a partir del WSDL amb els serveis Webs disponibles. En el nostre cas particular, el servei que ens interessa és validarFP :

Automàticament soapUI ja ens ha generat una petició d’exemple (Request1) per al mètode validarFP:

El servei Web validarFP té un únic paràmetre: el fitxer XML de l’alumnat de formació professional codificat en base64Binary . Per codificar el nostre fitxer XML de prova a base64Binary farem servir la pàgina http://www.base64encode.org/ i seguirem les instruccions indicades a la següent imatge:



Agost 2018 Pàg. 7 / 30

Guia-MAT-FP 1819

Copiem el fitxer XML codificat en Base64 i l’afegim com a paràmetre a la nostra petició del soapUI:

Finalment llançarem la nostra petició (botó verd amb forma de fletxa a la part superior de la finestra de la nostra petició Request 1) i visualitzarem la resposta del servei Web:



Agost 2018 Pàg. 8 / 30

Guia-MAT-FP 1819



Agost 2018 Pàg. 9 / 30

Guia-MAT-FP 1819

3. FORMAT DEL FITXER D’ALUMNAT DE FORMACIÓ PROFESSIONAL

Per a la correcta validació del format del fitxer de matrícules i avaluacions de formació professional cal que el fitxer tingui una estructura i continguts determinats que a continuació es detallen. Es faran dos enviaments de fitxer per any acadèmic, un a l’inici amb la informació de la matrícula i un al final amb la informació de la matrícula final i l’avaluació. En tots dos enviaments ha de constar tot l’alumnat que està o ha estat matriculat al centre en l’any acadèmic. En cada enviament s’enviarà un únic arxiu, en format XML, anomenat amb els darrers 7 dígits del codi de centre, és a dir, XXXXXXX.XML. L’arxiu es composa de tres grans blocs:

• Alumne • Matrícules • Avaluacions.

Al bloc de l’alumne hi ha la informació general de l’alumne. Al bloc matrícules hi ha la informació de les matrícules de l’alumne al centre (una per cada cicle diferent). Aquesta informació s’ha de detallar fins al nivell d’unitat formativa/crèdit. En cas que l’alumne realitzi un programa s’haurà d’indicar també la informació d’aquest. Al bloc avaluacions hi ha la informació de les avaluacions realitzades a l’alumne (una per cada cicle diferent). Aquesta informació s’haurà de detallar a nivell d’unitat formativa/crèdit. En cas de finalització d’un mòdul o de finalització del cicle s’haurà de facilitar, a més, la informació corresponent. En cas que l’alumne hagi realitzat una estada de mobilitat internacional o pràctiques en empresa s’haurà d’indicar també aquesta informació. Si el marc normatiu de l’ensenyament és LOE treballarem amb <UnitatsFormatives> . Si és LOGSE treballarem amb <Credits> . Per a aquest últim cas, si el crèdit no pertany a un mòdul llavors no cal informar els camps <CodiModul> , <ModulPropi> , <NombreHoresModul> i <ModulFinalitzat> .

3.1 Format arxiu XML La representació de l'esquema XML és la següent (en verd es destaquen els canvis respecte al curs 2017-2018): <Centre>

<CodiCentre/>

<AnyAcademic/>

<Alumnes>

<Alumne>

<DadesAlumne>

<IDALU/>

<TipusDocumentIdentitat/>

<NumeroDocumentIdentitat/>

<NomAlumne/>

<PrimerCognomAlumne/>

<SegonCognomAlumne/>

<Sexe/>

<DataNaixement/>

<CodiMunicipiNaixement/>

<NomMunicipiNaixementFora/>

<CodiPaisNaixement/>

<CodiNacionalitat/>



Agost 2018 Pàg. 10 / 30

Guia-MAT-FP 1819

<AdrecaAlumne>

<TipusVia/>

<NomVia/>

<Numero/>

<Bloc/>

<Escala/>

<Planta/>

<Porta/>

<CodiMunicipi/>

<CodiPostal/>

<CodiPais/>

</AdrecaAlumne>

<Telefon/>

<NEE/>

</DadesAlumne>

<Matricules>

<Matricula>

<MarcNormatiu/>

<CodiEnsenyament/>

<DataMatricula/>

<CursAcademicIniciCicle/>

<Nivell/>

<ModalitatCursa/>

<EscolaritzacioCompartida/>

<CodiCentreCompartit/>

<CodiCentreCustodiaExpedient/>

<AlumneConveni/>

<NIFEntitatConveni/>

<Torn/>

<RequisitsAcademicsAcces/>

<UltimEstudiMatriculat/>

<CursUltimEstudiMatriculat/>

<CodiPaisUltimEstudiMatriculat/>

<Programa>

<TipusPrograma/>

<NombreHoresProgramaEmpresa/>

</Programa>

<GrupEnsenyamentAlumne/>

<DataBaixa/>

<Moduls>

<Modul>

<CodiModul/>

<ModulPropi/>

<NombreHoresModul/>

(*)

</Modul>

</Moduls>

</Matricula>

</Matricules>

<Avaluacions>

<Avaluació>

<MarcNormatiu/>

<CodiEnsenyament/>

<CicleFinalitzat>

<QualificacioCicle/>

<QualificacioCiclePAAU/>

<EstadesMobilitat>

<EstadaMobilitat>

<TipusEstadaMobilitat/>

<DuradaEstadaMobilitat/>



Agost 2018 Pàg. 11 / 30

Guia-MAT-FP 1819

<PaisDestinacio/>

<FormacioPractica/>

</EstadaMobilitat>

</EstadesMobilitat>

</CicleFinalitzat>

<Moduls>

<Modul>

<CodiModul/>

<ModulFinalitzat>

<QualificacioModul/>

</ModulFinalitzat>

(**)

</Modul>

</Moduls>

</Avaluacio>

</Avaluacions>

</Alumne>

</Alumnes>

</Centre> (*) Si treballem amb estudis LOE llavors:

<UnitatsFormatives>

<UnitatFormativa>

<CodiUnitatFormativa/>

<UnitatFormativaPropia/>

<NombreHoresUnitatFormativa/>

<IdiomaEstrangerVehicular/>

</UnitatFormativa>

</UnitatsFormatives> Si treballem amb estudis LOGSE llavors:

<Credits>

<Credit>

<CodiCredit/>

<CreditPropi/>

<NombreHoresCredit/>

<IdiomaEstrangerVehicular/>

</Credit>

</Credits> (**) Si treballem amb estudis LOE llavors:

<UnitatsFormatives>

<UnitatFormativa>

<CodiUnitatFormativa/>

<Convocatoria/>

<QualificacioUnitatFormativa/>

<PractiquesEmpresa>

<PracticaEmpresa>

<NombreHoresPracticaEmpresa/>

</PracticaEmpresa>

</PractiquesEmpresa>

</UnitatFormativa>

</UnitatsFormatives>



Agost 2018 Pàg. 12 / 30

Guia-MAT-FP 1819

Si treballem amb estudis LOGSE llavors:

<Credits>

<Credit>

<CodiCredit/>

<Convocatoria/>

<QualificacioCredit/>

<PractiquesEmpresa>

<PracticaEmpresa>

<NombreHoresPracticaEmpresa/>

</PracticaEmpresa>

</PractiquesEmpresa>

</Credit>

</Credits>

3.2 Descripció dels camps La longitud indicada a la columna Tipus de dades són longituds màximes. Tots els camps són obligatoris excepte aquells en què de manera explícita s’indiqui el contrari. En verd es destaquen els canvis respecte al curs 2017-2018.

Nom del TAG Tipus Descripció

CodiCentre 9(8) Codi del centre on s’ha matriculat/avaluat l’alumne/a.

AnyAcademic 9(4) Any acadèmic, així, el curs 2018/2019 s’indicarà 1819.

Bloc Alumne

IDALU 9 (xx) Número d’identificació de l’alumne.

Validació:

Obligatori, excepte en el cas en què l’alumne/a cursi els estudis en modalitat no presencial i a més no disposi d’IDALU. En la resta de casos, no s’ha d’informar la resta de camps identificadors de l’alumne, excepte els relatius al document d’identitat (si els altres quedessin informats, la informació que prevaldrà serà la de l’IDALU).

En el cas de la modalitat no presencial en què no es disposi d’IDALU, cal emplenar tots els camps identificadors del ‘Bloc Alumne’.

TipusDocumentIdentitat

X(1) Tipus de document d’identitat de l’alumne/a (DNI, NIE, PASSAPORT).

Validació:

Camp obligatori. El tipus només pot ser DNI si la nacionalitat és espanyola (<CodiNacionalitat>). En cas contrari ha de ser NIE o passaport.

Els valors permesos són:

Tipus Codi DNI A NIE B Passaport C



Agost 2018 Pàg. 13 / 30

Guia-MAT-FP 1819

NumeroDocumentIdentitat X(15) Número del document de l’alumne/a. S’hi ha d’indicar tant els números com la lletra, si en té.

Validació:

Camp obligatori.

Si el tipus de document és DNI es valida que sigui un DNI vàlid.

Si el tipus de document és NIE es valida que sigui un NIE vàlid.

Els DNI i NIE han de portar la lletra majúscula de manera obligatòria sense espais en blanc ni cap signe de puntuació.

NomAlumne X(50) Nom de l’alumne/a. Si el primer cognom conté partícules, es posaran a continuació del nom.

Validació:

Obligatori si no s’ha informat l’IDALU.

Longitud mínima de dos caràcters.

Els caràcters considerats vàlids són: AÁÀÄÂÃBCÇDEÉÈËÊFGHIÍÌÎÏJKLMNÑOÓÒÔÕÖPQRSTUÜÚÙÛVWXYZ(les lletres també poden ser minúscules); espai; - guió; ª de Mª; .punt; · punt volat de l·l.

PrimerCognomAlumne X(50) Primer cognom de l’alumne/a. Si el cognom conté partícules que el separen del nom, es posaran al darrere del nom.

Validació:


Longitud mínima de dos caràcters.


SegonCognomAlumne X(50) Segon cognom de l’alumne/a, si en té.

Així l’alumna Anna de la Font-Puig Nielsen tindrà:

• Nom = Anna de la • Primer cognom = Font-Puig • Segon cognom = Nielsen

Validació:

Camp no obligatori.


Sexe X(1) Sexe de l’alumne/a.

Validació:





Agost 2018 Pàg. 14 / 30

Guia-MAT-FP 1819

Sexe Codi Home H Dona D

DataNaixement

X(8) Data de naixement de l’alumne.

Validació:


Ha d’estar en format DDMMAAAA. Per exemple, el 6 de maig de 1973: 06051973.

La data ha d’estar en concordança amb les edats mínimes per matricular-se en cada ensenyament. Per als ensenyaments de grau mitjà l’edat mínima són 14 anys, i per als ensenyaments de grau superior l’edat mínima son 16 anys. L’edat de l’alumne està referida a 31 de desembre de l’any en què comença el curs acadèmic.

CodiMunicipiNaixement 9(5) Codi INE del municipi de naixement de l’alumne/a.

Validació:


S’ha de codificar segons la taula territorial de municipis, on trobareu els codis dels municipis de tot l’Estat espanyol.

En el cas dels alumnes nascuts fora de l’Estat espanyol aquest camp s’omplirà amb ‘99999’ i cal indicar el nom del municipi en el tag <NomMunicipiNaixementFora>.

NomMunicipiNaixementFora X(30) Nom del municipi de naixement de l’alumne/a si és estranger/a. Per a la resta no cal informar-lo.

Validació:

Obligatori si l’alumne és estranger i no s’ha informat l’IDALU.

CodiPaisNaixement 9(3) País de naixement de l’alumne.

Validació:


S’ha de codificar segons la taula territorial de països. En el cas dels alumnes nascuts a l’Estat espanyol el codi INE és el 108.

CodiNacionalitat 9(3) Nacionalitat de l’alumne/a.

Validació:


S’ha de codificar segons la taula territorial de països. En el cas dels alumnes amb nacionalitat espanyola el codi és el 108.

TipusVia X(2) Adreça postal de residència de l’alumne: tipus de via

Validació:


S’ha de codificar segons la taula territorial de tipus de via.



Agost 2018 Pàg. 15 / 30

Guia-MAT-FP 1819

NomVia X(25) Adreça postal de residència de l’alumne: nom de la via.

Validació:


Els codis considerats vàlids són: AÁÀÄBCÇDEËÉÈFGHIÌÍÏJKLMNÑOÒÓÖPQRSTUÚÙÜVWXYZ0123456789 (les lletres també poden ser minúscules); espai; - guió; . punt; º de nº; ª de Mª; · punt volat de l·l; ' apòstrof; ( ; ) ; /

Numero X (5) Adreça postal de residència de l’alumne: número de la via.

Validació:


Bloc X (3) Adreça postal de residència de l’alumne: bloc.

Escala X (2) Adreça postal de residència de l’alumne: escala.

Planta X (2) Adreça postal de residència de l’alumne: planta.

Porta X (2) Adreça postal de residència de l’alumne: porta.

CodiMunicipi 9(5) Codi INE del municipi de residència de l’alumne/a.

Validació:


S’ha de codificar segons la taula territorial de municipis, on trobareu, a més dels codis dels municipis de Catalunya, un enllaç a la web de l’IDESCAT per a consultar els codis dels municipis de fora de Catalunya.

En el cas dels alumnes que resideixen fora de l’Estat espanyol aquest camp s’omplirà amb ‘99999’.

CodiPostal 9(5) Codi postal corresponent a l’adreça actual de l’alumne/a.

Validació:


En el cas dels alumnes que resideixen fora de l’Estat espanyol aquest camp no és obligatori.

CodiPais 9(3) País de residència de l’alumne.

Validació:


S’ha de codificar segons la taula territorial de països. En el cas dels alumnes residents a l’Estat espanyol el codi és el 108.

Telefon 9(13) Telèfon de l’alumne/a o la família de l’alumne/a.

Validació:

Camp no obligatori.

NEE

X(3) Obligatori si no s’ha informat l’IDALU.

Causa principal de les possibles necessitats educatives



Agost 2018 Pàg. 16 / 30

Guia-MAT-FP 1819

específiques de l’alumne/a.

En el cas d’alumnes amb més d’una causa que requereixi NEE, s’indicarà la dominant.

Validació: Els valors permesos són:

Discapacitat intel·lectual lleugera

A10

Discapacitat intel·lectual moderada

A20

Discapacitat intel·lectual severa A30

Discapacitat intel·lectual profunda

A40

Pluridiscapacitat Z10

Discapacitat auditiva lleugera B10

Discapacitat auditiva moderada B20

Discapacitat auditiva severa B30

Discapacitat auditiva profunda B40

Discapacitat visual C10

Discapacitat motriu autònom D10

Discapacitat motriu semi-autònom D20

Discapacitat motriu depenent D30

Trastorns de l’espectre autista E10

Trastorns greus de conducta F10

Retard del desenvolupament sense etiologia clara

G10

Incorporació tardana en el sistema educatiu

H10

Situacions socioeconòmiques desfavorides

I10

Alumnat amb altes capacitats J10

Alumnat amb trastorns de l'aprenentatge

K10

Si l’alumne no té cap necessitat educativa específica, aquest camp es deixarà en blanc.

Bloc de dades acadèmiques . Currículum (tots els camps són obligatoris si no s’indica el contrari)

MarcNormatiu X(2) Indica el marc normatiu de la matrícula

Validació:


Marc normatiu Cod i LOE L LOGSE LG

CodiEnsenyament X(12) Camp obligatori



Agost 2018 Pàg. 17 / 30

Guia-MAT-FP 1819

Codi d'ensenyament segons catàleg

DataMatricula X(8) Data en què l’alumne/a es matricula per al curs.


Validació:

Ha d’estar en format DDMMAAAA.

CursAcademicIniciCicle 9(4) Curs acadèmic d’inici del cicle. Així, el curs 2016-2017 s’indicarà 1617.

Nivell X(1) Nivell assignat a l’alumne/a.


Validació:


Nivell Codi 1r 1 2n 2 Només FCT P

ModalitatCursa X(1) Modalitat en la qual es cursa.


Validació:


Modalitat Codi Presencial P Semipresencial S No presencial N

EscolaritzacioCompartida X(1) Indicar si l’alumne fa escolarització compartida.


Validació:


Compartida Codi Si S No N

CodiCentreCompartit 9(8) En el cas d’escolarització compartida s’ha d’indicar el codi del centre amb el qual es comparteix l’escolarització de l’alumne/a.


Validació:

Aquest camp és obligatori si al tag <EscolaritzacioCompartida> s’ha informat el valor ‘S’.

CodiCentreCustodiaExpedient

9(8) En el cas d’escolarització compartida s’ha d’indicar el codi del centre que custodia l’expedient de l’alumne/a.


Validació:

Aquest camp és obligatori si al tag <EscolaritzacioCompartida> s’ha informat el valor ‘S’.



Agost 2018 Pàg. 18 / 30

Guia-MAT-FP 1819

AlumneConveni

X(1) Indicar si és el cas d’un alumne de conveni amb una entitat que imparteix ensenyament a distància.

Actualment això només és aplicable a l’Institut Obert de Catalunya (IOC).

Validació:


Conveni Codi Si S No N

NIFEntitatConveni X(9) En el cas d’un alumne de conveni s’ha d’indicar el NIF de l’entitat amb que es realitza aquest.

Validació:

Aquest camp és obligatori si s’ha informat el tag <AlumneConveni>

Torn X(2) Horari.

Validació:



Torn Codi MT Matí i tarda

MM Matí

TT Tarda

VV Vespre

NA No aplica el torn

Aquest camp no és obligatori si el tag <ModalitatCursa> té el valor “No presencial”

RequisitsAcademicsAcces X(1) Titulació que han presentat els alumnes per accedir al cicle formatiu que es matriculen.

Validació:


Cicles formatius de grau mitjà (CFGM ) Procedència Codi ESO o estudis equivalents S (estrangers o plans d’estudis anteriors) Batxillerat K CFGM-CFAM H CFGS-CFAS Q Diplomatura 2 Llicenciatura 3 Grau 5 Prova d’accés 1 Curs específic d’accés 4



Agost 2018 Pàg. 19 / 30

Guia-MAT-FP 1819

Altres E Cicles formatius de grau superior (CFGS ) Procedència Codi Batxillerat K CFGM-CFAM H CFGS-CFAS Q Diplomatura 2 Llicenciatura 3 Grau 5 Prova d’accés 1 Curs específic d’accés 4 Altres E

UltimEstudiMatriculat 9(1) L’últim estudi en el qual ha estat matriculat l’alumne/a, previ a la primera matrícula en aquest cicle.

Validació:


Últim estudi Codi CFGM o equivalent 1 CFGS o equivalent 2 Batxillerat o equivalent 3 Universitat o equivalent 4 ESO o equivalent 5 PQPI o equivalent 6 Desconegut 9

CursUltimEstudiMatriculat 9(4) Curs en què es va cursar l’últim estudi previ matriculat, així, el curs 2009-2010 s’indicarà 0910.

Validació:

Aquest camp no s’ha d’informar si al tag <UltimEstudiMatriculat> s’ha informat el valor ‘Desconegut (9)’.

CodiPaisUltimEstudiMatriculat 9(3) Codi del país de l’últim estudi en el qual ha estat matriculat.

Validació:

S’ha de codificar segons la taula territorial de països. En el cas que el país de l’últim estudi sigui l’Estat espanyol el codi és el 108.

Aquest camp no s’ha d’informar si al tag <UltimEstudiMatriculat> s’ha informat el valor ‘Desconegut (9)’.

TipusPrograma

X(1) Si es fa un programa s’haurà d’indicar el tipus.

Validació:

Aquest camp és obligatori si s’ha informat el tag <NombreHoresProgramaEmpresa>


Programa Codi Alternança dual D Alternança simple A Formació professional en entorns laborals L



Agost 2018 Pàg. 20 / 30

Guia-MAT-FP 1819

NombreHoresProgramaEmpresa 9(3) Nombre d’hores que es realitzen a l’empresa, excloses les hores d’FCT.

Validació:

Aquest camp és obligatori si s’ha informat el tag <TipusPrograma>

GrupEnsenyamentAlumne 9(2) Indicar el grup al qual pertany l’alumne/a. Es tracta del grup de classe, no dels diferents agrupaments flexibles amb què es puguin impartir algunes matèries.

Validació:

Camp no obligatori.

Aquest camp no s’ha d’informar si al tag <Nivell> s’ha informat el valor ‘Només FCT (P)’.

Amb independència del nom que li doni el centre a efectes interns, caldrà numerar-lo a partir de l'1.

DataBaixa X(8) Data en què l’alumne/a ha causat baixa en el centre. Cal emplenar aquest camp si l'alumne/a ha causat baixa durant el curs escolar.

Validació:

Camp no obligatori.

Ha d’estar en format DDMMAAAA.

CodiModul X(15) Codi del mòdul segons catàleg.

En cas de mòduls propis del centre la codificació és lliure

Aquest camp no s’ha d’informar si al tag <MarcNormatiu> s’ha informat el valor ‘LOGSE (LG)’ i el crèdit no pertany a un mòdul.

ModulPropi X(1) Indicar si el mòdul amb el codi indicat en el tag anterior (<CodiModul>) és un mòdul propi del centre.

Validació:


Mòdul propi Codi Si S No N


NombreHoresModul 9(3) Nombre d’hores del mòdul de què s’ha matriculat l’alumne aquest curs.

Validació:


CodiUnitatFormativa X(18) Codi de la unitat formativa segons catàleg.

En cas d’unitats formatives pròpies del centre la codificació



Agost 2018 Pàg. 21 / 30

Guia-MAT-FP 1819

és lliure.

Aquest camp no s’ha d’informar si al tag <MarcNormatiu> s’ha informat el valor ‘LOGSE (LG)’

UnitatFormativaPropia X(1) Indicar si la unitat formativa amb el codi indicat en el tag anterior (<CodiUnitatFormativa>) és una unitat formativa pròpia del centre.

Validació:


Unitat pròpia Codi Si S No N Les unitats formatives pertanyents a un mòdul marcat com a propi s’actualitzaran com a pròpies independentment de com s’indiquin a la tramesa.


NombreHoresUnitatFormativa 9(3) Nombre d’hores de la unitat formativa matriculada. La suma de totes les hores d’unitats formatives corresponents a un mateix mòdul ha de coincidir amb la que s’hagi indicat al camp ‘NombreHoresModul’.

Validació:


IdiomaEstrangerVehicular X(2) Si la unitat formativa/cicle s’imparteix en algun idioma estranger s’ha d’indicar l’idioma en què s’imparteix.

Validació:

Camp no obligatori.


Idioma Codi Alemany AL Anglès AN Francès FR Italià IT

CodiCredit X(18) Codi del crèdit segons catàleg.

En cas de crèdits propis del centre la codificació és lliure.

Aquest camp no s’ha d’informar si al tag <MarcNormatiu> s’ha informat el valor ‘LOE (L)’

CreditPropi X(1) Indicar si el crèdit amb el codi indicat en el tag anterior (<CodiCredit>) és un crèdit propi del centre.

Validació:


Crèdit propi Codi Si S No N



Agost 2018 Pàg. 22 / 30

Guia-MAT-FP 1819

Els crèdits pertanyents a un mòdul marcat com a propi s’actualitzaran com a propis independentment de com s’indiquin a la tramesa.


NombreHoresCredit 9(3) Nombre d’hores del crèdit.

Validació:


Bloc de dades acadèmiques. Avaluació

MarcNormatiu X(2) Indica el marc normatiu de la matrícula

Validació:


Marc normatiu Cod i LOE L LOGSE LG

CodiEnsenyament X(12) Codi d’ensenyament segons catàleg.

QualificacioCicle 9(5) Si ha finalitzat el cicle, la qualificació acadèmica del cicle, amb 3 decimals.

Validació:

Camp obligatori si s’ha finalitzat el cicle. En el cas que la qualificació consti al RALC, es comprovarà que coincideixi amb ella la indicada al fitxer.

Qualificació entre 0 i 10, amb tres decimals

QualificacioCiclePAAU 9(6) Camp que ha d’arribar en blanc a la tramesa, ja que en el cas del grau superior s’emplenarà automàticament a partir del camp ‘QualificacióCicle’

TipusEstadaMobilitat 9(1) Si s’ha finalitzat el cicle i ha realitzat una estada de mobilitat internacional s’ha d’indicar quina.

Validació:

Només pot estar informat si el tag <QualificacioCicle> també està informat.

Aquest camp és obligatori si s’han informat els tags <DuradaEstadaMobilitat>, <PaisDestinacio> o <FormacioPractica>.


Mobilitat Codi Erasmus 1 Leonardo de Vinci 2 Programa bilateral 3 Altres programes 4

DuradaEstadaMobilitat 9(3) Durada en dies de l’estada de mobilitat internacional.

Validació:



Agost 2018 Pàg. 23 / 30

Guia-MAT-FP 1819

Aquest camp és obligatori si s’han informat els tags <TipusEstadaMobilitat>, <PaisDestinacio> o <FormacioPractica>.

PaisDestinacio 9(3) Codi del país de destinació a on ha realitzat l’estada de mobilitat internacional.

Validació:

Aquest camp és obligatori si s’han informat els tags <TipusEstadaMobilitat>, <DuradaEstadaMobilitat> o <FormacioPractica>.

S’ha de codificar segons la taula territorial de països.

FormacioPractica X(1) Indicar si a l’estada de mobilitat internacional s’ha realitzat una formació pràctica en centres de treball.

Validació:

Aquest camp és obligatori si s’han informat els tags <TipusEstadaMobilitat>, <DuradaEstadaMobilitat> o <PaisDestinacio>.


Formació pràctica Co di Si S No N

CodiModul X(15) Codi del mòdul segons catàleg.

Validació:


QualificacioModul X(2) Qualificació del mòdul.

Validació:

Camp obligatori si ha finalitzat el mòdul.


Si és un valor numèric és un enter.

En el cas de formació a centres de treball (apte o no apte), o de convalidació o exempció, els valors permesos són:

Qualificació Codi Convalidació C Exempció E Apte A No apte NA

CodiUnitatFormativa X(18) Codi de la unitat formativa segons catàleg.

Validació:


Convocatoria X(1) Convocatòria en la que s’ha avaluat la unitat formativa/crèdit.



Agost 2018 Pàg. 24 / 30

Guia-MAT-FP 1819

Validació:


Modalitat Codi Primera convocatòria P Altres convocatòries A

QualificacioUnitatFormativa

X(2) Qualificació de la unitat formativa.

Validació:



En el cas de formació a centres de treball (apte o no apte), o bé de convalidació, exempció, no presentat o no finalitzada, els valors permesos són:

Qualificació Codi Convalidació C Exempció E No presentat N No finalitzada F Apte A No apte NA

NombreHoresPracticaEmpresa 9(3) Si ha realitzat pràctiques en empreses (FCT) s’ha d’indicar el nombre d’hores de pràctiques que ha fet l’alumne/a.

CodiCredit X(18) Codi del crèdit segons catàleg.

Validació:


QualificacioCredit

X(2) Qualificació del crèdit.

Validació:



En el cas de convalidació, exempció, no presentat o no finalitzada els valors permesos són:

Qualificació Codi Convalidació C Exempció E No presentat N No finalitzada F



Agost 2018 Pàg. 25 / 30

Guia-MAT-FP 1819

3.3 Canvis respecte al curs anterior Els canvis que s’han produït el 2018-2019 respecte al curs anterior han afectat únicament el camp ‘QualificacioCicle’ i no han tingut cap repercussió estructural, de manera que no tenen transcendència pràctica a l’hora de trametre les dades. Han estat els següents:

1) Atès que per al curs 2018-2019 constarà en molts casos al RALC la qualificació global dels alumnes que finalitzen cicles formatius d’FP, s’ha optat per realitzar la validació següent: si l’alumne té a RALC per a aquell ensenyament una nota global, es forçarà que sigui aquesta la que es registri al SII, independentment de la indicada al fitxer tramès; si a RALC no hi ha nota global, es respectarà al SII la que el centre hagi indicat.

2) Quan al camp ‘QualificacioCicle’ s’indica una xifra de menys de 3 decimals (ja sigui manualment via web o mitjançant fitxer XML), el sistema automàticament el completarà amb zeros fins a arribar als tres.



Agost 2018 Pàg. 26 / 30

Guia-MAT-FP 1819

4. ANNEXOS

4.1 Guió d’ús A continuació enumerem un conjunt de bones pràctiques amb l’objectiu de facilitar als centres la migració al nou procés de tramesa de dades de matrícula i avaluació dels alumnes de cicles formatius de formació professional:

1. Construir i validar un fitxer XML de prova amb poques matrícules amb l’objectiu d’assimilar els conceptes bàsics. • Un bon punt de partida seria construir una tramesa (fitxer XML) amb un conjunt de

matrícules suficients per provar les diferents opcions i variants que especifica l’XSD. No és una qüestió de quantitat de matrícules sinó de varietat. Per exemple, que la tramesa tingui matrícules LOE (amb unitats formatives) i LOGSE (amb crèdits), amb i sense programes, mòduls propis, etc.

• En aquesta primera fase d’implantació cal focalitzar el treball en les matrícules i deixar per a més endavant les avaluacions.

• Un cop construïda una tramesa d’exemple cal validar que aquesta sigui correcte. Amb aquest objectiu utilitzarem el servei Web de validació de fitxer d’alumnat de form ació professional descrit en aquest document.

• El servei Web validarà que la tramesa compleixi amb l’XSD i retornarà els corresponents errors. L’XSD del fitxer de matrícula de FP està disponible a la Web del departament d’Ensenyament . Caldrà modificar la tramesa d’exemple per donar solució als errors fins que el servei Web la doni per correcte.

• Si no es vol utilitzar el servei Web per validar que la tramesa compleixi amb l’XSD, existeixen pàgines Web on indicant el fitxer XML i l’XSD (disponible a la Web del departament d’Ensenyament) ja es realitza aquesta validació. Per exemple: http://www.freeformatter.com/xml-validator-xsd.html

• Un cop tinguem una tramesa d’exemple ben construïda (validada pel servei Web) tindrem l’experiència i coneixements necessaris per construir amb certes garanties la tramesa amb les matrícules i avaluacions de formació professional del centre que enviarem al SII.

2. Enviament de la tramesa de matrícules de formació professional del centre al SII: • La tramesa amb les matrícules de formació professional del centre s’enviarà mitjançant

l’aplicació SII tal com s’ha estat fent fins ara. Només caldrà indicar al SII que es tracta d’una tramesa de formació professional:

• Un cop seleccionat un arxiu, el SII realitzarà una sèrie de validacions bàsiques sobre el contingut del fitxer amb l’objectiu de garantir un mínim de coherència i validesa. Una



Agost 2018 Pàg. 27 / 30

Guia-MAT-FP 1819

d’aquestes validacions és que el fitxer s’ajusti al seu XSD, és a dir la mateixa validació que ja havíem vist al primer punt. És per això que és probable que als nostres primers intents d’enviament de la tramesa el SII retorni una sèrie de missatges d’error. Per exemple:

Aquest tipus de missatge adverteix que l’estructura XML del fitxer no és vàlida i assenyala la línia 26 com a origen del problema.

Aquests tipus de missatges adverteixen de problemes al contingut de certs camps. Més concretament assenyalen que el valor M no és un valor vàlid per al camp sexe (l’XSD especifica com a valors vàlids per aquest camp H i D) i que el valor 04062000 no té el format adequat per al camp codiPostal (l’XSD especifica com a format vàlid per aquest camp un valor numèric amb cinc dígits).

• Caldrà modificar la tramesa per corregir els errors mostrats al punt anterior fins que superi

totes les validacions i es mostri el següent pas en el procés d’enviament de la tramesa. En aquest punt ja podrem fer l’enviament de les matrícules.



Agost 2018 Pàg. 28 / 30

Guia-MAT-FP 1819

Puntualitzacions a l’hora de construir la tramesa de FP:

• Per als camps no obligatoris, si no volem indicar un valor llavors ho farem de la següent manera:

<p:Telefon xsi:nil="true" />

D’aquesta manera indiquem que no enviem cap valor per al camp corresponent. No és correcte fer-ho de les següents maneres:

<p:Telefon></p:Telefon>

o <p:Telefon/>

En aquests casos estem indicant que enviem un valor buit per al camp corresponent i és processarà com a qualsevol altre valor.

4.2 Exemple de matrícula de formació professional A continuació mostrem un exemple vàlid molt bàsic (un alumne sense IDALU amb una matrícula LOGSE amb un mòdul i crèdit amb les seves avaluacions) d’un fitxer de de formació professional per al curs 2018-2019. <?xml version="1.0" encoding="ISO-8859-1"?> <p:Centre xmlns:p="http://ens.gencat.cat/sii/guiamat/fp/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <p:CodiCentre> </p:CodiCentre> <p:AnyAcademic>1819</p:AnyAcademic> <p:Alumnes> <p:Alumne> <p:DadesAlumne> <p:IDALU xsi:nil="true"/> <p:TipusDocumentIdentitat>A</p:TipusDocumentIdentitat> <p:NumeroDocumentIdentitat> </p:NumeroDocumentIdentitat> <p:NomAlumne> </p:NomAlumne> <p:PrimerCognomAlumne> </p:PrimerCognomAlumne> <p:SegonCognomAlumne xsi:nil="true" /> <p:Sexe>H</p:Sexe> <p:DataNaixement>31011991</p:DataNaixement> <p:CodiMunicipiNaixement>43123</p:CodiMunicipiNaixement> <p:NomMunicipiNaixementFora xsi:nil="true" /> <p:CodiPaisNaixement>108</p:CodiPaisNaixement> <p:CodiNacionalitat>108</p:CodiNacionalitat> <p:AdrecaAlumne>



Agost 2018 Pàg. 29 / 30

Guia-MAT-FP 1819

<p:TipusVia>CR</p:TipusVia> <p:NomVia>Dels tarongers</p:NomVia> <p:Numero>5</p:Numero> <p:Bloc xsi:nil="true"/> <p:Escala xsi:nil="true"/> <p:Planta>2</p:Planta> <p:Porta>4</p:Porta> <p:CodiMunicipi>43163</p:CodiMunicipi> <p:CodiPostal>43700</p:CodiPostal> <p:CodiPais>108</p:CodiPais> </p:AdrecaAlumne> <p:Telefon xsi:nil="true" /> <p:NEE>A10</p:NEE> </p:DadesAlumne> <p:Matricules> <p:Matricula> <p:MarcNormatiu>LG</p:MarcNormatiu> <p:CodiEnsenyament>CFPS 0251</p:CodiEnsenyament> <p:DataMatricula>20112017</p:DataMatricula> <p:CursAcademicIniciCicle>1314</p:CursAcademicIniciCicle> <p:Nivell>P</p:Nivell> <p:ModalitatCursa>N</p:ModalitatCursa> <p:EscolaritzacioCompartida>N</p:EscolaritzacioCompartida> <p:CodiCentreCompartit xsi:nil="true"/> <p:CodiCentreCustodiaExpedient xsi:nil="true"/> <p:AlumneConveni>N</p:AlumneConveni> <p:NIFEntitatConveni xsi:nil="true"/> <p:Torn>MT</p:Torn> <p:RequisitsAcademicsAcces>1</p:RequisitsAcademicsAcces> <p:UltimEstudiMatriculat>5</p:UltimEstudiMatriculat> <p:CursUltimEstudiMatriculat>1112</p:CursUltimEstudiMatriculat> <p:CodiPaisUltimEstudiMatriculat>108</p:CodiPaisUltimEstudiMatriculat> <p:Programa> <p:TipusPrograma>L</p:TipusPrograma> <p:NombreHoresProgramaEmpresa>120</p:NombreHoresProgramaEmpresa> </p:Programa> <p:GrupEnsenyamentAlumne xsi:nil="true"/> <p:DataBaixa xsi:nil="true"/> <p:Moduls> <p:Modul> <p:CodiModul>MP01</p:CodiModul> <p:ModulPropi>N</p:ModulPropi> <p:NombreHoresModul>30</p:NombreHoresModul> <p:Credits> <p:Credit> <p:CodiCredit>C01</p:CodiCredit> <p:CreditPropi>N</p:CreditPropi> <p:NombreHoresCredit>12</p:NombreHoresCredit> <p:IdiomaEstrangerVehicular xsi:nil="true"/> </p:Credit> </p:Credits> </p:Modul> </p:Moduls> </p:Matricula> </p:Matricules> <p:Avaluacions> <p:Avaluacio> <p:MarcNormatiu>L</p:MarcNormatiu> <p:CodiEnsenyament>CFPS 0251</p:CodiEnsenyament> <p:CicleFinalitzat> <p:QualificacioCicle>9.250</p:QualificacioCicle> <p:QualificacioCiclePAAU xsi:nil="true"/> <p:EstadesMobilitat> <p:EstadaMobilitat> <p:TipusEstadaMobilitat>1</p:TipusEstadaMobilitat> <p:DuradaEstadaMobilitat>20</p:DuradaEstadaMobilitat> <p:PaisDestinacio>115</p:PaisDestinacio> <p:FormacioPractica>S</p:FormacioPractica> </p:EstadaMobilitat>



Agost 2018 Pàg. 30 / 30

Guia-MAT-FP 1819

</p:EstadesMobilitat> </p:CicleFinalitzat> <p:Moduls> <p:Modul> <p:CodiModul>MP01</p:CodiModul> <p:ModulFinalitzat> <p:QualificacioModul>C</p:QualificacioModul> </p:ModulFinalitzat> <p:Credits> <p:Credit> <p:CodiCredit>C01</p:CodiCredit > <p:Convocatoria>A</p:Convocatoria> <p:QualificacioCredit>E</p:QualificacioCredit> <p:PractiquesEmpresa> <p:PracticaEmpresa> <p:NombreHoresPracticaEmpresa>100 </p:NombreHoresPracticaEmpresa> </p:PracticaEmpresa> </p:PractiquesEmpresa> </p:Credit> </p:Credits> </p:Modul> </p:Moduls> </p:Avaluacio> </p:Avaluacions> </p:Alumne> </p:Alumnes> </p:Centre>

Guia MAT d’FPeducacio.gencat.cat/.../ManualsAplicacions/Guia_MAT_FP.pdf · SISTEMA D’INTERCANVI...

Documents

Transcript of Guia MAT d’FPeducacio.gencat.cat/.../ManualsAplicacions/Guia_MAT_FP.pdf · SISTEMA D’INTERCANVI...