SIU-Guarani/Version3.11.0/Migracion/Desde sistemas externos/Migracion/Actas

Migración de Sistemas Externos a Guaraní 3

Módulo: Actas

A continuación se detallarán los pasos necesarios para la migración del módulo Actas.
En este módulo se migrarán los libros de actas y actas de cursada, actas de promoción y actas de examen.
Tablas: sga_libros_actas, sga_libros_tomos, sga_libros_actas_alcance, sga_libros_actas_propuesta, sga_libros_actas_actividad.
sga_actas, sga_actas_detalle, sga_actas_folios.

Pre-Requisitos

• Verificar correcta instalación del Kettle y conexión a la base de datos PostgreSql.
• Carga de datos en Guaraní 3:
  • Años académicos
  • Períodos lectivos y Comisiones
  • Turnos de examen y Mesas de Examen
  • Propuestas y Planes de estudios
  • Alumnos
  • Actividades
  • Escala de notas

Pasos para la Migración

1. Creación de los archivos CSV:

• Delimitador: |
  
• Directorio: Externos/01_Schema/CSV
  

Libros de Actas

Aqui se migrarán los libros de actas de examen/cursada/promoción.
Por defecto se creará un solo tomo por acta, el tomo nro 1.

Archivo mig_libros_de_actas.csv.
Formato del archivo:

Nro	Columna	Tipo de Dato	Permite Nulos	Tablas de Guaraní 3	Observaciones	Pre-Controles que se aplicarán
1	nro_libro	String	N		Nro de Libro de Actas.	Que no exista el nro de libro en Guarani 3.
2	nombre	String	N		Nombre visible del libro de actas.
3	descripcion	String	S		Descripción del libro de actas
4	anio_academico	Integer	S		Año académico para el que fue definido el libro. Solo en el caso que cada libro se de defina por año acadèmico.
5	cant_max_folios_x_tomo	Integer	S		Nro máximo de folios de cada tomo del libro. Si el libro de actas no tiene un número total de folios por tomo, entonces no ingresar valor en este campo, de lo contrario ingresar un valor mayor a cero. Cuando se llega a esta cantidad de folios el sistema crea automàticamente un nuevo tomo para el libro de actas.
6	alcance_acta_regular	String	N	sga_libros_actas_alcance.origen = R	Valores: S-Si / N-No. Define si el libro de actas es para actas de Cursadas
7	alcance_acta_promocion	String	N	sga_libros_actas_alcance.origen = P	Valores: S-Si / N-No. Define si el libro de actas es para actas de promociones
8	alcance_acta_examen	String	N	sga_libros_actas_alcance.origen = E	Valores: S-Si / N-No. Define si el libro de actas es para actas de examenes
9	propuesta	Integer	S	sga_propuestas.propuesta	Completa la tabla sga_libros_actas_propuesta. Solo en el caso que los libros de actas se registren por propuesta, en caso contrario este dato no debe cargarse.
10	elemento	Integer	S	sga_elementos.elemento	Completa la tabla sga_libros_actas_actividad. Solo en el caso que los libros de actas se definan por actividad, en caso contrario este dato no debe cargarse.
11	ubicacion	Integer	S	sga_ubicaciones.ubicacion	Completa la tabla sga_libros_actas_ubicacion
12	fecha_activacion	Date	S		Formato dd/MM/yyyy
13	fecha_fin_vigencia	Date	S		Formato dd/MM/yyyy
14	es_libro_activo	Integer	N		Valores posibles: S/N. Indica si el libro está activo

Actas de Cursadas y Promoción

Consideraciones

La Comisión a la que pertenece el acta de cursada/promoción se identifica por los campos anio_academico + periodo_lectivo_nombre + comision_nombre + actividad_codigo.
Al Alumno se lo identificará con: tipo_documento + nro_documento + propuesta. Debe existir el alumno en la tabla sga_alumnos.
Si se ingresa el folio físico (folio_fisico), los alumnos se ordenarán por apellido y nombres y se agruparan en folios según el folio físico. Si este dato no viene, entonces los alumnos se ordenaran por apellido y nombres y cada folio constará de la cantidad de alumnos definidos por folio en el campo renglones_folio

Archivo mig_acta_cursada_promocion.csv.
Formato del archivo:

