Ver el código de «SIU-Guarani/Version3.11.0/Configuracion del sistema/Procesos Personalizables»

__NOTOC__

= METODOS PERSONALIZABLES =

== Descripción ==
Los métodos personalizables son aquellos métodos que conmumente son los mas indicados que en cada instalación del sistema sean personalizados de acuerdo a las normativas y procesos que rigen en cada lugar.

== Listado de Métodos ==
Lista los procesos que deberán ser revisados en el proceso de implementación del sistema y que es muy probable que deban ser personalizados.
Los procesos se listan agrupados por módulo indicando su objetivo, datos de entrada, resultado default, caso de uso donde se usa y el método que lo implementa.

=== Generales ===
{| class="wikitable"
 |-
 ! '''Tema''' || '''Datos de Entrada''' || '''Resultado Default SIU''' || '''Clase PHP - Método''' 
 |-
 ||  Usuario de Acceso al sistema ||1. Código de Usuario|| true/false || Clase: guarani\php\nucleo\_lib\usuarios\usuario.php

Método: '''validar_id_usuario_permitido'''($id_usuario)

Parámetros:
''string'': código de usuario
 |-
 ||  Clave de Acceso al sistema ||1. Clave de acceso || Devuelve false/true || Clase:guarani\php\nucleo\_lib\usuarios\usuario.php

Método: '''validar_clave_permitida'''($clave)

Parámetros:
''string'': clave de acceso al sistema
 |-
 ||  Clave de acceso default || 1. Pais del Documento <br><br> 2. Tipo de Documento de la persona <br><br> 3. Nro de Documento de la persona. || Nro de Documento de la persona|| Clase: guarani\php\nucleo\_lib\usuarios\usuario.php

Método: '''get_clave_default'''(....) 

Parámetros: 
''string'': número de documento
 |-
 ||  Usuario de acceso default || 1. Pais del Documento. <br><br> 2. Tipo de Documento de la persona. <br><br> 3. Nro de Documento de la persona. || Nro de Documento de la persona|| Clase: guarani\php\nucleo\_lib\usuarios\usuario.php

Método: '''get_usuario_default'''(...)

Parámetros:
''string'': número de documento
 |-
 ||  Obtener Logo del Sistema (Tamaño Normal) ||  || Logo SIU || Clase: guarani.php

Método: '''get_path_logo_impresion'''()

Resultado:
''string'': ''path'' al logo a utilizar en impresiones y previsualizaciones del sistema
 |-
 ||  Obtener Logo del Sistema (Tamaño Chico) ||  || Logo SIU ||Clase: guarani.php

Método: '''get_path_logo_impresion_chico'''()

Resultado:
''string'': ''path'' al logo a utilizar en impresiones y previsualizaciones del sistema, cuando se requiera una versión reducida en tamaño 
|}

=== Matrícula ===
{| class="wikitable"
 |-
 || '''Tema''' || '''Datos de Entrada''' || '''Resultado Default SIU''' || '''Clase PHP - Método'''
 |-
 ||  Generación de Número de Legajo para Alumnos ||1. '''¿El legajo es el mismo para todas las propuestas en las que se encuentra el alumno?:''' S-Sí/N-No <br><br> 2. '''Inscripción:''' código de inscripción a propuesta <br><br> 3. '''Persona:''' código de persona <br><br> 4. '''Propuesta:''' código de propuesta <br><br> '''Ubicación:''' código de ubicación || Devuelve un número correlativo de legajo. Utiliza la secuencia '''nro_legajo_alumno_seq'''|| Clase: legajos.php

Método: '''get_nuevo_nro_legajo'''($unico_legajo, $inscripcion, $persona, $propuesta, $ubicacion)

Parámetros:
''string(1)'': S-Sí/N-No
''int'': código de inscripción a propuesta
''int'': código de persona
''int'': código de propuesta
''int'': código de ubicación
 |-
 || Control de regularidad de los alumnos en las propuestas ||  ||  || Para agregar nuevos requisitos o causas de pérdida de regularidad, deberá agregarse un registro por cada requisito en la tabla '''sga_perdidas_regularidad_causas''' indicando para_requisitos = 'S' y creando la regla correspondiente ('''sga_reglas''') que tenga desarrollado el proceso que se refiere a dicho requisito. Como ejemplo se puede ver la regla '''600 - Verifica que el alumno tenga aprobada dos actividades en un año académico''' que es el requisito que se entrega por defecto desde el SIU. 
Regla PHP: '''\php\nucleo\_lib\reglas\regla_regularidad_dos_actividades_aprobadas.php'''
|}

