Consideraciones sobre la remisión de información en XML (Revisión )

Transcripción

1 Cnsideracines sbre la remisión de infrmación en XML (Revisión ) 1. Prcedimient de generación de un archiv XML Herramientas para el tratamient de dcuments XML Errres más cmunes en la generación de archivs XML Errres en el enví de archivs XML a la D.G. Catastr Herramientas de cnversión Errres más frecuentes en la generación del text plan Hja de estil (XSL) Prcedimient de generación de un archiv XML A la hra de generar un dcument XML para su psterir enví a la Dirección General del Catastr, se recmienda seguir ls siguientes pass para evitar la aparición de errres en el mism. Cnsulta de dcuments Para que el ficher XML que se genere sea l más crrect psible se deben cnsultar ls siguientes dcuments. Esquemas: Se deberían cnsultar tant el esquema de XCAT (ldc.xsd) cm el crrespndiente al frmat del archiv en cuestión. Ambs están dispnibles en la web del catastr. Est permitirá averiguar qué camps sn bligatris y cuáles sn ptativs, el frmat de tds ls elements, las restriccines, etc. Instancia explicativa: En la web del Catastr hay dispnible una instancia explicativa para cada frmat de intercambi. En cada instancia se explica el cntenid de cada camp y se prprcina infrmación acerca del frmat. Ejempl instancia: También está dispnible para cada frmat una instancia de ejempl, que puede servir de ayuda en el mment de generar el archiv. Especificacines técnicas: El dcument de especificacines técnicas ayudará a cmprender cncepts de catastr relacinads cn el frmat que se está utilizand. Verificar que está bien frmad Una vez que se ha generad el dcument XML, se debe verificar que éste está bien frmad, es decir, que sigue crrectamente las especificacines XML y su estructura es crrecta. En casines n será necesari realizar esta cmprbación, puest que al realizar el pas siguiente (validación), las herramientas verifican también que el dcument esté bien frmad. Validar cntra el esquema Es necesari validar el dcument XML para cmprbar que se ajusta a su esquema crrespndiente. La validación es un pas imprescindible antes del enví del dcument a la Dirección General del Catastr, puest que n se admitirán fichers n validads cntra el crrespndiente esquema. Página 1

2 2. Herramientas para el tratamient de dcuments XML A cntinuación se prprcina un listad de herramientas que se pueden utilizar para facilitar la visualización, edición y validación de dcuments XML. Validación nline Editres XML Permiten realizar validación cntra el esquema. SW libre: firstbject XML Editr - Permite tratar archivs grandes (300 MB aprximadamente). XML Cpy Editr - Permite tratar archivs grandes (150 a 200 MB aprximadamente). SW prpietari: Altva XMLSpy - Librerías MSXML (Micrsft) Xerces (Apache) - Códig Java para validar dcuments XML utilizand Xerces: //cnfiguración del parser SAXParserFactry factry = SAXParserFactry.newInstance(); SAXParser parser = factry.newsaxparser(); XMLReader reader=parser.getxmlreader(); reader.setfeature(" true); reader.setfeature(" true); reader.setfeature(" true); //validación reader.parse(archiv); Página 2

3 3. Errres más cmunes en la generación de archivs XML A cntinuación se describen ls errres más frecuentes que pueden darse en la generación de archivs XML. 1. Fechas Tda fecha deberá ser válida y seguir el frmat AAAA-MM-DD AAAA: añ (4 dígits) MM: mes (2 dígits) DD: día (2 dígits) Crrect Incrrect /01/ Hras Tda hra deberá ser válida y cumplir cn el frmat HH:MM:SS HH: hra (2 dígits) MM: minuts (2 dígits) SS: segunds (2 dígits) Crrect Incrrect 14:24:18 14:24 14h24m18s 3. Lngitud de ls camps La lngitud de ls camps debe ser la que se indique en el esquema crrespndiente, si ésta viene especificada de frma explícita debe pertenecer al rang indicad, en cas de que se indique un valr máxim y/ mínim. <xsd:length value="2"/> La lngitud del camp deberá ser 2 bligatriamente. <xsd:maxlength value="25"/> <xsd:minlength value="10"/> La lngitud deberá estar cmprendida entre 10 y Rang de valres Cuand se indique un rang de valres, el valr del camp deberá estar cmprendid entre el valr mínim y máxim especificads. Página 3