Nro	Columna	Tipo de Dato	Permite Nulos	Tablas de Guaraní 3	Observaciones	Pre-Controles que se aplicarán
1	origen	String	N			R - Acta de Regulares P - Acta de Promociones
2	nro_acta	String	N			Nro del Acta de Cursadas o Promociones. Si se ingresa el dato -1 entonces el nro de acta se generará en forma automática
3	fecha	Date	S		Fecha de Regularidad/promocion. Formato dd/mm/yyyy
4	renglones_folio	Integer	N		Cantidad de renglones del acta en cada folio. Deben indicar la cantidad de alumnos que entran en cada folio físico del acta.
5	nro_libro	Integer	N	sga_libros_actas.nro_libro Libros que sean de actas de cursadas: sga_libros_actas_alcance.origen = C , o libros de actas que sean para actas de promocion: sga_libros_actas_alcance.origen = P, segun sea el caso del acta que se este importando.
6	nro_tomo	Integer	S	sga_libros_tomos.nro_tomo	Nro de tomo dentro del libro de actas donde se encuentra el alumno. Este dato puede ser nulo
7	comision_nombre	String	S
8	anio_academico	Integer	S	sga_anios_academicos
9	periodo_lectivo_nombre	String	S
10	actividad_codigo	String	S	sga_elementos.codigo	Debe existir la actividad con ese código.
11	tipo_documento	Integer	S
12	nro_documento	String	S
13	propuesta	Integer	S	sga_propuestas.propuesta	ID de la propuesta en la que se encuentra el alumno
14	plan_version	integer	S		sga_planes_versiones.plan_version (Versión del plan del alumno en que hizo la actividad)
15	folio_fisico	Integer	S		Registro del folio físico dentro del libro de actas si existe el dato.
16	folio	Integer	S		Nro de folio dentro del acta (1, 2, ..n)
17	renglon	Integer	S		Nro de renglon/orden dentro del folio
18	pct_asistencia	Number	N		Valor default 0. Porcentaje de asistencia del alumno en la cursada
19	cond_regularidad	Integer	S	sga_cond_regularidad	Solo para Actas de Regulares
20	fecha_vigencia	Date	S		Solo para Actas de Regulares. Puede ser nulo (sin vigencia) Formato dd/mm/yyyy
21	escala_nota	Integer	S	sga_escalas_notas
22	nota	String	N	sga_escalas_notas_det	La nota debe existir en la escala de notas
23	resultado	String	S	sga_escalas_notas_resultado	Resultado de la nota (A-Aprobado/R-Reprobado)	El resultado debe coincidir con la nota y escala de notas
24	observaciones	String	N		Observaciones para el alumno en el acta

Si el campo folio_fisico existe, entonces los alumnos se ordenarán por folio_fisico y adentro de cada folio por el dato de renglon o por apellido + nombres.

Actas de Examen

Consideraciones

El acta debe existir en la mesa de examen y llamado, identificado por: turno_examen_nombre + anio_academico + mesa_examen_nombre + actividad_codigo + fecha.
La mesa de examen debe existir en la tabla ext.mig_mesas_examen. Para cargar las instancias de la mesa de examen, se verifica el tipo de mesa definido en la mesa de examen (0 = Libres y regulares ( instancias 3 y 4 ), 3 = Regulares, 4 = Libres).
Al Alumno se lo identificará por: tipo_documento + nro_documento + propuesta. Debe existir el alumno en la tabla sga_alumnos.

Libros de Actas: Si se ingresó un nro de tomo en el libro del acta de examen, pero el mismo no existe, se creará automáticamente en el libro (tabla sga_libros_tomos) al migrar las actas de examen.

Archivo mig_actas_examen.csv. Contiene los datos delos a cabecera de las actas de examen.
Formato del archivo:

Nro	Columna	Tipo de Dato	Permite Nulos	Tablas de Guaraní 3	Observaciones	Pre-Controles que se aplicarán
1	nro_acta	varchar(30)	N		Nro de acta de examen	Se verifica que este nro de acta no exista en otro acta de examen en la base de datos.
2	nro_libro	String	N	sga_libros_actas.nro_libro	Libro de actas de Examen en donde quedará registrado el acta	Se controla la existencia en Guarani 3. Ademas se verifica que el libro informado exista para actas de examen (sga_libros_actas_alcance.origen = E)
3	nro_tomo	Integer	S	sga_libros_tomos.nro_tomo	Este dato puede venir en nulo. Si existe el dato, se verifica que el nro de tomo exista en el libro. Si el nro de tomo viene en nulo, se asignará el acta al tomo nro 1 del libro de actas de examen
4	renglones_folio	Integer	N		Controla que los valores informados sean mayor a 0 (cero)	Deben indicar la cantidad de alumnos que entran en cada folio físico del acta.
5	anio_academico	Integer	N	Formato aaaa: Es el año académico del acta	SE Verifica exista el año académico en la tabla de años académicos sga_anios_academicos.anio_academico	Si el año académico no existe el mismo se crea de igual forma que en la migración de matrícula
6	turno_examen_nombre	String	S	ext.mig_turnos_examen.nombre sga_turnos_examen.periodo -> sga_periodos.nombre	Nombre del turno de examen.
7	mesa_examen_nombre	String	N	ext.mig_mesas_examen sga_mesas_examen.nombre	Nombre de la mesa de examen
8	actividad_codigo	String	N	sga_elementos.codigo	Código de la actividad de la mesa de examen
9	fecha	Date	N	Fecha de Examen: Formato dd/mm/aaaa	Fecha del examen
10	Observaciones	String	S		Observaciones del acta de examen
11	escala_nota	Integer	N	sga_escalas_notas	Escala de notas del acta de examen
12	estado	String	N	ext.mig_mesas_examen	Estado del Acta (A-Abierta / C-Cerrada)