=== Cursadas ===
{| class="wikitable"
 |-
 ! '''Tema''' || '''Datos de Entrada''' || '''Resultado Default SIU''' || '''Clase PHP - Método''' ||
 |-
 || '''Comisiones''' || || || 
 |-
 || Generación del array de nombres de comisiones || || Setea una variable de clase con el array de nombres. Cada institución puede personalizar estos nombres || Clase: comision.php

Método: '''set_nombres_default_comisiones'''() 
 |-
 || Generación del nombre de la comisión || 1. Nro comisión de una Actividad a generar en un Período Lectivo || Devuelve el nombre de la comision por default. Hay un array que contiene el nombre de unas 100 comisiones||Clase: comision.php

Método: '''get_nombre_default_comision'''($nro_comision)

Parámetros:
''int'': número de la comisión dentro de la actividad y período lectivo
 |-
 || '''Actas''' || || || 
 |-
 || Generación de Libro para Actas de Regulares || 1. '''Origen:''' R-Regulares <br><br> 2.''' Tipo de Acta:''' N-Normal / R-Rectificativa <br><br> 3. '''Comisión:''' id de la comisión|| Devuelve el libro activo de cursados || Clase: co_actas.php 

Método: '''get_libro_de_actas'''($parametros)

'''parámetros''' ''array()'': 

'''origen''' ''string(1)'': E-Examen/R-Regulares/P-Promociones/Q-Equivalencias

'''tipo_acta''' ''string(1)'': N-Normal / R-Rectificativa

'''comision''' ''int'': id de la comisión
 |-
 || Generación de Libro para Actas de Promoción || 1. '''Origen:''' P-Promocionales <br><br> 2.''' Tipo de Acta:''' N-Normal / R-Rectificativa <br><br> 3. '''Comisión:''' id de la comisión || Devuelve el libro activo de promoción || Clase: co_actas.php

Método: '''get_libro_de_actas'''($parametros)

'''parámetros''' ''array()'':

'''origen''' ''string(1)'': E-Examen/R-Regulares/P-Promociones/Q-Equivalencias 

'''tipo_acta''' ''string(1)'': N-Normal / R-Rectificativa 

'''comision''' ''int'': id de la comisión 
 |-
 || Generación de Número para Actas de Regulares ||  1. '''Origen:''' R-Regulares <br><br> 2.''' Tipo de Acta:''' N-Normal / R-Rectificativa <br><br> 3. '''Comisión:''' id de la comisión || De acuerdo a los datos recibidos, devuelve el último número de acta + 1 || Clase: co_actas.php 

Método: '''generar_nro_acta'''($parametros)

'''parámetros''' ''array()'':

'''origen''' ''string(1)'': E-Examen/R-Regulares/P-Promociones/Q-Equivalencias

'''tipo_acta''' ''string(1)'': N-Normal / R-Rectificativa

'''comision''' ''int'': id de la comisión
 |-
 || Generación de Número para Actas de Promoción||  1. '''Origen:''' P-Promociones <br><br> 2.''' Tipo de Acta:''' N-Normal / R-Rectificativa <br><br> 3. '''Comisión:''' id de la comisión|| De acuerdo a los datos recibidos, devuelve el último número de acta + 1 || Clase: co_actas.php

Método: '''generar_nro_acta'''($parametros)

'''parámetros''' ''array()'':

'''origen''' ''string(1)'': E-Examen/R-Regulares/P-Promociones/Q-Equivalencias

'''tipo_acta''' ''string(1)'': N-Normal / R-Rectificativa

'''comision''' ''int'': id de la comisión 
 |-
 || Fecha de Fin de Vigencia de la Regularidad || 1. '''Comisión:''' id de la comisión <br><br> 2. '''Fecha fin período lectivo:''' Fecha de finalización del Período Lectivo <br><br> 3. '''Fecha de Regularidad:''' fecha de regularidad para el alumno || La fecha se calcula sumando los meses definidos en el parámetro [[SIU-Guarani/Version3.11.0/Configuracion_del_sistema/Parametros#Cursadas|cur_cant_meses_vigencia_regularidad]] a la fecha de fin de dictado del período lectivo de la comisión. || Clase: co_actas.php

Método: '''get_fin_vigencia_regularidad'''($comision, $fecha_fin, $fecha_regular)

Parámetros:
''int'': id de la comisión

''date'': fecha de fin del período lectivo de la comision

''date'': fecha de regularidad
 |-
 || Fecha de Fin de Vigencia de la Promoción || 1. '''Comisión:''' id de la comisión <br><br> 2. '''Fecha fin período lectivo:''' Fecha de finalización del Período Lectivo <br><br> 3. '''Fecha de Promoción:''' fecha de promoción para el alumno || NULL || Clase: co_actas.php

Método: '''get_fin_vigencia_promocion'''($comision, $fecha_fin, $fecha_promocion)

Parámetros:
''int'': id de la comisión

''date'': fecha de fin del período lectivo de la comision

''date'': fecha de promoción
|}

=== Exámenes ===
{| class="wikitable"
 |-
 ! '''Tema''' || '''Datos de Entrada''' || '''Resultado Default SIU''' || '''Clase PHP - Método''' 
 |-
 || '''Mesas''' || || ||
 |-
 || Generación del array de nombres de mesas || || Setea una variable de clase con el array de nombres. Cada institución puede personalizar estos nombres || Clase: mesa_de_examen.php

Método: '''set_nombres_default_mesas'''() 
 |-
 || Generación del nombre de la mesa || 1. Nro mesa de una Actividad a generar en un Turno de Examen || Devuelve el nombre de la mesa por default. Hay un array que contiene el nombre de unas 50 mesas ||Clase: mesa_de_examen.php

Método: '''get_nombre_default_mesa'''($nro_mesa)

Parámetros:
''int'': número de la mesa dentro de la actividad y turno de examen
 |-
 || '''Actas''' || || ||
 |-
 || Generacion de Libro para actas de Exámen || 1. '''Origen:''' E-Examen/R-Regulares/P-Promociones/Q-Equivalencias <br><br> 2. '''Tipo de Acta:''' N-Normal / R-Rectificativa <br><br> 3. '''Llamado:''' id de la mesa de examen en un llamado|| Devuelve el libro activo de examen  || Clase: co_actas.php

Método: '''get_libro_de_actas'''($parametros)

'''parámetros''' ''array()'':

'''origen''' ''string(1)'': E-Examen/R-Regulares/P-Promociones/Q-Equivalencias

'''tipo_acta''' ''string(1)'': N-Normal / R-Rectificativa

'''llamado_mesa''' ''int'': id de la mesa de examen en un llamado 
 |-
 || Generacion de Número de actas de Exámen|| 1. '''Origen:''' E-Examen/R-Regulares/P-Promociones/Q-Equivalencias <br><br> 2.''' Tipo de Acta:''' N-Normal / R-Rectificativa <br><br> 3. '''Libro de Actas:''' Id del Libro de Actas donde se guardará el examen <br><br> 4. '''Llamado:''' id de la mesa de examen en un llamado  || Devuelve incrementado en uno el mayor nro acta existente || Clase: co_actas.php

Método: '''generar_nro_acta'''($parametros)

'''parámetros''' ''array()'':

'''origen''' ''string(1)'': E-Examen/R-Regulares/P-Promociones/Q-Equivalencias

'''tipo_acta''' ''string(1)'': N-Normal / R-Rectificativa

'''libro''' ''int'': Id del Libro de Actas donde se guardará el examen.

'''llamado_mesa''' ''int'': id de la mesa de examen en un llamado

 |-
 || Fecha de Fin de Vigencia del Examen || 1. Id de la mesa en el llamado. <br><br> 2. Fecha del examen del alumno || NULL || ...get_fin_vigencia_examen (llamado_mesa integer, fecha date)
 |-
 || Generación del nombre de la Mesa || 1. Código de una Actividad a generar en un Turno / Llamado || Devuelve el nombre de la mesa por default. Hay un array que contiene el nombre de unas 50 mesas. Cada institución puede personalizar estos nombres. Por defecto devuelve la palabra "Mesa" + un numero correlativo. || 
|}

=== Equivalencias ===
{| class="wikitable"
 |-
 ! '''Tema''' || '''Datos de Entrada''' || '''Resultado Default SIU''' || '''Clase PHP - Método'''
 |-
 || Fin de vigencia de las equivalencias || 1. ID del Alumno <br><br> 2. Alcance de la Equivalencia: R - Equivalencia de Regularidad / P - Equivalencia Parcial / T - Equivalencia Total <br><br> 3. Una fecha que es la fecha en que se le otorgará la equivalencia || En el caso que se genere la fecha de fin de vigencia, la misma se genera a partir de la fecha de la equivalencias sumándole dos años, solo en el caso donde la equivalencia deberá tener fecha de fin de vigencia y el parámetro [[SIU-Guarani/Version3.11.0/Configuracion_del_sistema/Parametros#Equivalencias_Autom.C3.A1ticas|equiv_automatica_vencimiento_origen]] = N  || Función de la base de datos '''f_fin_vigencia_equivalencia''' 
 |-
 || Escala de notas de la equivalencia || 1. ID de Version de Plan de Estudios <br><br> 2. Actividad <br><br> 3. Alcance de la equivalencia (REGULARIDAD, PROMOCION, EXAMEN, EQUIVALENCIA_TOTAL, EQUIVALENCIA_REGULARIDAD, EQUIVALENCIA_PARCIAL) || Escala de notas según lo definido en el plan de estudios del alumno || Función de la base de datos: '''get_escala_nota''' 
 |-
 || Nota de la equivalencia || 1. Escalas de Notas Origen. Pueden pasarse una o mas escalas de notas <br><br> 2. Nota Origen. Puede pasarse una o mas nota. Debe coincidir en cantidad con el 1° parámetro <br><br> 3. Resultado Origen (A-aprobado / R - Desaprobado) que corresponde con el resultado de las notas del origen. <br><br> 4. Escala de Notas Destino <br><br> 5. Flag que indica si en al búsqueda de la nota destino se considera el resultado de la nota origen (Valores: false - No se considera el resultado, es decir que busca el % en peso de la nota origen en el conjunto total de notas de la escala destino; true - Si se considera el resultado, es decir que busca la nota solo en el conjunto de notas de la escala destino con el mismo resultado) <br><br> 6. Flag que indica si solo devuelve nota de la escala destino si encuentra una nota que coincida exactamente (Valores: false - Devuelve la nota aunque no coincida con el % de la/s nota/s origen; true - Solo devuelve nota en el caso que el % coincida con la/s nota/s origen) || Promedio de las notas de las actividades del origen del grupo de equivalencias. ||  Funcion de la base de datos: '''get_equiv_nota'''
|}

=== Egresados ===
{| class="wikitable"
 |-
 ! '''Tema''' || '''Datos de Entrada''' || '''Resultado Default SIU''' ||'''Clase PHP - Método''' 
 |-
 ||Detección de Egresados|| ||||
 |-
 ||Verificar Pago||Identificación del alumno||Devuelve '''S''' por defecto. En caso de que no pagó devolverá '''N'''||
|}

=== Firma Digital ===
{| class="wikitable"
 |-
 ! '''Tema''' || '''Datos de Entrada''' || '''Resultado Default SIU''' ||'''Clase PHP - Método''' 
 |-
 ||Determinar Originante del documento|| ||||Clase: personalizacion/php/nucleo/arai/arai_documentos.php

Método: '''get_cuenta_usuario_origen_arai_documentos'''($parametros)

'''parámetros''' ''array()'':
|}


[[SIU-Guarani/Version3.11.0/Configuracion_del_sistema| Volver]]