4 <!--Descripción de la referencia catastral--> <xsd:simpletype name="erc"> <xsd:anntatin> <xsd:dcumentatin>descripción de la referencia catastral</xsd:dcumentatin> </xsd:anntatin> <xsd:restrictin base="xsd:integer"> <xsd:mininclusive value="1"/> <xsd:maxinclusive value="3"/> </xsd:restrictin> </xsd:simpletype> Crrect <erc>1</erc> <erc>2</erc> Incrrect <erc>0</erc> <erc>25</erc> 5. Decimales En ls númers decimales la parte entera y la decimal deben estar separadas pr una cma (,). La parte decimal debe tener la lngitud indicada, n puede acrtarse suprimirse pr el hech de que sól haya cers a la derecha. 20,30 20,42 Crrect ,3 Incrrect 6. Mayúsculas El cntenid de casi tds ls camps alfanumérics debe ir bligatriamente en mayúsculas. Cm excepción se puede citar al tip cspr (códig de subparcela), que puede ir en minúsculas. 7. Enumeracines El cntenid de un camp de tip enumeración debe ser bligatriamente una de las pcines indicadas en el esquema. <!--Clase de naturaleza del bien inmueble--> <xsd:simpletype name="cn"> <xsd:anntatin> <xsd:dcumentatin>códig de naturaleza del bien inmueble UR: Urbana, Rústica, BI: BICES,</xsd:dcumentatin> </xsd:anntatin> <xsd:restrictin base="xsd:string"> <xsd:enumeratin value="ur"/> <xsd:enumeratin value="ru"/> <xsd:enumeratin value="bi"/> </xsd:restrictin> </xsd:simpletype> Página 4

5 <cn>ur</cn> Crrect <cn>nb</c> Incrrect 8. Nmbres de las etiquetas Ls nmbres de las etiquetas se deben crrespnder exactamente cn ls indicads en el esquema crrespndiente. 9. Orden de ls elements Se debe respetar exactamente el rden de ls elements tal y cm se especifican en el esquema crrespndiente. <xsd:element name="ntreg"> <xsd:anntatin> <xsd:dcumentatin>frmat de Ntaris y Registradres </xsd:dcumentatin> </xsd:anntatin> <xsd:cmplextype> <xsd:sequence> <xsd:element name="cab" type="cabnr"> <xsd:anntatin> <xsd:dcumentatin>cabecera</xsd:dcumentatin> </xsd:anntatin> </xsd:element> <xsd:element name="luden" type="lunr"> <xsd:anntatin> <xsd:dcumentatin>lista de Unidades de dats de entrada</xsd:dcumentatin> </xsd:anntatin> </xsd:element> </xsd:sequence> </xsd:cmplextype> </xsd:element> Crrect <ntreg > <cab> </cab> <luden> </luden> </ntreg> Incrrect <ntreg > <luden> </luden> <cab> </cab> </ntreg> Página 5

6 10. Etiquetas abiertas Es un errr dejar etiquetas abiertas. Cada camp debe tener su etiqueta de inici y de cierre. Crrect <cpp> <cp> </cp> </cpp> Incrrect <cpp> <cp> </cpp> 11. Cntenid de ls camps Es un errr dejar camps vacís. Entre las etiquetas de inici y de cierre el cntenid debe ser del tip esperad. Crrect <lrus> <cpp> <cp> </cp> <cpa> </cpa> </cpp> <npa> </npa> </lrus> <lrus> <cpp> </cpp> <npa/> </lrus> <cp> </cp> Incrrect <cp/> <cpa/> 12. Camps bligatris Es un errr n incluir en el archiv ls camps bligatris. Camps bligatris sn tds aquells cuya definición n incluye minoccurs="0". <xsd:element name="cutit" type="cutit" minoccurs="0"> <xsd:anntatin> <xsd:dcumentatin>cuenta de titulares</xsd:dcumentatin> </xsd:anntatin> </xsd:element> El element cutit n es bligatri. Página 6

