Instructivo para la creación de archivos XML para...
Transcript of Instructivo para la creación de archivos XML para...
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para
estudiantes versión 1.5
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 2 de 31
Tabla de contenido Introducción. ........................................................................................................................................................... 3
Vocabulario .............................................................................................................................................................. 4
Archivo de datos: XML ............................................................................................................................................. 4
Archivo XSD: Descripción del formato que el XML debe cumplir ........................................................................... 5
Estructura de datos del archivo de estudiantes ...................................................................................................... 5
Elaboración de un archivo XML de estudiantes ............................................................................................... 9
Ejemplo 1: Usando un editor de texto plano ................................................................................................. 9
Ejemplo 2: Usando Microsoft® Excel 2007 ................................................................................................ 12
Configuración de Microsoft® Excel 2007 ................................................................................................ 12
Elaboración del archivo XML de estudiantes en Microsoft® Excel 2007 ........................................... 17
Archivo XSD ........................................................................................................................................................... 24
Lista de comprobación de archivo XML de estudiantes ............................................................................... 30
Revisar formato y valores en archivo generado ................................................................................... 30
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 3 de 31
Introducción.
El presente documento va dirigido a personal administrativo, de informática y/o de control escolar de las
propias instituciones educativas los cuales preparan la información que se envía al Instituto Mexicano del
Seguro Social para el registro de estudiantes.
El nuevo formato de intercambio de datos que se utilizará tiene como propósito que las mismas instituciones
educativas puedan generar su información desde sus propios sistemas de control de estudiantes e incluso
desde herramientas básicas como un procesador de textos simple e incluso una hoja de cálculo.
El presente documento no tiene como finalidad ser una referencia para el aprendizaje de los conceptos XML,
XSD o influir al uso de alguno de los productos aquí mencionados, únicamente informa de la estructura
requerida por el archivo de estudiantes y ejemplos de su integración, la elección de la herramienta
correspondiente será responsabilidad exclusiva de cada institución educativa.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 4 de 31
Vocabulario
Campo Se refiere así a un dato (Nombre, apellido, número de seguridad social, etc.) que se integra
como parte de un archivo.
Registro Es un conjunto o colección de campos con sus correspondientes valores y es utilizado para
identificar una entidad (Registro de Estudiantes)
XML Archivo a generar por parte de la institución educativa para transmitir al IMSS, contiene la
información de los estudiantes. En un archivo XML se incluye tanto la estructura de los
campos como la información que las instituciones educativas transmiten.
XSD Archivo generado por el IMSS que debe utilizarse para la validación de formato del archivo
XML que las instituciones educativas generarán con su información de estudiantes.
Nodo Componente de un archivo XML que delimita cada uno de los campos o secciones. Sirve
para identificar o etiquetar cada valor contenido del archivo.
Colección Es un conjunto de registros y sus correspondientes valores que pueden repetirse.
Cardinalidad Es la cantidad de repeticiones que puede tener un nodo o un registro en una colección o
archivo XML.
Antecesor Identifica al nodo previo en la jerarquía de un archivo XML, es requerido para la existencia
de sucesores en una colección.
Sucesor Identifica a un nodo dependiente del antecesor.
Archivo de datos: XML El archivo de datos con el cual se informarán los registros de estudiantes hacia el IMSS, es identificado por el
nombre XML (Para una referencia al respecto de los archivos XML, favor de dirigirse a:
http://es.wikipedia.org/wiki/XML). Este formato se propone como un estándar para el intercambio de
información estructurada entre diferentes plataformas informáticas. Se puede usar en bases de datos,
editores de texto, hojas de cálculo y permite identificar el conjunto de caracteres válidos para el intercambio
de información de manera general.
Importante:
Por cada conjunto de estudiantes que la
institución educativa quiera transmitir al IMSS,
habrá de generar un archivo XML.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 5 de 31
Archivo XSD: Descripción del formato que el XML debe cumplir Los archivos XML utilizan un descriptor (formato) identificado como archivo XSD, el cual permite validar y
comprobar si un archivo XML cumple la especificación del contenido que el IMSS solicita. El archivo XSD define
qué elementos puede contener un documento XML, cómo están organizados, qué atributos y de qué tipo son
sus elementos (Nodos). Además, el uso del archivo XSD le permitirá exportar datos a XML desde sus propios
sistemas de control de registro de estudiantes o desde su hoja de cálculo e incluso un editor de textos simple.
Para mayor referencia sobre la constitución, uso y descripción de un archivo XSD, favor de referirse a:
http://es.wikipedia.org/wiki/XML_Schema
Estructura de datos del archivo de estudiantes
La Tabla 1 en la página 7 muestra las reglas de validación de estructura del documento XML necesario para
informar los datos de los estudiantes.
Todos los elementos son obligatorios. Si algún elemento del XML no contiene valor, no se deben eliminar los
tags o etiquetas de ese elemento. Revise los siguientes ejemplos:
Ejemplo 1.- No se cuenta con el dato Apellido Materno
Forma correcta Forma incorrecta
No debe existir ningún valor, espacio en blanco o carácter dentro del tag de inicio y cierre de <APELLIDO_MATERNO>: … <NOMBRE>MARILU</NOMBRE>
<APELLIDO_PATERNO>BAUTISTA</APELLIDO_PATERNO>
<APELLIDO_MATERNO></APELLIDO_MATERNO>
<SEXO>2</SEXO> …
No se debe eliminar el tag de <APELLIDO MATERNO> … <NOMBRE>MARILU</NOMBRE>
<APELLIDO_PATERNO>BAUTISTA</APELLIDO_PATERNO>
<SEXO>2</SEXO> …
Archivo XSD:
En la sección Archivo XSD, en la página 24 de este documento pueden
encontrar una copia del contenido del archivo XSD necesario para la
validación e integración de los archivos XML de estudiantes que las
instituciones educativas transmitirán vía IDSE.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 6 de 31
Forma correcta Forma incorrecta
También puede utilizarse la sintaxis siguiente para indicar la ausencia de este dato: … <NOMBRE>MARILU</NOMBRE> <APELLIDO_PATERNO>BAUTISTA</APELLIDO_PATERNO> <APELLIDO_MATERNO/> <SEXO>2</SEXO> …
No se debe colocar espacios en blanco entre los tags de inicio y cierre de <APELLIDO MATERNO>: … <NOMBRE>MARILU</NOMBRE>
<APELLIDO_PATERNO>BAUTISTA</APELLIDO_PATERNO>
<APELLIDO_MATERNO> </APELLIDO_MATERNO>
<SEXO>2</SEXO> …
Sin embargo, algunos elementos podrían no tener ningún valor en el XML. Ejemplo, siempre deben ir los tags
o etiquetas de NSS en el XML, pero no debe ir ningún valor, espacio en blanco o carácter dentro de ellos.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 7 de 31
Tabla 1. Estructura de datos del archivo de estudiantes
Elemento Caracteres
válidos Longitud Criterio de validación
Obligatorio
/ Opcional
TRAMITE 0-2 1 Debe ser siempre 0 (cero) Obligatorio
NSS 0-9 10 Debe ir sin valor Obligatorio
DIGITO_VERIFICADOR 0-9 1 Debe ir sin valor Obligatorio
CURP A-Z 0-9 18
Corresponde a la Clave de Registro Única de Población (CURP)
del estudiante. Deberá contar con el formato impuesto por la
dependencia gubernamental correspondiente.
Obligatorio
NOMBRE A-Z # espacio 35 Nombre(s) del estudiante Obligatorio
APELLIDO_PATERNO A-Z # espacio 27 Primer apellido del estudiante Obligatorio
APELLIDO_MATERNO A-Z # espacio 27 Segundo apellido del estudiante Opcional
SEXO 1-2 1
Corresponde al sexo del estudiante
Para masculino se escribe un 1
Para femenino se escribe un 2
Obligatorio
LUGAR_NACIMIENTO 0-9 2 Algún valor del 01-32,35 según la Tabla 3. Entidades Federativas
que se encuentra al final de este documento. Obligatorio
DIA_NACIMIENTO 0-9 2 Algún valor del 01-31, 2 dígitos, formato texto, en formato dd Obligatorio
MES_NACIMIENTO 0-9 2 Algún valor del 01-12, 2 dígitos, formato texto, en formato mm Obligatorio
ANIO_NACIMIENTO 0-9 4 4 dígitos, formato texto, en formato aaaa Obligatorio
NOMBRE_PADRE A-Z # espacio 35 Corresponde al nombre(s) del padre del estudiante Opcional
APELLIDO_PATERNO_PADRE A-Z # espacio 27 Corresponde al primer apellido del padre del estudiante Opcional
APELLIDO_MATERNO_PADRE A-Z # espacio 27 Corresponde al segundo apellido del padre del estudiante Opcional
NOMBRE_MADRE A-Z # espacio 35 Corresponde al nombre(s) de la madre del estudiante Opcional
APELLIDO_PATERNO_MADRE A-Z # espacio 27 Corresponde al primer apellido de la madre del estudiante Opcional
APELLIDO_MATERNO_MADRE A-Z # espacio 27 Corresponde al segundo apellido de la madre del estudiante Opcional
DIA_INGRESO 0-9 2 Algún valor del 01-31, 2 dígitos, formato texto, en formato dd Obligatorio
MES_INGRESO 0-9 2 Algún valor del 01-12, 2 dígitos, formato texto, en formato mm Obligatorio
ANIO_INGRESO 0-9 4 4 dígitos, formato texto, en formato aaaa Obligatorio
SALARIO_BASE 0-9. 7 Este valor deberá ser siempre 0000.00
4 enteros punto y 2 decimales, con formato texto Obligatorio
JORNADA_SEMANA 0-6 1 Este valor deberá ser siempre 0 (cero), con formato texto Obligatorio
TIPO_SALARIO 1-3 1 Este valor deberá ser siempre 1 (uno), con formato texto Obligatorio
OCUPACION A-Z 40 Este valor deberá ser siempre ESTUDIANTE, con formato texto Obligatorio
DESCRIPCION_OCUPACION A-Z 40
Corresponde al nivel educativo del estudiante a registrar. Usar
cualquiera de los siguientes:
• POSGRADO
• SUPERIOR
• MEDIO SUPERIOR
• EDUCACION A DISTANCIA
Obligatorio
TIPO_TRABAJO 0-3 1 Este valor deberá ser siempre 2 (dos), con formato texto Obligatorio
CODIGO_POSTAL 0-9 5 Debe corresponder al código postal con 5 dígitos, con formato
texto Obligatorio
TRAMITADO 0-2 1 Este valor deberá ser siempre 0 (cero), con formato texto Obligatorio
Importante:
Deberá entenderse A-Z como todos los caracteres en mayúsculas del alfabeto, sin incluir minúsculas,
acentos, puntos, comas, comillas, dos puntos, paréntesis, etc.
En caso de que se incluya una letra Ñ, debe sustituirse por el carácter #
En conjunto, los datos de los padres son opcionales, por lo que podría omitirse su captura; pero si captura
uno de estos elementos deberá completar los 6 campos de datos de los padres del estudiante.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 8 de 31
La Tabla 2 esquematiza el contenido por secciones del archivo XML a generar.
Tabla 2. Estructura del archivo XML de estudiantes.
Identificador del
nodo/sección/ colección Descripción Requerido Características
EMPLEADOS_EMPRESA
Representa el lote
completo, dentro
del cual se
especifican los
estudiantes
SI
- Es el nodo inicial o la raíz del documento de estudiantes.
- Dentro de este nodo deben existir de 1 a n nodos EMPLEADO
- Su cardinalidad es 1.
EMPLEADO
Es un registro que
se usará para
representar los
datos de un
estudiante.
SI
- Debe tener como antecesor inmediato al único nodo EMPLEADOS_EMPRESA
- La cardinalidad para este registro es 1..n
Su contenido se especifica en la sección
Se pueden incluir tantos estudiantes como
se deseé.
A continuación se detallan los registros <EMPLEADO_EMPRESA> y <EMPLEADO>. Como regla general,
ningún campo se repite al interior del registro EMPLEADO.
El esquema del archivo XML es el siguiente:
Un lote de estudiantes se compone por una colección
usando el tag o etiqueta EMPLEADO_EMPRESA
Para cada registro de estudiante, se integra una colección
de elementos EMPLEADO
Se pueden incluir tantos estudiantes como se deseé.
EMPLEADO_EMPRESA
EMPLEADO1
⁞
EMPLEADO n
}
}
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 9 de 31
Elaboración de un archivo XML de estudiantes
El archivo XML de estudiantes se construye siguiendo una estructura de árbol, donde cada rama se denomina
nodo y cada nodo se compone de una etiqueta de apertura y una etiqueta de cierre.
Ejemplo 1: Usando un editor de texto plano
A continuación se describe la secuencia básica para generar un archivo XML de estudiantes utilizando
cualquier editor de texto plano (Ej. Bloc de notas (Notepad), Edit, vi, etc.), incluyendo un ejemplo en cada paso.
1. Agregar nodo inicial:
2. Agregar el nodo EMPLEADOS_EMPRESA con los parámetros que se muestran a continuación. Esto es un texto fijo a todos los XML que se generen.
3. Agregar todos los estudiantes que se requieran median nodos EMPLEADO.
<?xml version="1.0"?>
<EMPLEADOS_EMPRESA xmlns:xsi="http:www.w3.org/2001/">
<EMPLEADO>
</EMPLEADO>
<EMPLEADO>
</EMPLEADO>
<EMPLEADO>
</EMPLEADO>
</EMPLEADOS_EMPRESA>
<?xml version="1.0"?>
<EMPLEADOS_EMPRESA xmlns:xsi="http:www.w3.org/2001/">
</EMPLEADOS_EMPRESA>
<?xml version="1.0"?>
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 10 de 31
4. Agregar los datos requeridos para cada estudiante utilizando los nodos EMPLEADO.
<?xml version="1.0"?>
<EMPLEADOS_EMPRESA xmlns:xsi="http:www.w3.org/2001/">
<EMPLEADO>
<TRAMITE>0</TRAMITE> <NSS></NSS> <DIGITO_VERIFICADOR></DIGITO_VERIFICADOR> <CURP>BAFM940308MNLTNN01</CURP> <NOMBRE>MARILU</NOMBRE> <APELLIDO_PATERNO>BAUTISTA</APELLIDO_PATERNO> <APELLIDO_MATERNO>FUENTE</APELLIDO_MATERNO> <SEXO>2</SEXO> <LUGAR_NACIMIENTO>09</LUGAR_NACIMIENTO> <DIA_NACIMIENTO>08</DIA_NACIMIENTO> <MES_NACIMIENTO>03</MES_NACIMIENTO> <ANIO_NACIMIENTO>1994</ANIO_NACIMIENTO> <NOMBRE_PADRE></NOMBRE_PADRE> <APELLIDO_PATERNO_PADRE></APELLIDO_PATERNO_PADRE> <APELLIDO_MATERNO_PADRE></APELLIDO_MATERNO_PADRE> <NOMBRE_MADRE></NOMBRE_MADRE> <APELLIDO_PATERNO_MADRE></APELLIDO_PATERNO_MADRE> <APELLIDO_MATERNO_MADRE></APELLIDO_MATERNO_MADRE> <DIA_INGRESO>02</DIA_INGRESO> <MES_INGRESO>08</MES_INGRESO> <ANIO_INGRESO>2010</ANIO_INGRESO> <SALARIO_BASE>0000.00</SALARIO_BASE> <JORNADA_SEMANA>0</JORNADA_SEMANA> <TIPO_SALARIO>1</TIPO_SALARIO> <OCUPACION>ESTUDIANTE</OCUPACION> <DESCRIPCION_OCUPACION>MEDIO SUPERIOR</DESCRIPCION_OCUPACION> <TIPO_TRABAJO>2</TIPO_TRABAJO> <CODIGO_POSTAL>15100</CODIGO_POSTAL>
<TRAMITADO>0</TRAMITADO>
</EMPLEADO>
<EMPLEADO>
<TRAMITE>0</TRAMITE> <NSS></NSS> <DIGITO_VERIFICADOR></DIGITO_VERIFICADOR> <CURP>TOLF781016HDFWDW01</CURP> <NOMBRE>FEDERICO</NOMBRE> <APELLIDO_PATERNO>TORRES</APELLIDO_PATERNO> <APELLIDO_MATERNO>LIMAS</APELLIDO_MATERNO> <SEXO>2</SEXO> <LUGAR_NACIMIENTO>09</LUGAR_NACIMIENTO> <DIA_NACIMIENTO>16</DIA_NACIMIENTO> <MES_NACIMIENTO>10</MES_NACIMIENTO> <ANIO_NACIMIENTO>1978</ANIO_NACIMIENTO> <NOMBRE_PADRE></NOMBRE_PADRE> <APELLIDO_PATERNO_PADRE></APELLIDO_PATERNO_PADRE> <APELLIDO_MATERNO_PADRE></APELLIDO_MATERNO_PADRE> <NOMBRE_MADRE></NOMBRE_MADRE> <APELLIDO_PATERNO_MADRE></APELLIDO_PATERNO_MADRE> <APELLIDO_MATERNO_MADRE></APELLIDO_MATERNO_MADRE> <DIA_INGRESO>02</DIA_INGRESO> <MES_INGRESO>07</MES_INGRESO> <ANIO_INGRESO>2010</ANIO_INGRESO> <SALARIO_BASE>0000.00</SALARIO_BASE> <JORNADA_SEMANA>0</JORNADA_SEMANA> <TIPO_SALARIO>1</TIPO_SALARIO> <OCUPACION>ESTUDIANTE</OCUPACION> <DESCRIPCION_OCUPACION>SUPERIOR</DESCRIPCION_OCUPACION> <TIPO_TRABAJO>2</TIPO_TRABAJO> <CODIGO_POSTAL>11400</CODIGO_POSTAL>
<TRAMITADO>0</TRAMITADO>
</EMPLEADO>
</EMPLEADOS_EMPRESA>
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 11 de 31
6. El archivo de estudiantes ha sido generado. Puede adicionar tantos registros de estudiantes como sea requerido. Puesto que las herramientas de texto tienen un propósito muy básico de edición, esta forma de integrar los archivos XML puede representar la forma más simple de generar sus archivos de estudiantes. Si opta por generar el XML con las instrucciones de la sección anterior, no hay necesidad de utilizar un archivo XSD. La desventaja de esta opción es que no podrá realizar una validación completa de su XML hasta la transmisión de su archivo.
Importante: Para verificar la validez de su archivo revise el archivo XML contra la lista de comprobación que se encuentra en la parte final de este manual.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 12 de 31
Ejemplo 2: Usando Microsoft® Excel 2007 A continuación se describe la secuencia básica para generar un archivo XML de estudiantes utilizando Microsoft® Excel
1
Configuración de Microsoft® Excel 2007
1. Inicie el programa Microsoft® Excel 2007 y dé clic en el botón ubicado en la parte superior izquierda, se desplegará un menú en el cual debe seleccionar la opción “Opciones de Excel”.
1 El Instituto Mexicano del Seguro Social no recomienda ni avala el uso de esta herramienta, se incluye para propósito de
ejemplificar únicamente la integración de un archivo de estudiantes.
Importante:
El IMSS, a través de la Coordinación de Afiliación y la División de
Incorporación Voluntaria y Convenios proporcionará la última versión del
archivo XSD necesario para la validación e integración de los archivos XML
de estudiantes a través de Excel.
También pueden encontrar una copia del contenido de este archivo en la
sección Archivo XSD, en la página 24 de este documento.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 13 de 31
2. Se presentará una pantalla, en la cual ubicaremos la opción de “Más Frecuentes” en el menú lateral izquierdo, y del lado derecho los componentes del mismo. Ubicamos la casilla de “Mostrar ficha Programador en la cinta de opciones” y la seleccionamos, después damos clic en “Aceptar”. Esto agregará la pestaña titulada “Programador” en el menú superior del Excel.
3. En la pestaña “Programador”, ubicamos la opción “Origen” y dé clic en ella. Esta selección desplegará un panel de configuración al lado derecho del área de trabajo. Ver figuras siguientes:
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 14 de 31
4. A continuación especifique el Layout a implementar para la generación de nuestro archivo XML, por lo que en el panel de “Origen XML”, damos clic en el botón de “Asignaciones XML” y aparecerá la ventana siguiente:
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 15 de 31
5. En la ventana de “Asignaciones XML”, dé clic en el botón “Agregar…” y esto mostrará un explorador de archivos para seleccionar el archivo “archivoDisMag.xsd” base para el archivo XML.
6. Al haber seleccionado el archivo “archivoDisMag.xsd”, Excel presentará una ventana indicando que es necesario seleccionar el nodo con el cual se va a basar para la generación del archivo “<nombre_archivo>.xml”, ubique la opción “EMPLEADOS_EMPRESA”, selecciónela y dé clic en “Aceptar”.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 16 de 31
7. Finalmente, dé clic en el botón “Aceptar” y esto agregará automáticamente un árbol de estructura en el “Panel de Origen”, con todos aquellos campos que se llenarán para la generación del XML.
8. Al haber agregado correctamente el archivo XSD base para el XML, se deberá visualizar algo similar a lo siguiente.
Fin de la configuración de Excel para la generación del archivo XML de estudiantes.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 17 de 31
Elaboración del archivo XML de estudiantes en Microsoft® Excel 2007
1. A continuación se presenta el área de trabajo para la elaboración del archivo XML de estudiantes.
2. Ubíquese en el panel “Origen XML”, y seleccione el campo “EMPLEADOS_EMPRESA”, automáticamente Excel seleccionará aquellos campos asociados a este (1) y repita el proceso anterior, arrastrando el campo hacia la celda A1
Área de trabajo
Barra de configuraciones
Panel Origen XML
1
2
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 18 de 31
3. A continuación, inicie el vaciado de los datos para generar el XML. Este vaciado puede realizarlo copiando y pegando sus datos obtenidos desde su listado o programas de control o registro de estudiantes.
Cabe mencionar que para todos estos campos, una vez hecho el mapeo se debe verificar que el formato de las celdas sea de tipo texto.
TRAMITE: Este valor deberá ser siempre 0 (cero), en celda con formato texto
NSS: No debe colocarse ningún valor DIGITO_VERIFICADOR: No debe colocarse ningún valor
CURP:
Corresponde a la Clave de Registro Única de Población
(CURP) del estudiante.
Deberá contar con el formato impuesto por la
dependencia gubernamental correspondiente.
NOMBRE:
Corresponde al nombre(s) del estudiante, es
obligatorio.
APELLIDO_PATERNO:
Corresponde al primer apellido del estudiante, es
obligatorio.
APELLIDO_MATERNO:
Corresponde al segundo apellido del estudiante, este
puede ser opcional.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 19 de 31
SEXO:
Corresponde al sexo del estudiante a
registrar.
Para masculino se escribe un 1
Para femenino se escribe un 2
LUGAR_NACIMIENTO: 2 dígitos, en celda con formato texto, usando el identificador de la entidad federativa según
la Tabla 3. Entidades Federativas al final de
este documento DIA_NACIMIENTO: 2 dígitos, en celda con formato texto, en formato dd MES_NACIMIENTO: 2 dígitos, en celda con formato texto, en formato mm AÑIO_NACIMIENTO: 2 dígitos, en celda con formato texto, en formato aaaa
Datos de PADRE y MADRE: NOMBRE(S)
Corresponden al nombre(s) del padre o
madre del estudiante, son opcionales.
APELLIDO_PATERNO_PADRE y APELLIDO_PATERNO_MADRE: Corresponden al primer apellido del padre o madre del estudiante, son opcionales APELLIDO_MADRE_PADRE y APELLIDO_MADRE_MADRE: Corresponden al segundo apellido del padre o madre del estudiante, son opcionales Recuerde que si llena uno de estos elementos, deberá completar el conjunto
de datos de los padres.
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 20 de 31
DIA_INGRESO: 2 dígitos, en celda con formato texto, en formato dd MES_INGRESO: 2 dígitos, en celda con formato texto, en formato mm ANIO_INGRESO: 4 dígitos, en celda con formato texto, en formato aaaa
SALARIO_BASE: Este valor deberá ser siempre 0000.00 (4 enteros punto y 2 decimales), en celda con formato texto
JORNADA_SEMANA: Este valor deberá ser siempre 0 (cero), en celda con formato texto
TIPO DE SALARIO: Este valor deberá ser siempre 1 (uno), en celda con formato texto
OCUPACION: Este valor deberá ser siempre ESTUDIANTE, en celda con formato texto
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 21 de 31
DESCRIPCION_OCUPACION:
Corresponde al nivel educativo del estudiante a registrar. Usar
cualquiera de los siguientes:
POSGRADO
SUPERIOR
MEDIO SUPERIOR
EDUCACION A DISTANCIA
TIPO_TRABAJADOR: Este valor deberá ser siempre 2 (dos), en celda con formato texto
CODIGO_POSTAL: Debe corresponder al código postal con 5 dígitos, en celda con formato texto
TRAMITADO: Este valor deberá ser siempre 0 (cero), en celda con formato texto
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 22 de 31
4. Habiendo terminado de capturar todos nuestros registros, ubique nuevamente el panel “Origen XML” y localice la opción “Comprobar asignación para exportar” (1). Dé clic en la opción, y en seguida se validará el contenido contra el archivo “archivoDisMag.xsd” que se configuró anteriormente (2)
1
2
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 23 de 31
5. En la pestaña “Programador”, ubique la opción “Exportar” (1), la cual presentará una ventana para colocar el nombre y la ruta en donde deseamos que sea almacenado nuestro archivo xml (2).
Importante: Para asegurar la integridad de su archivo XML revíselo contra la Lista de comprobación de archivo XML de estudiantes en la página 30 de de este manual antes de enviarlo.
1
2
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 24 de 31
Archivo XSD
<?xml version="1.0" encoding="iso-8859-1"?>
<!--Created with Liquid XML Studio - FREE Community Edition 7.0.2.746 (http://www.liquid-
technologies.com)-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="EMPLEADOS_EMPRESA">
<xs:complexType>
<xs:sequence>
<xs:element ref="EMPLEADO" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="EMPLEADO">
<xs:complexType>
<xs:sequence>
<xs:element ref="TRAMITE"/>
<xs:element ref="NSS"/>
<xs:element ref="DIGITO_VERIFICADOR"/>
<xs:element ref="CURP"/>
<xs:element ref="NOMBRE"/>
<xs:element ref="APELLIDO_PATERNO"/>
<xs:element ref="APELLIDO_MATERNO"/>
<xs:element ref="SEXO"/>
<xs:element ref="LUGAR_NACIMIENTO"/>
<xs:element ref="DIA_NACIMIENTO"/>
<xs:element ref="MES_NACIMIENTO"/>
<xs:element ref="ANIO_NACIMIENTO"/>
<xs:element ref="NOMBRE_PADRE"/>
<xs:element ref="APELLIDO_PATERNO_PADRE"/>
<xs:element ref="APELLIDO_MATERNO_PADRE"/>
<xs:element ref="NOMBRE_MADRE"/>
<xs:element ref="APELLIDO_PATERNO_MADRE"/>
<xs:element ref="APELLIDO_MATERNO_MADRE"/>
<xs:element ref="DIA_INGRESO"/>
<xs:element ref="MES_INGRESO"/>
<xs:element ref="ANIO_INGRESO"/>
Importante
Aquí se enlista el contenido en texto del archivo XSD necesario para la
validación e integración de los archivos XML de estudiantes que las
instituciones educativas transmitirán vía IDSE.
Este archivo puede copiarse en una aplicación Bloc de Notas o cualquier otro
editor de texto y guardarlo con extensión .xsd para utilizarlo cómo se
mencionó en este documento.
Nota: En este documento se ha hecho referencia a este archivo con el nombre
“ archivoDisMag.xsd”
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 25 de 31
<xs:element ref="SALARIO_BASE"/>
<xs:element ref="JORNADA_SEMANA"/>
<xs:element ref="TIPO_SALARIO"/>
<xs:element ref="OCUPACION"/>
<xs:element ref="DESCRIPCION_OCUPACION"/>
<xs:element ref="TIPO_TRABAJO"/>
<xs:element ref="CODIGO_POSTAL"/>
<xs:element ref="TRAMITADO"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="TRAMITE">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="1"/>
<xs:pattern value="0|1|2"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="NSS" nillable="true">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:minLength value="0"/>
<xs:maxLength value="10"/>
<xs:pattern value="[0-9]*"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="DIGITO_VERIFICADOR" nillable="true">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:minLength value="0"/>
<xs:maxLength value="1"/>
<xs:pattern value="[0-9]*"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="CURP">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="18"/>
<xs:pattern value="[A-Z]{4}[0-9]{6}[A-Z]{6}[A-Z0-9]{2}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="NOMBRE">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="1"/>
<xs:maxLength value="35"/>
</xs:restriction>
</xs:simpleType>
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 26 de 31
</xs:element>
<xs:element name="APELLIDO_PATERNO">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="1"/>
<xs:maxLength value="27"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="APELLIDO_MATERNO" nillable="true">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="0"/>
<xs:maxLength value="27"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="SEXO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="1"/>
<xs:pattern value="1|2"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="LUGAR_NACIMIENTO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="2"/>
<xs:pattern value="[0-9]{2}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="DIA_NACIMIENTO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="2"/>
<xs:pattern value="[0-9]{2}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="MES_NACIMIENTO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="2"/>
<xs:pattern value="[0-9]{2}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="ANIO_NACIMIENTO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 27 de 31
<xs:length value="4"/>
<xs:pattern value="[0-9]{4}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="NOMBRE_PADRE" nillable="true">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="0"/>
<xs:maxLength value="35"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="APELLIDO_PATERNO_PADRE" nillable="true">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="0"/>
<xs:maxLength value="27"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="APELLIDO_MATERNO_PADRE" nillable="true">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="0"/>
<xs:maxLength value="27"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="NOMBRE_MADRE" nillable="true">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="0"/>
<xs:maxLength value="35"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="APELLIDO_PATERNO_MADRE" nillable="true">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="0"/>
<xs:maxLength value="27"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="APELLIDO_MATERNO_MADRE" nillable="true">
<xs:simpleType>
<xs:restriction base="exp_reg_client">
<xs:minLength value="0"/>
<xs:maxLength value="27"/>
</xs:restriction>
</xs:simpleType>
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 28 de 31
</xs:element>
<xs:element name="DIA_INGRESO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="2"/>
<xs:pattern value="[0-9]{2}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="MES_INGRESO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="2"/>
<xs:pattern value="[0-9]{2}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="ANIO_INGRESO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="4"/>
<xs:pattern value="[0-9]{4}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="SALARIO_BASE">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:minLength value="1"/>
<xs:maxLength value="7"/>
<xs:pattern value="[0-9]{4}.[0-9]{2}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="JORNADA_SEMANA">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="1"/>
<xs:pattern value="0|1|2|3|4|5|6"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="TIPO_SALARIO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="1"/>
<xs:pattern value="1|2|3"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="OCUPACION">
<xs:simpleType>
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 29 de 31
<xs:restriction base="trataEspacios">
<xs:minLength value="1"/>
<xs:maxLength value="40"/>
<xs:pattern value="[A-Z# Ñ]+"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="DESCRIPCION_OCUPACION">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:minLength value="1"/>
<xs:maxLength value="40"/>
<xs:pattern value="[A-Z# Ñ]+"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="TIPO_TRABAJO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="1"/>
<xs:pattern value="0|1|2|3"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="CODIGO_POSTAL">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="5"/>
<xs:pattern value="[0-9]{5}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="TRAMITADO">
<xs:simpleType>
<xs:restriction base="trataEspacios">
<xs:length value="1"/>
<xs:pattern value="0|1|2"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:simpleType name="trataEspacios">
<xs:restriction base="xs:string">
<xs:whiteSpace value="collapse"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="exp_reg_client">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z#]+([ ]{1}[A-Z#]+)*|[A-Z#]*"/>
</xs:restriction>
</xs:simpleType>
</xs:schema>
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 30 de 31
Lista de comprobación de archivo XML de estudiantes
Después de generar su archivo XML con los datos de estudiantes, puede verificar en él cada punto siguiente
antes de enviar su archivo.
Si usó la opción de generar su archivo mediante Microsoft® Excel, también puede verificar estas condiciones a
nivel de columnas antes de generar el archivo xml.
Revisar formato y valores en archivo generado
□ El nombre del archivo XML final no debe exceder de 50 caracteres incluyendo la extensión .xml
□ Los elementos TRAMITE y TRAMITADO contienen sólo el valor 0
□ Los elementos NSS y DIGITO_VERIFICADOR contienen valores nulos y no tiene espacios en blanco
□ Los elementos CURPs son de exactamente 18 caracteres
□ Los elementos NOMBRE y APELLIDO_PATERNO no contienen valores nulos
□ Los elementos SEXO sólo contienen valores 1 y 2
□ Los elementos LUGAR_NACIMIENTO, DIA_NACIMIENTO, MES_NACIMIENTO, DIA_INGRESO, MES_INGRESO contienen siempre dos dígitos (revisar existencia de ceros a la izquierda cuando se trata de los valores del 0 al 9)
□ Los elementos LUGAR_NACIMIENTO se conforman únicamente con valores que estén dentro de la
serie 01, 02, 03, …, 32 o 35 para nacidos en el extranjero. Ver Tabla 3. Entidades Federativas
□ Los elementos DIA_NACIMIENTO y DIA_INGRESO se conforman únicamente con valores dentro de la serie 01, 02, 03, …, 31
□ Los elementos MES_NACIMIENTO y MES_INGRESO se conforman únicamente con valores dentro de la serie 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12
□ Los elementos ANIO_NACIMIENTO Y ANIO_INGRESO contienen siempre 4 dígitos
□ Los elementos ANIO_NACIMIENTO Y ANIO_INGRESO contienen solamente valores entre 1900 y 2010
□ Los elementos SALARIO_BASE solo contiene el valor 0000.00
□ Los elementos OCUPACION solo contienen el valor ESTUDIANTE
□ Los elementos DESCRIPCION_OCUPACION solo contienen los valores MEDIO SUPERIOR, SUPERIOR, POSGRADO o EDUCACION A DISTANCIA
□ Los elementos TIPO_TRABAJO solo contienen el valor 2
□ Los elementos CODIGO_POSTAL solo contienen valores con 5 dígitos
Instituto Mexicano del Seguro Social Seguridad y Solidaridad Social
Instructivo para la creación de archivos XML para estudiantes
Página 31 de 31
Tabla 3. Entidades Federativas
Identificador de la Entidad Federativa
Descripción Entidad Federativa
01 AGUASCALIENTES
02 BAJA CALIFORNIA NORTE
03 BAJA CALIFORNIA SUR
04 CAMPECHE
05 COAHUILA
06 COLIMA
07 CHIAPAS
08 CHIHUAHUA
09 DISTRITO FEDERAL
10 DURANGO
11 GUANAJUATO
12 GUERRERO
13 HIDALGO
14 JALISCO
15 ESTADO DE MEXICO
16 MICHOACAN
17 MORELOS
18 NAYARIT
19 NUEVO LEON
20 OAXACA
21 PUEBLA
22 QUERETARO
23 QUINTANA ROO
24 SAN LUIS POTOSI
25 SINALOA
26 SONORA
27 TABASCO
28 TAMAULIPAS
29 TLAXCALA
30 VERACRUZ
31 YUCATAN
32 ZACATECAS
35 OTROS PAÍSES