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

De SIU
Saltar a: navegación, buscar

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 = SI/ N = NO. Indica si el libro está activo. Valor default S


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 Define el tipo de acta:
R= Acta de Regulares
P = Acta de Promociones
2 nro_acta String S 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 N Fecha de Regularidad/promoción. 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 Número de tomo dentro del libro de actas.
Este dato puede ser nulo. Valor por defecto <b>1.
Si la institución no maneja el concepto de tomos en los libros, cada libro tendrá un tomo.
7 comision_nombre String N sga_comisiones.nombre Nombre de la comisión
8 anio_academico Integer N sga_anios_academicos.anio_academico Año académico de la comisión
9 periodo_lectivo_nombre String N sga_periodos.nombre Nombre del período lectivo
10 actividad_codigo String n sga_elementos.codigo Código de la actividad de la comisión.
11 tipo_documento Integer S
12 nro_documento String N mdp_personas_documentos.nro_documento Nro de documento del alumno.
13 propuesta Integer N 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). Si no se ingresa dato entonces se recuperará la version del plan actual del alumno (sga_alumnos.plan_version)
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). Si no se ingresa folio, entonces los alumno se ordenarán por apellido + nombres dentro del acta.
17 renglon Integer S Nro de renglon/orden dentro del folio. Solo se considera si se ingresó el dato 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 Dato obligatorio para para Actas de Regulares. La condición de regularidad debe coincidir su resultado con el resultado que se ingrese en esta tabla.
20 fecha_vigencia Date S Fecha de fin de vigencia de la cursada. Solo para Actas de Regulares. Puede ser nulo (sin vigencia). Formato dd/mm/yyyy
21 escala_nota Integer N sga_escalas_notas Escala de notas. Todos los alumnos que estan en un mismo acta deben tener la misma escala de notas.
22 nota String S sga_escalas_notas_det La nota debe existir en la escala de notas. Puede ser nulo. Esto depende de como la institución configuró los parámetros relacionados con la obligatoriedad del registro de notas en actas de cursadas y promociones.
23 resultado String N sga_escalas_notas_resultado Resultado de la nota.
A=Aprobado / R-Reprobado / U=Ausente/Libre.
El resultado debe coincidir con la nota y escala de notas, y tambien con el resultado de la condición de regularidad.
24 observaciones String S 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.

Mig externos 0034 1.png

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
      Mig externos 0035.png

    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
      Mig externos 0036 1.png

  3. Poscontroles
    1. Ejecutar trabajo: Externos/02_Modulos/08_Actas/03_Pos_Controles/posctrl_actas.kjb
      Mig externos 0037.png

    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 >