7 13. Ocurrencia máxima La currencia máxima de un camp puede ser mayr que 1, es decir, hay camps que pueden repetirse un númer determinad de veces, inclus infinitas veces. <xsd:cmplextype name="liddf"> <xsd:sequence> <xsd:element name="iddf" type="iddf" maxoccurs="unbunded"/> </xsd:sequence> </xsd:cmplextype> La currencia máxima de iddf es infinita, puede repetirse un númer ilimitad de veces. 14. Opcines exclusivas Cada vez que se frezcan diversas alternativas (chice), hay que decantarse pr una de las pcines frecidas. N se puede pner más de una de ellas. <xsd:cmplextype name="rcf"> <xsd:anntatin> <xsd:dcumentatin>referencia catastral de finca</xsd:dcumentatin> </xsd:anntatin> <xsd:chice> <xsd:element name="rc" type="rc"> <xsd:anntatin> <xsd:dcumentatin>referencia Catastral</xsd:dcumentatin> </xsd:anntatin> </xsd:element> <xsd:element name="rfin" type="pc"> <xsd:anntatin> <xsd:dcumentatin>referencia de finca</xsd:dcumentatin> </xsd:anntatin> </xsd:element> </xsd:chice> </xsd:cmplextype> <rcf> <rcf/> <rcf> <rcf/> <rfin> </rfin> <rc> </rc> Crrect <rcf> <rc> </rc> <rfin> </rfin> <rcf/> Incrrect Página 7

