UAFSE- Formato de fichero de Indicadores Página 1 de 9
UAFSE- 1- Introducción Para la importación de datos masivos al sistema se dispone de un formato concreto de fichero, dependiendo de la naturaleza de los datos a importar, que se explica en este documento. 1.1- Formato de fichero Los ficheros se pueden incorporar al sistema en dos formatos: Formato XML Formato de texto plano separado por tabuladores El formato XML cuenta con la facilidad de auto-validación, puesto que dispone de esquemas XSD para su correcta comprobación sintáctica sin necesidad de intervención del sistema. El formato de texto plano resulta sencillo de generar a partir de herramientas de hojas de cálculo pero la validación final no tiene automatización estándar. 1.2- Convenciones de tipos de dato Como norma de aplicación para los tipos de datos de cada campo se utilizarán las definidas a nivel internacional en el estándar XSD, concretamente en el apartado de tipos de datos en un esquema (http://www.w3.org/tr/xmlschema11-2/). 1.2.1- Fechas Se utiliza xs:date, la definición de fechas en XML indicada en la especificación, es decir fechas con formato: yyyy-mm-dd (año-mes-día). 1.2.2- Numéricos Se utiliza xs:positiveinteger o xs:decimal, dependiendo si se necesitan decimales o no. El separador de decimales en el estándar es el símbolo punto.. Página 3 de 9
UAFSE- 2- Fichero de indicadores A continuación se muestra la definición requerida para los ficheros de indicadores. 2.1- Listado de campos en formato de texto plano Se especifican los campos por el orden de aparición en cada línea, antes de cada tabulador. Campo 1: (indicador_ idindicadorfisico) Identificador único del indicador físico al que se refiere el valor. Obligatorio: SI. Tipo: Numérico. Tamaño: 3. Validación: Se comprueba que sea uno de los valores permitidos para los identificadores de indicadores físicos. También se comprueba que sea uno de los programados para el PO. Campo 2: (anyovalor) Año al que se refiere el indicador.número de código único de operación a la que se imputa. Obligatorio: SI. Tipo: Numérico. Tamaño: 4. Campo 3: (categoria) Código de la Categoría del Criterio de desagregación [el valor de La categoría implica unívocamente el criterio]. Obligatorio: NO. Tipo: Alfanumérico. Tamaño: 4. Validación: Si se incluye, se comprueba que sea uno de los valores permitidos para los identificadores de categorías. Además, se comprueba que el indicador físico del campo 1 esté asociado con un criterio de desagregación que tenga esta categoría. Si es nulo significa sin desagregación. Campo 4: (valor) Valor del indicador. [Si el indicador no es desagregado por sexo será el valor total, si lo es será el valor de la categoría Hombres ]. Obligatorio: NO. Tipo: Numérico. Tamaño: 14 cifras + 2 cifras decimales. Validación: Si no viene valor se considera que es 0. Campo 5: (valormujeres) Valor del indicador para la categoría Mujeres. [Si el indicador no es desagregado por sexo este valor deberá ser nulo, si lo es será el valor de la categoría Mujeres ]. Página 4 de 9
UAFSE- Obligatorio: NO. Tipo: Numérico. Tamaño: 14 cifras + 2 cifras decimales. Campo 6: (asociación_codigooperacion) Código alfanumérico, único por O.I., de la Operación asociada. Obligatorio: NO. Tipo: Alfanumérico. Tamaño: 20. Validación: Si se incluye, se comprueba que dicha operación esté cargada en el sistema y que ya tenga gastos certificados (es decir que no esté en situación de ser eliminada porque en ese caso quedarían los indicadores ahora cargados sin referencia a nada). Campo 7: (asociación_tipooperacion) Identificador del Tipo de Operación asociado. Obligatorio: NO. Tipo: Numérico. Tamaño: 2. Validación: Si se incluye, se comprueba que dicho tipo de operación existe en el sistema y que ya existan operaciones de ese tipo cargadas (para el PO con el que se esté trabajando) en el sistema y que éstas ya tengan gastos certificados (es decir que no estén en situación de ser eliminadas porque en ese caso quedarían los indicadores ahora cargados con referencia a un tipo de operación sin operaciones). Campo 8: (eje) Identificador del Eje Prioritario del Eje/Tema asociado. Obligatorio: NO. Tipo: Numérico. Tamaño: 3. Será obligatorio siempre salvo en el caso de que el campo 6 tenga valor. Validación: Se comprueba que sea uno de los programados para el PO y O.I. Campo 9: (tema) Identificador del Tema Prioritario del Eje/Tema asociado. Obligatorio: NO. Tipo: Numérico. Tamaño: 3. Será obligatorio siempre salvo en el caso de que el campo 6 tenga valor. Validación: Se comprueba que sea uno de los programados para el PO y O.I. Campo 10: (objetivo) Identificador del Objetivo del Eje/Tema asociado. Obligatorio: SI. Tipo: Numérico. Tamaño: 1. Validación: Se comprueba que sea uno de los programados para el PO y O.I. Campo 11: (tipoayuda) Identificador del Tipo de ayuda del Eje/Tema asociado. Obligatorio: SI. Tipo: Numérico. Tamaño: 1. Página 5 de 9
UAFSE- Validación: Se comprueba que sea uno de los programados para el PO y O.I. 2.2- Esquema de validación XSD Los documentos XML pueden ser validados de forma automatizada (con programas especializados para ello) a través de ficheros de definición de estructura, como los XSD o ficheros de esquema. Son mucho más completos que los DTD puesto que incluyen información relativa a los tipos de datos (alfanuméricos, fechas, etc.) que podemos encontrar en cada campo o etiqueta. <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" elementformdefault="qualified" attributeformdefault="unqualified"> <xs:element name="indicadores"> <xs:documentation>elemento raíz que contiene los indicadores de un programa operativo. <xs:complextype> <xs:sequence maxoccurs="unbounded"> <xs:documentation>secuencia de indicadores <xs:element ref="indicador"/> </xs:sequence> </xs:complextype> <xs:element name="indicador"> <xs:documentation>datos del ValorIndicador. <xs:complextype> <xs:sequence> <xs:element ref="asociacion"/> <xs:element name="anyovalor"> <xs:documentation>año al que se refiere el valor de indicador. base="xs:integer"> <xs:totaldigits value="4"/> <xs:element name="categoria" minoccurs="0"> Página 6 de 9
UAFSE- <xs:documentation>categoría de desagregación a la que se refiere el valor de indicador. base="xs:integer"> <xs:totaldigits value="4"/> <xs:element name="valor"> <xs:documentation>valor total o para hombres si es un indicador desagregado por sexo. base="xs:decimal"> <xs:fractiondigits value="2"/> <xs:totaldigits value="14"/> <xs:element name="valormujeres"> <xs:documentation>valor para mujeres si es un indicador desagregado por sexo. base="xs:decimal"> <xs:fractiondigits value="2"/> <xs:totaldigits value="14"/> </xs:sequence> <xs:attribute name="idindicadorfisico" use="required"> <xs:documentation>identificador del Indicador Físico. <xs:totaldigits value="3"/> </xs:complextype> Página 7 de 9
UAFSE- <xs:element name="asociacion"> <xs:documentation>datos a los que se asocia el valor del indicador. <xs:complextype> <xs:attribute name="objetivo" use="required"> <xs:documentation>objetivo del Eje/Tema al que se asocia. <xs:totaldigits value="1"/> <xs:attribute name="tipoayuda" use="required"> <xs:documentation>tipo de Ayuda del Eje/Tema al que se asocia. <xs:totaldigits value="1"/> <xs:attribute name="eje" > <xs:documentation>eje del Eje/Tema al que se asocia. <xs:totaldigits value="3"/> <xs:attribute name="tema" > <xs:documentation>tema del Eje/Tema al que se asocia. Página 8 de 9
UAFSE- <xs:totaldigits value="3"/> <xs:attribute name="tipooperacion" use="optional"> <xs:documentation>tipo de operación al que se asocia. base="xs:nonnegativeinteger"> <xs:totaldigits value="2"/> <xs:attribute name="codigooperacion" use="optional"> <xs:documentation>código de operación al que se asocia. base="xs:string"> <xs:maxlength value="20"/> </xs:complextype> </xs:schema> Página 9 de 9