Archivo mig_actas_examen_detalle.csv. Contiene los alumnos de las actas de examen que estan en el archivo ext.mig_actas_examen.
Formato del archivo:

Nro	Columna	Tipo de Dato	Permite Nulos	Tablas de Guaraní 3	Observaciones	Pre-Controles que se aplicarán
1	nro_acta	String	N			El nro_acta debe existir en la cabecera, mig_actas_examen.csv
2	tipo_documento	Integer	N	mdp_tipo_documento.tipo_documento 0-DNI 90=pasaporte 2=cedula
3	nro_documento	String	N		Tipo y nro debe existir en G3 para la persona en la propuesta informada
4	propuesta	String	N	sga_propuestas	Debe existir en G3.Con tipo_documento + nro_documento + propuesta (se recupera el id de alumno (sga_alumnos.alumno)
5	plan_version	integer	S		sga_planes_versiones.plan_version (Versión del plan del alumno en que hizo la actividad)
6	tipo_inscripcion	Integer	N	sga_instancias	Valores: 3-Regular 4-Libre
7	fecha	Date	S	Formato dd/mm/aaaa	Sí se informa debe ser mayor o igual a la de la cabecea del acta.
8	folio_fisico	Integer	N		Sí no se informa el folio físico, se agrupan los alumnos por apellidos y nombres y se genera cada hoja del acta con cantidad de alumnos = dato de la cabecera de renglones por folio u hoja.	Sí viene informado el folio físico, en pre-control se verifica que todos los registros del acta tengan folio físico, de lo contrario se rechaza la novedad. En el caso correcto (todos los registros del acta tienen el folio físico informado) Se agrupan los alumnos por folio físico ordenados por apellidos y nombres y el acta tendrá tantos folios como diferentes folios físico hubieron para la misma; en este caso no se usará el dato de renglones por folio informado en la cabecera del acta.
9	folio	Integer	S		Nro de folio dentro del acta (1, 2, ..n)
10	renglon	Integer	S		Nro de renglon/orden dentro del folio
11	nota	String	N	sga_descalas_notas_det	Sí el resultado es R o A, la nota es obligatoria, para números decimales el separador será el punto (.) La nota debe existir en la escala de notas que tiene definida la cabecera para ese libro+nro acta
12	resultado	String	N	sga_escalas_notas_resultados	El resultado debe existir para la nota y escala de notas Si el alumno estuvo ausente en la mesa de examen, entonces el resultado debe ser U-Ausente, en tal caso no se registra la nota
13	observaciones	String	S		Observaciones del alumno en el acta

2. Creación de tablas ext

1. Ejecutar trabajo: Externos/01_Schema/08_Actas/script_mig_actas.kjb
   

Como resultado se crearán la tablas 'mig_libros_actas','mig_acta_cursada_promocion', 'mig_actas_examen' y 'mig_actas_examen_detalle' en el esquema 'ext', y se llenarán las mismas con los datos de los CSV creados en el paso anterior.

3. Migración del Módulo
En el directorio Externos/02_Modulos/08_Actas, se encuentran los trabajos correspondientes al proceso de migración del esquema 'EXT' al esquema del negocio. Deberán ejecutarse en el órden que se indica a continuación:

1. Precontroles
   
   1. Ejecutar trabajo: Externos/02_Modulos/08_Actas/01_Pre_Controles/prectrl_actas.kjb
      
      
      
      
   2. Revisar el archivo Excel generado por el trabajo del pre-control: Prectrl_Actas.xls, dentro del mismo directorio.
   3. Arreglar errores que detallen en el archivo de precontroles y volver a correrlos para asegurarse que los datos queden consistentes.
      
   4. Si el archivo Prectrl_Actas.xls no contiene registros, se puede continuar con el siguiente paso, ya que significa que no falló ningún precontrol y los datos son consistentes.
2. Migración
   
   1. Ejecutar trabajo: Externos/02_Modulos/08_Actas/02_Migracion/mig_actas.kjb
      
      
      
      
3. Poscontroles
   
   1. Ejecutar trabajo: Externos/02_Modulos/08_Actas/03_Pos_Controles/posctrl_actas.kjb
      
      
      
      
   2. Revisar el archivo Excel generado por el trabajo del post-control: Pos_Controles_Actas.xls, dentro del mismo directorio
      
   3. Este archivo indica si las cantidades de registros migradas, coinciden con los registros del CSV. Si hubo errores, revisar el proceso de migración y volver a migrar.
      

En caso de que algún trabajo del Kettle falle, revisar el error.

---

< Migrar Inscripción a Exámenes < Migración Sistemas Externos

Migrar Equivalencias >