8 15. Otras validacines Aparte de las ya mencinadas, alguns camps realizan una validación más cmpleja, que será necesari cnsultar en el esquema crrespndiente para evitar errres. <xsd:simpletype name="nif"> <xsd:anntatin> <xsd:dcumentatin>nif</xsd:dcumentatin> </xsd:anntatin> <xsd:restrictin base="xsd:string"> <xsd:length value="9"/> <xsd:pattern value="([a-z] [0-9]){9}"/> </xsd:restrictin> </xsd:simpletype> 16. Referencia al esquema Cada archiv XML debe cntener una referencia al esquema crrespndiente, mediante el atribut xsi:schemalcatin, al que se darán 2 valres: un espaci de nmbres (namespace) y la URL del esquema. <ntreg xmlns:xsi= xsi:schemalcatin=" xmlns=" <finentrada xmlns:xsi= xsi:schemalcatin=" xmlns=" 17. Camps en blanc El cntenid de ningún camp pdrá cnsistir únicamente en espacis en blanc. En el cas de que se descnzca algún dat bligatri de tip alfanuméric, se deben intrducir ls caracteres NC para indicar esta circunstancia. Si el dat bligatri que se descnce crrespnde a un añ, se debe intrducir el valr Cdificación La cdificación encding de ls fichers XML debe ser UTF-8. Se deben cumplir ds cndicines: - La primera línea debe cntener la siguiente etiqueta, que infrma acerca de la cdificación utilizada: <?xml versin="1.0" encding="utf-8"?> - El archiv, al guardarse, debe estar cdificad cn el jueg de caracteres UTF-8. La mayría de editres XML y de text permiten elegir esta cdificación al guardar un archiv. También existen prgramas, cm recde ( que pueden cambiar la cdificación de ls archivs. Otras herramientas, cm UTF-8 Validatr ( permiten cmprbar si un ficher está cdificad cn UTF-8. Página 8

9 4. Errres en el enví de archivs XML a la D.G. Catastr Cada vez que se envíe un ficher a Catastr, se cmprbará que es válid. Si n l es, se devlverá al usuari una lista cn ls errres que cntiene dich ficher. Dicha lista de errres tendrá el siguiente aspect: Cada errr de la lista cntendrá la siguiente infrmación: El element en el que ha prducid el errr, identificad pr su namespace (en este cas, ' ) y pr el nmbre de la etiqueta. La explicación del errr encntrad, en inglés. Página 9

10 5. Herramientas de cnversión Para facilitar la bligatriedad de presentación de la infrmación en XML y favrecer la transición desde ls tradicinales fichers en text plan hasta ls nuevs frmats se pne a dispsición de ls Agentes Clabradres una serie de herramientas de cnversión, que permiten generar el frmat en XML desde el frmat en text plan. Para cada frmat de intercambi hay dispnible un dcument de especificacines del text plan. Estas especificacines se han de respetar escrupulsamente para pder realizar la cnversión a XML crrectamente. Este dcument, junt cn las herramientas de cnversión, está dispnible en la página Web de la D.G. del Catastr. Prcedimient de cnversión de ficher plan a XML Para realizar la transfrmación se han de seguir ls siguientes pass: 1. Descarga del ejecutable de la herramienta de cnversión que se crrespnda cn el frmat de intercambi que se quiera transfrmar. 2. Ejecutar la herramienta mediante línea de cmands. Existen ds maneras de ejecutar la aplicación: a. Pr línea de cmands, de la siguiente manera: Nmbre del ejecutable ficher plan rigen ficher XML de destin b. Pr línea de cmands y siguiend ls pass de la interfaz para intrducir la lcalización del ficher plan rigen y el XML de destin. Durante la ejecución, la herramienta prprcinará infrmación acerca del estad de la misma. Página 10

11 3. Al finalizar la ejecución: a. Si la ejecución finaliza crrectamente, l indica mediante el mensaje Finalizad OK. El XML generad estará en el ficher que hayams indicad cm destin, y será necesari validarl cntra el esquema crrespndiente para cmprbar que n haya errres. b. Si hay algún errr en la generación, se indicará pr pantalla, y se cancelará la ejecución. Est curre cuand el ficher plan tiene algún errr grave. La infrmación que se puede btener del errr es la siguiente: - Psición en el ficher plan del registr de Expediente al que pertenece el element que ha prducid el errr. - Identificación de dich expediente: Referencia del expediente rigen de la alteración. Entidad rigen de la alteración. Tip de intercambi. Tip de expediente. - Tip de registr que cntiene el errr: Nrmalmente, el errr se ha prducid exactamente en el tip de registr indicad, aunque en casines se indica de manera aprximada, cm curre en el cas de registrs de titularidad. - Descripción del errr en inglés. Requisits técnics N se necesita ninguna adaptación especial para pder ejecutar la herramienta de transfrmación, puede ejecutarse en cualquier rdenadr, si bien, se ha lcalizad la siguiente incidencia: Las herramientas de transfrmación necesitan la librería de Micrsft MSXML 4.0 para pder traducir a XML el ficher plan de entrada, per esta librería cntiene un fall en su códig que prvca una excepción _cm_errr, que abrta dicha cnversión n siend psible la btención del ficher de salida en XML. Para slucinar este prblema, sól si se ha detectad este errr en alguna ejecución de la aplicación, se debe actualizar MSXML 4.0 cn MSXML 4.0 sp2, que se puede descargar gratuitamente desde la Web de Micrsft. Se puede acceder directamente desde el siguiente enlace: B4B6-C5D7485F2B42 Esta slución es cmpatible para ls sistemas perativs: Windws 2000, Windws 98, Windws ME, Windws NT, Windws Server 2003, Windws XP. NOTA: Las pruebas para esta slución y las pruebas de las herramientas de transfrmación han sid realizadas cn éxit para un PC cn Windws XP SP2. Página 11

12 Aplicación gráfica Se ha desarrllad una aplicación gráfica que facilita el us de tdas las herramientas de cnversión existentes. Se encuentra dispnible en la página web del Catastr. Esta aplicación permite realizar la cnversión de un ficher plan a XML en cualquiera de ls frmats de intercambi de Catastr dispnibles. Cnsta de una interfaz gráfica muy sencilla de utilizar que evita ls incnvenientes de tener que trabajar mediante la línea de cmands. Página 12

13 6. Errres más frecuentes en la generación del text plan. Se describen a cntinuación un cnjunt de errres frecuentes en ls que se suele incurrir al generar el ficher plan. Alguns de ests errres hacen impsible la generación del XML mediante la herramienta de cnversión, trs la permiten, per generan dcuments inválids. 1. Frmat del ficher El frmat del ficher plan tiene que cincidir cn una de las siguientes pcines: - Td el cntenid en una única línea, y cada registr cn un tamañ de 1000 caracteres. - Cada registr en una línea de 1000 caracteres cm mínim, cn el carácter de fin de ficher en una línea aparte. 2. Orden de ls registrs El rden de ls registrs debe ser el siguiente: 01 Cabecera del ficher 41 Expediente mvimient 11 Finca 12 Suels 13 Unidades cnstructivas 14 Cnstruccines... (1) (2) 15 Bien inmueble 46 Situacines finales de titularidad 47 Cmunidades de bienes 48 Representante 49 Situacines iniciales de titularidad 16 Reparts 17 Cultivs 90 Cla del ficher (3) Nta: N tds ls registrs aparecen en tds ls frmats, ni tds ls que aparecen sn bligatris. (1) Se repite pr cada expediente del ficher (2) Se repite pr cada finca (3) Se repite pr cada bien inmueble 3. Psicines Se deben rellenar ls camps en las psicines adecuadas. El descuadre de psicines prvca un errr grave. 4. Fechas Página 13

14 Las fechas sn especialmente imprtantes. Para una crrecta transfrmación del ficher plan deben estar crrectamente rellenadas y en las psicines adecuadas. La existencia de una fecha errónea prvcaría un errr de frmat de fuera de rang en la generación del XML. Crrect Si la fecha es pcinal: Incrrect Si la fecha es bligatria: Camps numérics Ls camps numérics deben estar rellenads cn númers, nunca cn espacis en blanc. Un camp numéric cuy valr tiene una lngitud menr que la indicada debe rellenarse cn cers a la izquierda, puest que si se pnen a la derecha su significad será numéric. Un camp numéric pcinal, cuand n exista, pdrá rellenarse, cmpletamente cn cers, cn espacis. Es psible que un únic camp del frmat en text plan se crrespnda cn varias etiquetas en el XML (cm la parcela catastral y el númer de finca registral). Si est sucediese hay que tener en cuenta que si el camp rigen es numéric tdas sus psicines se han de rellenar cn númers, aunque parte del camp n exista. Un camp numéric de 19 psicines. Crrect Incrrect Camps alfanumérics Ls camps alfanumérics deben estar rellenads cn espacis en blanc a su derecha. 7. Enumeracines Ls camps que sól se pueden rellenar cn una determinada enumeración de valres han de estar rellenads sól cn un de ess valres. La clase de naturaleza sól acepta ls valres UR, RU BI. Cualquier tr valr es incrrect. Alguns de ls errres que se acaban de describir impsibilitan la generación del XML, n bstante, el hech de generar el dcument XML n implica que éste sea válid. Pr tant, después de la generación, se ha de validar el ficher resultante a fin de cmprbar la inexistencia de trs errres. Página 14

15 7. Hja de estil (XSL) Alguns de ls frmats de intercambi de Catastr dispnen de una hja de estil que permite visualizar de manera inmediata un resumen de la infrmación presente en un ficher en frmat XML. Esta hja de estil puede utilizarse de ds maneras: bien utilizand el navegadr para abrir el archiv XML, utilizand una herramienta que genere un dcument HTML a partir del archiv XML crrespndiente. Navegadr Para que el navegadr pueda aplicar la hja de estil al archiv XML es necesari que este últim tenga incluida una referencia a la hja de estil crrespndiente. En alguns cass, el ficher XML ya se creará cn la referencia a la hja de estil, cm es el cas de ls frmats DOC, Padrón BICE y Errres. En trs, sin embarg, el ficher n tendrá incluida dicha referencia pr defect, aunque se pdrá mdificar manualmente para incluirla si se desea visualizar el ficher de esta manera. Este sería el cas de FIN de salida, FIN de retrn y Padrón de urbana rústica. Para referenciar una hja de estil en un ficher XML, después de la primera línea (<?xml versin="1.0" encding="utf-8"?>) se debe incluir una etiqueta cm esta: <?xml:stylesheet href="hja_estil" type="text/xsl"?> dnde hja_estil sería la ruta cmpleta del ficher de la hja de estil crrespndiente Pr ejempl, en el cas del frmat padrón sería así: <?xml versin="1.0" encding="utf-8"?> <?xml:stylesheet href=" type="text/xsl"?> <padrn xmlns:xsi=" xsi:schemalcatin=" xmlns=" Cuand el ficher es excesivamente grande n es recmendable utilizar el navegadr para aplicar la hja de estil, ya que puede cnsumir demasiads recurss de la máquina. Prcesadr XSL Ls prcesadres XSL sn capaces de generar dcuments en diferentes frmats a partir de un archiv XML y una hja de estil (XSL). Para que una herramienta de este tip genere el crrespndiente ficher en frmat HTML, slamente será necesari indicar el nmbre del archiv XML y el nmbre de la hja de estil, así cm el nmbre que deberá tener el nuev dcument HTML. Existen muchas de estas herramientas dispnibles en Internet. Una de ellas es Instant saxn ( Página 15

16 Esta pción es la más aprpiada si el ficher XML es muy grande. Pr l general, el dcument HTML resultante tendrá un tamañ bastante inferir al del ficher XML, y pr tant pdrá visualizarse sin prblemas mediante el navegadr. Página 16