SIU - Contribuciones del usuario [es]

SIU-Guarani/version3.23.0/interfaces/arai-reportes

2026-03-10T16:26:25Z

Jschnaiderman: /* En SIU-Guaraní Gestión */

__NOTOC__
== Interfaz SIU-Guaraní - Araí-Reportes ==
Arai-Reportes es la plataforma de generación y publicación de reportes utilizada por el ecosistema SIU

Permite ejecutar y publicar reportes desacoplando su definición del sistema que los consume.
En esta sección se describe específicamente cómo integrar y utilizar Araí-Reportes desde SIU-Guaraní .

Para una introducción general a la herramienta y su arquitectura se recomienda consultar la [https://documentacion.siu.edu.ar/reportes/docs/intro/ documentación]

===En SIU-Guaraní Gestión===

1) Solicitar al administrador de '''Araí-Reportes''' usuario, contraseña y URLs para utilizar el servicio REST. Luego crear y configurar el archivo <tt><path proyecto Gestión>/instalacion/i__<instancia>/p__guarani/rest/rest_arai_reportes/cliente.ini</tt>
<source lang="ini" enclose="div">
;cliente.ini
[conexion]
to = "<url_api_arai_reportes>/v2/"
auth_tipo = basic o digest
auth_usuario = <usuario>
auth_password = <password>
</source>
Se debe reemplazar:
* <path proyecto Gestión>: por el path donde se encuentra instalado el proyecto '''SIU-Guaraní Gestión'''
* <instancia>: por el nombre de la instancia
* <url_api_arai_reportes>: por la URL de la API donde se encuentra '''Araí-Reportes'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Reportes'''
* <password>: Password otorgado por el administrador de '''Araí-Reportes'''

Para más información, consultar en la explicación de [https://documentacion.siu.edu.ar/toba/docs/referencia-rest/ REST de Toba]

2) Finalmente ejecutar el comando '''bin/instalador reportes:actualizar''' para subir los reportes e imágenes.

===En SIU-Guaraní Autogestión===
1) Solicitar al administrador de '''Araí-Reportes''' usuario, contraseña y URLs para utilizar el servicio REST.

2) También configurar el archivo <tt><path proyecto Autogestión>/instalacion/servicios_web_config.php</tt> (si no existe hacer una copia desde el archivo '''servicios_web_config_template.php''' ubicado en el mismo directorio)
<source lang="php" enclose="div">
'consumidos' => [

'arai_reportes' => [
'tipo' => 'rest',
'parametros' => [ //usa cliente Guzzle, son opciones en formato guzzle
'base_uri' => "<url_api_arai_reportes>/v2/",
'auth' => ['<usuario>', '<password>', <tipo-auth>), //user, password, según guzzle
]
],

]
</source>
Se debe reemplazar:
* <path proyecto Autogestión>: por el path donde se encuentra instalado el proyecto '''SIU-Guaraní Autogestión'''
* <url_api_arai_reportes>: por la URL de la API donde se encuentra '''Araí-Reportes'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Reportes'''
* <password>: Password otorgado por el administrador de '''Araí-Reportes'''
* <tipo-auth>: '''basic''' o '''digest'''. [http://docs.guzzlephp.org/en/stable/request-options.html#auth Ver documentación de Guzzle].

===Personalización de certificados y constancias===
Para agregar o personalizar certificados y constancias, se debe modificar el archivo dentro de la carpeta de gestión :

personalizacion/php/nucleo/arai/arai_reportes.php

Dentro de este archivo, la definición de los reportes se realiza en la función:

getReportes()

Estructura de un reporte

Cada certificado o constancia se define como un elemento del arreglo retornado por getReportes().
A continuación se muestra un ejemplo:
<source lang="php" enclose="div">

return [
1 => [
'id' => 'ConstanciaRegular.jrxml',
'titulo' => 'Constancia de Alumno Regular',
'clase_consulta' => 'co_constancias',
'metodo_consulta' => 'get_datos_constancia_regular'
],
];
</source>

Descripción de los campos

id
Nombre del archivo .jrxml que contiene el diseño del reporte (JasperReport).

titulo
Título descriptivo del certificado o constancia.
Este valor suele mostrarse en la interfaz de usuario.

clase_consulta
Clase PHP encargada de obtener los datos necesarios para el reporte.

metodo_consulta
Método de la clase indicada en clase_consulta que retorna la información utilizada para completar el certificado.

Consideraciones

Cada nuevo certificado o constancia debe agregarse como un nuevo índice dentro del arreglo.

El archivo .jrxml debe existir y coincidir exactamente con el valor definido en id.

El método de consulta debe devolver los datos en el formato esperado por el reporte.

SIU-Guarani/version3.23.0/interfaces/arai-reportes

2026-03-10T16:25:34Z

Jschnaiderman: /* Interfaz SIU-Guaraní - Araí-Reportes */

__NOTOC__
== Interfaz SIU-Guaraní - Araí-Reportes ==
Arai-Reportes es la plataforma de generación y publicación de reportes utilizada por el ecosistema SIU

Permite ejecutar y publicar reportes desacoplando su definición del sistema que los consume.
En esta sección se describe específicamente cómo integrar y utilizar Araí-Reportes desde SIU-Guaraní .

Para una introducción general a la herramienta y su arquitectura se recomienda consultar la [https://documentacion.siu.edu.ar/reportes/docs/intro/ documentación]

===En SIU-Guaraní Gestión===

1) Solicitar al administrador de '''Araí-Reportes''' usuario, contraseña y URLs para utilizar el servicio REST. Luego crear y configurar el archivo <tt><path proyecto Gestión>/instalacion/i__<instancia>/p__guarani/rest/rest_arai_reportes/cliente.ini</tt>
<source lang="ini" enclose="div">
;cliente.ini
[conexion]
to = "<url_api_arai_reportes>/v2/"
auth_tipo = basic o digest
auth_usuario = <usuario>
auth_password = <password>
</source>
Se debe reemplazar:
* <path proyecto Gestión>: por el path donde se encuentra instalado el proyecto '''SIU-Guaraní Gestión'''
* <instancia>: por el nombre de la instancia
* <url_api_arai_reportes>: por la URL de la API donde se encuentra '''Araí-Reportes'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Reportes'''
* <password>: Password otorgado por el administrador de '''Araí-Reportes'''

Para más información, consultar en la explicación de [https://toba.siu.edu.ar/trac/toba/wiki/Referencia/Rest REST de Toba]

2) Finalmente ejecutar el comando '''bin/instalador reportes:actualizar''' para subir los reportes e imágenes.

===En SIU-Guaraní Autogestión===
1) Solicitar al administrador de '''Araí-Reportes''' usuario, contraseña y URLs para utilizar el servicio REST.

2) También configurar el archivo <tt><path proyecto Autogestión>/instalacion/servicios_web_config.php</tt> (si no existe hacer una copia desde el archivo '''servicios_web_config_template.php''' ubicado en el mismo directorio)
<source lang="php" enclose="div">
'consumidos' => [

'arai_reportes' => [
'tipo' => 'rest',
'parametros' => [ //usa cliente Guzzle, son opciones en formato guzzle
'base_uri' => "<url_api_arai_reportes>/v2/",
'auth' => ['<usuario>', '<password>', <tipo-auth>), //user, password, según guzzle
]
],

]
</source>
Se debe reemplazar:
* <path proyecto Autogestión>: por el path donde se encuentra instalado el proyecto '''SIU-Guaraní Autogestión'''
* <url_api_arai_reportes>: por la URL de la API donde se encuentra '''Araí-Reportes'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Reportes'''
* <password>: Password otorgado por el administrador de '''Araí-Reportes'''
* <tipo-auth>: '''basic''' o '''digest'''. [http://docs.guzzlephp.org/en/stable/request-options.html#auth Ver documentación de Guzzle].

===Personalización de certificados y constancias===
Para agregar o personalizar certificados y constancias, se debe modificar el archivo dentro de la carpeta de gestión :

personalizacion/php/nucleo/arai/arai_reportes.php

Dentro de este archivo, la definición de los reportes se realiza en la función:

getReportes()

Estructura de un reporte

Cada certificado o constancia se define como un elemento del arreglo retornado por getReportes().
A continuación se muestra un ejemplo:
<source lang="php" enclose="div">

return [
1 => [
'id' => 'ConstanciaRegular.jrxml',
'titulo' => 'Constancia de Alumno Regular',
'clase_consulta' => 'co_constancias',
'metodo_consulta' => 'get_datos_constancia_regular'
],
];
</source>

Descripción de los campos

id
Nombre del archivo .jrxml que contiene el diseño del reporte (JasperReport).

titulo
Título descriptivo del certificado o constancia.
Este valor suele mostrarse en la interfaz de usuario.

clase_consulta
Clase PHP encargada de obtener los datos necesarios para el reporte.

metodo_consulta
Método de la clase indicada en clase_consulta que retorna la información utilizada para completar el certificado.

Consideraciones

Cada nuevo certificado o constancia debe agregarse como un nuevo índice dentro del arreglo.

El archivo .jrxml debe existir y coincidir exactamente con el valor definido en id.

El método de consulta debe devolver los datos en el formato esperado por el reporte.

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-26T18:53:32Z

Jschnaiderman: /* Diferencias con versiones anteriores */

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-26T16:25:33Z

Jschnaiderman: /* Diferencias con versiones anteriores */

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T15:55:26Z

Jschnaiderman: /* Registro de nuevos reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''NOTA: Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión '''3.23.0''', la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.

[https://documentacion.siu.edu.ar/reportes/ Documentación de Arai reportes]

[https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.23.0/interfaces/arai-reportes Documentación de configuración en SIU-Guaraní ]

Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
'''Gestion:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

'''3w Autogestión:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con '''Araí Reportes''' en '''3w Autogestión''' se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

'''En gestión no usamos el use '''

'''Verificación de habilitación del reporte'''
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

'''Recuperación de información del reporte'''
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

'''Asociación de la plantilla al reporte'''

'''Gestion:'''
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

''' 3w Autogestión:'''
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

'''Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente''':

:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método '''getReportes''' de la siguiente clase:

personalizacion/php/nucleo/arai/arai_reportes.php

== '''Convenciones utilizadas'''==
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T15:53:02Z

Jschnaiderman: /* Nuevo enfoque con Araí Reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''NOTA: Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión '''3.23.0''', la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.

[https://documentacion.siu.edu.ar/reportes/ Documentación de Arai reportes]

[https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.23.0/interfaces/arai-reportes Documentación de configuración en SIU-Guaraní ]

Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
'''Gestion:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

'''3w Autogestión:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con '''Araí Reportes''' en '''3w Autogestión''' se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

'''En gestión no usamos el use '''

'''Verificación de habilitación del reporte'''
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

'''Recuperación de información del reporte'''
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

'''Asociación de la plantilla al reporte'''

'''Gestion:'''
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

''' 3w Autogestión:'''
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

'''Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente''':

:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T15:52:45Z

Jschnaiderman: /* Nuevo enfoque con Araí Reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''NOTA: Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión '''3.23.0''', la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
[https://documentacion.siu.edu.ar/reportes/ Documentación de Arai reportes]
[https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.23.0/interfaces/arai-reportes Documentación de configuración en SIU-Guaraní ]
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
'''Gestion:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

'''3w Autogestión:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con '''Araí Reportes''' en '''3w Autogestión''' se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

'''En gestión no usamos el use '''

'''Verificación de habilitación del reporte'''
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

'''Recuperación de información del reporte'''
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

'''Asociación de la plantilla al reporte'''

'''Gestion:'''
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

''' 3w Autogestión:'''
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

'''Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente''':

:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T15:50:44Z

Jschnaiderman: /* Nuevo enfoque con Araí Reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''NOTA: Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión '''3.23.0''', la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
'''Gestion:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

'''3w Autogestión:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con '''Araí Reportes''' en '''3w Autogestión''' se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

'''En gestión no usamos el use '''

'''Verificación de habilitación del reporte'''
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

'''Recuperación de información del reporte'''
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

'''Asociación de la plantilla al reporte'''

'''Gestion:'''
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

''' 3w Autogestión:'''
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

'''Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente''':

:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T15:49:30Z

Jschnaiderman: /* Nuevo enfoque con Araí Reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''NOTA: Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión '''3.23.0''', la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
'''Gestion:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

'''3w Autogestión:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con '''Araí Reportes''' en '''3w Autogestión''' se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

'''En '''gestión''' no usamos el use '''

'''Verificación de habilitación del reporte
''':<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

'''Asociación de la plantilla al reporte'''

'''Gestion:'''
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

''' 3w Autogestión:'''
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

'''Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente''':

:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T15:48:38Z

Jschnaiderman: /* Nuevo enfoque con Araí Reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''NOTA: Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión '''3.23.0''', la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
'''Gestion:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

'''3w Autogestión:'''
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con '''Araí Reportes''' en '''3w Autogestión''' se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

'''En '''gestión''' no usamos el use '''

'''Verificación de habilitación del reporte
''':<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

'''Asociación de la plantilla al reporte'''

'''Gestion:'''
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

''' 3w Autogestión:'''
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:16:32Z

Jschnaiderman: /* Obtención de datos en los reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''NOTA: Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:15:24Z

Jschnaiderman: /* Obtención de datos en los reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

'''Uso de SQL embebido''' (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:14:29Z

Jschnaiderman: /* Obtención de datos en los reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.

Uso de SQL embebido (enfoque legacy)

En este enfoque, el archivo '''.jrxml''' incluye una consulta SQL directa a la base de datos de Guaraní.

La consulta se define en '''iReport''' configurando el Query Language como SQL.

'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.

SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:13:07Z

Jschnaiderman: /* Estructura de directorios */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/exportaciones/jasper</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<span style="color:#008000;"><path proyecto Guaraní>/personalizacion/reportes/nucleo/</span>

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:11:46Z

Jschnaiderman:

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:
*<span style="color:#008000;">
<path proyecto Guaraní>/personalizacion/exportaciones/jasper
</span>
Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<path proyecto Guaraní>/personalizacion/reportes/nucleo/

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:10:04Z

Jschnaiderman: /* Personalización de reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.'''jrxml'''</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:

<path proyecto Guaraní>/personalizacion/exportaciones/jasper

Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<path proyecto Guaraní>/personalizacion/reportes/nucleo/

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:09:40Z

Jschnaiderman: /* Personalización de reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión <span style="color:#008000;">.jrxml</span>

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:

<path proyecto Guaraní>/personalizacion/exportaciones/jasper

Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<path proyecto Guaraní>/personalizacion/reportes/nucleo/

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:07:33Z

Jschnaiderman: /* Personalización de reportes */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.

Las plantillas se editan mediante '''iReport''', generando archivos con extensión .jrxml

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:

<path proyecto Guaraní>/personalizacion/exportaciones/jasper

Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<path proyecto Guaraní>/personalizacion/reportes/nucleo/

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:06:54Z

Jschnaiderman: /* Cambios introducidos a partir de la versión 3.23.0 */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora '''Araí Reportes''' para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de '''JasperReports''' como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.
Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:

<path proyecto Guaraní>/personalizacion/exportaciones/jasper

Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<path proyecto Guaraní>/personalizacion/reportes/nucleo/

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:06:21Z

Jschnaiderman: /* Personalización de impresiones en SIU-Guaraní */

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.

A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora Araí Reportes para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de JasperReports como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.
Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:

<path proyecto Guaraní>/personalizacion/exportaciones/jasper

Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<path proyecto Guaraní>/personalizacion/reportes/nucleo/

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2026-01-26T14:04:29Z

Jschnaiderman:

== Personalización de impresiones en SIU-Guaraní ==

SIU-Guaraní realiza la impresión de comprobantes y reportes a partir de documentos en formato '''PDF'''.

Estos documentos se generan utilizando '''JasperReports''', un motor de generación de reportes basado en '''Java''', integrado y soportado por '''SIU-Toba'''.
A partir de la versión '''3.23.0''', se incorpora '''Araí Reportes''' como nuevo mecanismo de gestión y publicación de reportes, introduciendo cambios en la forma de personalizar impresiones que deben ser tenidos en cuenta.

'''[https://documentacion.siu.edu.ar/reportes Documentación de Araí reportes]'''

----

==Cambios introducidos a partir de la versión 3.23.0==

Desde la versión '''3.23.0''' de '''SIU-Guaraní''':

* Se incorpora Araí Reportes para la administración de reportes.

* Se modifica la forma de localizar y cargar plantillas personalizadas.

* Se elimina el uso de consultas SQL embebidas en los archivos .jrxml.

* La obtención de datos para los reportes se realiza desde código PHP.

* Se centraliza la publicación de reportes mediante un proceso de instalación.

Estos cambios no afectan el uso de JasperReports como motor de generación, pero sí el flujo de trabajo para la personalización.

----

== Personalización de reportes==
La personalización de una impresión en '''SIU-Guaraní''' depende del tipo de modificación requerida, aunque en la mayoría de los casos implica el desarrollo o adaptación de una plantilla Jasper.
Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml

== Convenciones de nombres==
* Para un comprobante nuevo, la plantilla tendrá un nombre propio.

* Para personalizar un comprobante existente, la plantilla deberá conservar el nombre por defecto.

Al momento de imprimir, el sistema verifica en primer lugar si existe una plantilla personalizada; en caso afirmativo, utiliza dicha versión. Si no existe, utiliza la plantilla estándar incluida en Guaraní.

----

==Estructura de directorios==
'''Versiones anteriores a 3.23.0'''
Las plantillas personalizadas se ubicaban en el siguiente directorio:

<path proyecto Guaraní>/personalizacion/exportaciones/jasper

Al momento de la versión 3.23.0 funcionan los dos, aunque este camino será descontinuado en futuras versiones.

Las plantillas se editan mediante iReport, generando archivos con extensión .jrxml, que luego deben compilarse para obtener los correspondientes archivos .jasper.

'''A partir de la versión 3.23.0'''
Las personalizaciones de reportes se organizan en el siguiente path:

<path proyecto Guaraní>/personalizacion/reportes/nucleo/

Dentro de este directorio se disponen las siguientes carpetas:
*imagenes
Destinada a agregar o reemplazar logos e imágenes utilizadas en los reportes.

*estilos
Contiene las hojas de estilo (CSS) utilizadas por las plantillas.

*jasper
Contiene las plantillas Jasper personalizadas (.jrxml).

----

== Obtención de datos en los reportes==
Históricamente, en SIU-Guaraní se utilizaron dos enfoques para la obtención de datos en las plantillas Jasper.
Uso de SQL embebido (enfoque legacy)
En este enfoque, el archivo .jrxml incluye una consulta SQL directa a la base de datos de Guaraní.
La consulta se define en iReport configurando el Query Language como SQL.
'''Este enfoque queda obsoleto a partir de la versión 3.23.0 y no debe utilizarse en nuevas personalizaciones.'''

'''Uso de XML versiones anteriores a 3.23.0 '''
En este enfoque, los datos se generan desde PHP y se envían a Jasper en formato XML.
SIU-Toba crea un archivo XML temporal en:
:<source lang="php" enclose="div">
<path proyecto Guaraní>/temp
</source>

El archivo se elimina automáticamente una vez generado el PDF.
En la plantilla .jrxml, el Query Language se define como XPath, indicando la ruta del contenido (por ejemplo /tabla/datos/fila).
Este enfoque se utiliza generalmente cuando los datos a imprimir ya se visualizan previamente en la interfaz del sistema (por ejemplo, actas de cursada o exámenes).

----

==Nuevo enfoque con Araí Reportes==
A partir de la versión 3.23.0, la obtención de datos para los reportes se realiza exclusivamente desde código PHP, eliminando las consultas embebidas en las plantillas.
Documentación de Arai reportes
Documentación de configuración en SIU-Guaraní
Ejemplo de recuperación de datos (anterior query embebida en el .jrxml):
Gestion:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

3w Autogestión:
:<source lang="php" enclose="div">

// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>

Implementación en PHP
Para trabajar con Araí Reportense 3w Autogestión se deben utilizar las siguientes clases:
:<source lang="php" enclose="div">

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;
</source>

En gestión no usamos el use

Verificación de habilitación del reporte
:<source lang="php" enclose="div">

$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
</source>

Recuperación de información del reporte
:<source lang="php" enclose="div">

$informacionReporte = arai_reportes::getInformacionReporteById($id);
</source>

Asociación de la plantilla al reporte
Gestion:
:<source lang="php" enclose="div">

$uri = toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);
$report->set_path_reporte($uri);
</source>

3w Autogestión:
:<source lang="php" enclose="div">

$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>

Cuando se pasa el JSON con los valores de la query, el reporte .jrxml debe tener lo siguiente:
:<source lang="php" enclose="div">

<queryString language="JSON">
<![CDATA[]]>
</queryString>
</source>

Cada columna de la query debe tener un "field", ej:
:<source lang="php" enclose="div">

<field name="apellido_y_nombre" class="java.lang.String"/>
</source>

Y se imprime así:
:<source lang="php" enclose="div">

<textField>
<reportElement style="Comun" x="7" y="118" width="472" height="72"/>
<textFieldExpression><![CDATA[$F{apellido_y_nombre}]]></textFieldExpression>
</textField>
</source>

==Uso de parámetros, imágenes y códigos QR==
Pasaje de parámetros a la plantilla
:<source lang="php" enclose="div">

$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);

</source>

Inclusión de logos
:<source lang="php" enclose="div">

$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

</source>

En el archivo .jrxml:
:<source lang="php" enclose="div">
<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
</source>

Imágenes en Base64 (por ejemplo, códigos QR)
:<source lang="php" enclose="div">
$base64_qr = base64_encode(file_get_contents($path_qr));
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);

</source>

En el .jrxml:

:<source lang="php" enclose="div">
<import value="java.util.Base64"/>
<imageExpression><![CDATA[
Base64.getDecoder().decode($P{verificacion_qr})
]]></imageExpression>

</source>

==Publicación de reportes en Araí Reportes==
Una vez agregadas o modificadas las plantillas, se debe ejecutar el siguiente comando:

bin/instalador reportes:actualizar

Este proceso elimina y vuelve a crear los reportes en Araí Reportes, actualizando las tablas:

* arai_reportes

* arai_reportes_archivos

==Registro de nuevos reportes==
Los reportes agregados deben registrarse en el método getReportes de la siguiente clase:
personalizacion/php/nucleo/arai/arai_reportes.php

Convenciones utilizadas
En este documento, <path proyecto Guaraní> refiere al directorio donde se encuentra instalada la aplicación SIU-Guaraní Gestión.

SIU-Guarani/version3.23.0/interfaces/arai-reportes

2026-01-09T13:51:52Z

Jschnaiderman:

__NOTOC__
== Interfaz SIU-Guaraní - Araí-Reportes ==

===En SIU-Guaraní Gestión===

1) Solicitar al administrador de '''Araí-Reportes''' usuario, contraseña y URLs para utilizar el servicio REST. Luego crear y configurar el archivo <tt><path proyecto Gestión>/instalacion/i__<instancia>/p__guarani/rest/rest_arai_reportes/cliente.ini</tt>
<source lang="ini" enclose="div">
;cliente.ini
[conexion]
to = "<url_api_arai_reportes>/v2/"
auth_tipo = basic o digest
auth_usuario = <usuario>
auth_password = <password>
</source>
Se debe reemplazar:
* <path proyecto Gestión>: por el path donde se encuentra instalado el proyecto '''SIU-Guaraní Gestión'''
* <instancia>: por el nombre de la instancia
* <url_api_arai_reportes>: por la URL de la API donde se encuentra '''Araí-Reportes'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Reportes'''
* <password>: Password otorgado por el administrador de '''Araí-Reportes'''

Para más información, consultar en la explicación de [https://toba.siu.edu.ar/trac/toba/wiki/Referencia/Rest REST de Toba]

2) Finalmente ejecutar el comando '''bin/instalador reportes:actualizar''' para subir los reportes e imágenes.

===En SIU-Guaraní Autogestión===
1) Solicitar al administrador de '''Araí-Reportes''' usuario, contraseña y URLs para utilizar el servicio REST.

2) También configurar el archivo <tt><path proyecto Autogestión>/instalacion/servicios_web_config.php</tt> (si no existe hacer una copia desde el archivo '''servicios_web_config_template.php''' ubicado en el mismo directorio)
<source lang="php" enclose="div">
'consumidos' => [

'arai_reportes' => [
'tipo' => 'rest',
'parametros' => [ //usa cliente Guzzle, son opciones en formato guzzle
'base_uri' => "<url_api_arai_reportes>/v2/",
'auth' => ['<usuario>', '<password>', <tipo-auth>), //user, password, según guzzle
]
],

]
</source>
Se debe reemplazar:
* <path proyecto Autogestión>: por el path donde se encuentra instalado el proyecto '''SIU-Guaraní Autogestión'''
* <url_api_arai_reportes>: por la URL de la API donde se encuentra '''Araí-Reportes'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Reportes'''
* <password>: Password otorgado por el administrador de '''Araí-Reportes'''
* <tipo-auth>: '''basic''' o '''digest'''. [http://docs.guzzlephp.org/en/stable/request-options.html#auth Ver documentación de Guzzle].

===Personalización de certificados y constancias===
Para agregar o personalizar certificados y constancias, se debe modificar el archivo dentro de la carpeta de gestión :

personalizacion/php/nucleo/arai/arai_reportes.php

Dentro de este archivo, la definición de los reportes se realiza en la función:

getReportes()

Estructura de un reporte

Cada certificado o constancia se define como un elemento del arreglo retornado por getReportes().
A continuación se muestra un ejemplo:
<source lang="php" enclose="div">

return [
1 => [
'id' => 'ConstanciaRegular.jrxml',
'titulo' => 'Constancia de Alumno Regular',
'clase_consulta' => 'co_constancias',
'metodo_consulta' => 'get_datos_constancia_regular'
],
];
</source>

Descripción de los campos

id
Nombre del archivo .jrxml que contiene el diseño del reporte (JasperReport).

titulo
Título descriptivo del certificado o constancia.
Este valor suele mostrarse en la interfaz de usuario.

clase_consulta
Clase PHP encargada de obtener los datos necesarios para el reporte.

metodo_consulta
Método de la clase indicada en clase_consulta que retorna la información utilizada para completar el certificado.

Consideraciones

Cada nuevo certificado o constancia debe agregarse como un nuevo índice dentro del arreglo.

El archivo .jrxml debe existir y coincidir exactamente con el valor definido en id.

El método de consulta debe devolver los datos en el formato esperado por el reporte.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2025-11-28T12:43:28Z

Jschnaiderman:

== Personalizar impresiones ==
Guaraní realiza la impresión de comprobantes y reportes a partir de documentos PDF. Estos son creados utilizando '''[[SIU-Guarani/Version3.22.0/jasper|JASPER]]''', un motor de generación de reportes basado en '''JAVA''' soportado por '''SIU-Toba'''.<br><br>

A partir de la versión 3.23.0 Empezamos a cambiar la forma de crearlos empezamos a usar Araí Reportes.
Esto conlleva algunos cambios a tener en cuenta al momento de personalizar

<br><br>
La personalización de cualquier impresión en Guaraní dependerá de lo que se quiera personalizar, aunque comúnmente comprende desarrollar una plantilla JASPER para la impresión del formato deseado. Para ésto se utiliza '''iReports''' para la edición de las mismas, en archivos .jrxml, que luego se compilan generando sus correspondientes archivos .jasper<br>
En términos generales, tanto agregar como modificar una plantilla existente, implicará que se agreguen los archivos .jrxml y .jasper propios correspondientes a la misma, en el path: <tt><path proyecto Guaraní>/personalizacion/exportaciones/jasper</tt>.
'''A partir de la versión 3.23.0 Empezamos a cambia;'''
<tt><path proyecto Guaraní>/personalizacion/reportes/nucleo/</tt>.
Donde tendrán tres carpetas para imagenes, estilo y jasper
En la carpeta imagenes es para reemplazar o agregar logos o imagenes adiciones.
En la carpeta estilo es para los css.
En la carpeta jasper es para reemplazar o agregar plantillas de jasper jrxml

Si se trata de un comprobante nuevo tendrá su nombre propio, en caso de estar personalizando uno existente, tendrá el mismo nombre que el provisto por Guaraní. De esta forma, el sistema al intentar levantar el archivo asociado al comprobante que se desea imprimir, verifica en primera instancia si existe un archivo con ese nombre en la carpeta indicada de personalizaciones, con lo cual se imprimirá la versión propia. En otro caso, utilizará la plantilla asociada en Guaraní para la impresión.
<br><br>
Dentro de todas las impresiones que se realizan en Jasper en el sistema: Constancias de solicitud manual, Certificados de Egreso, Actas, Reportes, etc, en Guaraní se utilizaron dos tipos de .jrxml diferentes, en cuanto a la forma en que se envían y recuperan los datos a mostrar:

* '''Lenguaje Sql''':
*: En esta alternativa, en el archivo .jrxml se realiza una consulta sql a la base de datos de negocios de Guaraní para obtener los datos a mostrar en el reporte o constancia, a partir de los parámetros recibidos. Editando el jrxml desde el iReports, en la Report Query se define el query language como Sql y se especifica la consulta con los campos que se desean recuperar.
'''A partir de la versión 3.23.0 Empezamos a cambia;'''
ya no usaremos querys Para recuperar datos del reporte, lo que antes era la query embebida en el mismo:
<source lang="php" enclose="div">
// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>
* '''Lenguaje Xml''':
*: En este caso, además de los parámetros básicos que se envían, se pasan los datos desde el código PHP a Jasper en formato xml, para lo cual Toba crea un archivo temporal (en <tt><path proyecto Guaraní>/temp</tt>), que se elimina una vez generado el pdf. En la Report Query, se define el query language como ''XPath'' y se especifica dónde se ubicará el contenido ('/tabla/datos/fila'). Esto permite definir los diferentes campos a utilizar para mostrar en el contenido de la plantilla, con valores como por ej: para el campo: ''id_clave'', valor: ''dato[@clave="id_clave"]/@valor''. <br> Esta alternativa se utiliza generalmente cuando en la operación del sistema desde la cual se realiza la impresión, se previsualizan en pantalla los mismos datos que desean mostrarse en el pdf. Por ejemplo, para el caso de un reporte básico, o en Actas, tanto de Exámenes como Cursadas, donde en la operación se visualiza el cuadro de Alumnos con sus datos asociados.
<br>
Dentro del código de la clase PHP en la cual se implementa la impresión (asociada al componente Toba que define el evento), se encontrará el método: ''vista_jasperreports'', dónde se codifican los detalles de la misma. En dicho método se incluirá la asociación con la plantilla .jrmxl correspondiente, a partir de las sentencias: <br>
<source lang="php" enclose="div">
$path = guarani::get_path_reporte_jasper('plantilla.jasper');
$report->set_path_reporte($path);
</source>

'''A partir de la versión 3.23.0 Empezamos a cambia;'''
<source lang="php" enclose="div">
Para recuperar URI del reporte:

// Recupero la URI del reporte
$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>
(Observar que en el método get_path_reporte_jasper de la clase ''guarani_nucleo.php'' es dónde se define el mecanismo de buscar primero el archivo .jrmxl en la carpeta de personalizaciones, o tomar la plantilla brindada por Guaraní, en caso de no existir la propia.)
<br><br>
Aquí también se realizará el pasaje de parámetros a la plantilla con sentencias del estilo: <br>
<source lang="php" enclose="div">
$report->set_parametros($params); dónde $params es un arreglo asociativo
</source>
Y, para el caso de la segunda alternativa, también se encontrarán las sentencias donde se asocia el xml correspondiente, por ejemplo:
<source lang="php" enclose="div">
$xml = $this->dep('cuadro')->vista_xml(); //Se genera un xml a partir de los datos del cuadro
$report->set_xml(utf8_e_seguro($xml));
</source>

A partir de la versión 3.23.0 cambia;
Hacer uso de la clase arai_reportes y toba_vista_araireportes :

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;

Para saber si un reporte esta habilitado en Araí Reportes:

// Me fijo si esta habilitado para Araí Reportes
$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
Para recuperar información de un reporte:

// Recupero información del reporte
$informacionReporte = arai_reportes::getInformacionReporteById($id);
Setear parámetros, como por ejemplo logo y titulo:

// Recupero la URI del logo
$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

// Seteo el título del reporte
$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);
Luego el logo se puede mostrar de la siguiente manera en el .jrxml:

<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
Pasar imágenes en BASE64, ej QR:

// Genero el base64 del QR a partir de la imagen
$base64_qr = base64_encode(file_get_contents($path_qr));
// Elimino la imagen del QR
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);
Luego el QR se puede mostrar de la siguiente manera en el .jrxml:

<import value="java.util.Base64"/>

<imageExpression><![CDATA[Base64.getDecoder().decode($P{verificacion_qr})]]></imageExpression>

Se utilizará <path proyecto Guaraní> para referirse al path donde se encuentra instalado el SIU-Guaraní Gestión.

Luego ejecutar el comando bin/instalador reportes:actualizar para que se suban a Araí-Reportes (se elimina todo y se vuelve a crear en Araí-Reportes). También se guardan en la tabla arai_reportes y arai_reportes_archivos .

Los reportes agregados también se deben registrar en la función getReportes de la clase php/nucleo/arai/arai_reportes_nucleo.php.

SIU-Guarani/Version3.22.0/Novedades tecnicas

2025-10-01T16:13:49Z

Jschnaiderman:

__NOTOC__
__NOTOC__
= Principales novedades técnicas =


<p style="clear: both;"></p>
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''06/03/2025'''</p>
</div>
<p style="clear: both;"></p>
=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.22.1&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.22.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.22.0&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.22.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.3&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.21.3]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.2&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.21.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.21.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.2 Con versión 3.19.1]

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2024'''</p>
</div>
<p style="clear: both;"></p>
=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.22.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.22.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.3&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.3]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.2&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.19.0]

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''08/07/2024'''</p>
</div>
<p style="clear: both;"></p>

<br>
'''Importante:''' al momento de actualizar es posible hacerlo salteando versiones, no es necesario pasar por versiones intermedias. Sin embargo hay cuestiones técnicas que son necesarias para asegurar el correcto funcionamiento de la versión. Por favor lean las novedades técnicas de todas las versiones intermedias antes de comenzar el proceso.

== Base de Datos ==
[https://colab.siu.edu.ar/modelo/032200/html_v3.22.0.html Modelo 3.22.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.3&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.3]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.2&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Actualización versiones de [https://expedientes.siu.edu.ar/docs/guarani EEI].
** Se debe utilizar '''SIU-Araí Documentos''' a una versión mayor o igual a 1.3.0. [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-par%C3%A1metros-para-ara%C3%AD-documentos-en-siu-guaran%C3%AD Ver documentación aquí].
** Se debe utilizar '''Composer''' versión 2. [[SIU-Guarani/Version3.22.0/instalacion_desde_cero/requisitos_previos/linux | Ver documentación aquí]].

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<div style="background-color: #fcf8e3; color: #c09853; padding: 1em; margin: 1em 0px; border: 1px solid #fbeed5; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;"><strong>¡Nueva versión de API v2.1!</strong> (No rompe compatibilidad hacia atrás). [https://documentacion.siu.edu.ar/apis/?spec=guarani_v2 Ver Referencia de API para Guaraní (v2.1)]</div>

* Se agregan los siguiente Web Services para mejorar la interoperabilidad con SIU Sanavirón Quilmes:
** '''GET /licencias-estudiantiles''': Devuelve una lista de Licencias Estudiantiles.
** '''GET /alumnos-no-regulares''': Devuelve una lista de alumnos no regulares en un período de tiempo con fecha de perdida de regularidad y readmisión.
** '''GET /alumnos-pasivos''': Devuelve una lista de alumnos pasivos en un período de tiempo con historial de cambios de calidad.
** '''GET /alumnos-cambios-calidades''': Devuelve una lista de alumnos con cambios de calidades en un período de tiempo.

* Se agregan y modifican los siguiente Web Services para mejorar la interoperabilidad con SIU Tehuelche:
** '''POST /reaperturas-convocatorias''': Recibe reaperturas a convocatorias a becas emitidas por Tehuelche.
** '''GET /convocatorias/{id_convocatoria}/definicion''': Se agrega '''Documentación requerida''' para el relevamiento.
** '''GET /convocatorias/{id_convocatoria}/aspirantes''': Se agrega '''Documentación requerida''' para el relevamiento, datos modificados por reapertura. Ademas de los filtros '''cuil''' y '''con_reaperturas'''.

<div style="background-color: #fcf8e3; color: #c09853; padding: 1em; margin: 1em 0px; border: 1px solid #fbeed5; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;">Recrear el archivo <strong>instalacion/i__desarrollo/p__guarani/rest/recursos_usuarios.php</strong> a partir del template <strong>php/rest/recursos_usuarios_template.php</strong>, [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#Configuraci.C3.B3n_de_Usuarios_y_Perfil_Funcional | Ver documentación aquí]].</div>

== Gestión ==
* Se incorporó el parámetro [[SIU-Guarani/Version3.22.0/configuracion_del_sistema/parametros#Generales | nombre_persona_doc_oficiales]] que define con qué nombre deberán aparecer las personas en los documentos oficiales.

<div style="background-color: #fcf8e3; color: #c09853; padding: 1em; margin: 1em 0px; border: 1px solid #fbeed5; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;">La incorporación hizo que se modificaran las plantillas de jaspers, por lo cual si había personalizaciones en las mismas debemos volver a adaptar esas personalizaciones a este nuevo cambio.</div>

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.6.0/CHANGELOG.md v2.6.0].

* Se incorporó la opción '''--no-interactivo''' al comando '''bin/guarani importar_fotos''', pasando dicha opción se puede ejecutar con un cron, ej:

<div style="background-color: #d9edf7; color: #3a87ad; padding: 1em; margin: 1em 0px; border: 1px solid #bce8f1; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;">$ bin/guarani importar_fotos des01 --no-interactivo
</div>

</div></div>

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2025-06-02T14:16:12Z

Jschnaiderman:

== Personalizar impresiones ==
Guaraní realiza la impresión de comprobantes y reportes a partir de documentos PDF. Estos son creados utilizando '''[[SIU-Guarani/Version3.22.0/jasper|JASPER]]''', un motor de generación de reportes basado en '''JAVA''' soportado por '''SIU-Toba'''.<br><br>
A partir de la versión 3.23.0 Empezamos a cambiar la forma de crearlos empezamos a usar Araí Reportes.
Esto conlleva algunos cambios a tener en cuenta al momento de personalizar

<br><br>
La personalización de cualquier impresión en Guaraní dependerá de lo que se quiera personalizar, aunque comúnmente comprende desarrollar una plantilla JASPER para la impresión del formato deseado. Para ésto se utiliza '''iReports''' para la edición de las mismas, en archivos .jrxml, que luego se compilan generando sus correspondientes archivos .jasper<br>
En términos generales, tanto agregar como modificar una plantilla existente, implicará que se agreguen los archivos .jrxml y .jasper propios correspondientes a la misma, en el path: <tt><path proyecto Guaraní>/personalizacion/exportaciones/jasper</tt>.
'''A partir de la versión 3.23.0 Empezamos a cambia;'''
<tt><path proyecto Guaraní>/personalizacion/reportes/nucleo/</tt>.
Donde tendrán tres carpetas para imagenes, estilo y jasper
En la carpeta imagenes es para reemplazar o agregar logos o imagenes adiciones.
En la carpeta estilo es para los css.
En la carpeta jasper es para reemplazar o agregar plantillas de jasper jrxml

Si se trata de un comprobante nuevo tendrá su nombre propio, en caso de estar personalizando uno existente, tendrá el mismo nombre que el provisto por Guaraní. De esta forma, el sistema al intentar levantar el archivo asociado al comprobante que se desea imprimir, verifica en primera instancia si existe un archivo con ese nombre en la carpeta indicada de personalizaciones, con lo cual se imprimirá la versión propia. En otro caso, utilizará la plantilla asociada en Guaraní para la impresión.
<br><br>
Dentro de todas las impresiones que se realizan en Jasper en el sistema: Constancias de solicitud manual, Certificados de Egreso, Actas, Reportes, etc, en Guaraní se utilizaron dos tipos de .jrxml diferentes, en cuanto a la forma en que se envían y recuperan los datos a mostrar:

* '''Lenguaje Sql''':
*: En esta alternativa, en el archivo .jrxml se realiza una consulta sql a la base de datos de negocios de Guaraní para obtener los datos a mostrar en el reporte o constancia, a partir de los parámetros recibidos. Editando el jrxml desde el iReports, en la Report Query se define el query language como Sql y se especifica la consulta con los campos que se desean recuperar.
'''A partir de la versión 3.23.0 Empezamos a cambia;'''
ya no usaremos querys Para recuperar datos del reporte, lo que antes era la query embebida en el mismo:
<source lang="php" enclose="div">
// Recupero datos para el detalle del reporte si corresponde
if (isset($informacionReporte['clase_consulta']) && isset($informacionReporte['metodo_consulta'])) {
$clase_consulta = $informacionReporte['clase_consulta'];
$metodo_consulta = $informacionReporte['metodo_consulta'];
$datos = \toba::consulta_php($clase_consulta)->$metodo_consulta($solicitud);

// Seteo datos para el reporte
$report->set_json(rest_encode($datos));
}
</source>
* '''Lenguaje Xml''':
*: En este caso, además de los parámetros básicos que se envían, se pasan los datos desde el código PHP a Jasper en formato xml, para lo cual Toba crea un archivo temporal (en <tt><path proyecto Guaraní>/temp</tt>), que se elimina una vez generado el pdf. En la Report Query, se define el query language como ''XPath'' y se especifica dónde se ubicará el contenido ('/tabla/datos/fila'). Esto permite definir los diferentes campos a utilizar para mostrar en el contenido de la plantilla, con valores como por ej: para el campo: ''id_clave'', valor: ''dato[@clave="id_clave"]/@valor''. <br> Esta alternativa se utiliza generalmente cuando en la operación del sistema desde la cual se realiza la impresión, se previsualizan en pantalla los mismos datos que desean mostrarse en el pdf. Por ejemplo, para el caso de un reporte básico, o en Actas, tanto de Exámenes como Cursadas, donde en la operación se visualiza el cuadro de Alumnos con sus datos asociados.
<br>
Dentro del código de la clase PHP en la cual se implementa la impresión (asociada al componente Toba que define el evento), se encontrará el método: ''vista_jasperreports'', dónde se codifican los detalles de la misma. En dicho método se incluirá la asociación con la plantilla .jrmxl correspondiente, a partir de las sentencias: <br>
<source lang="php" enclose="div">
$path = guarani::get_path_reporte_jasper('plantilla.jasper');
$report->set_path_reporte($path);
</source>

'''A partir de la versión 3.23.0 Empezamos a cambia;'''
<source lang="php" enclose="div">
Para recuperar URI del reporte:

// Recupero la URI del reporte
$uri = \toba::consulta_php('co_arai_reportes')->get_uri_reporte($informacionReporte['id']);

// Se debe instanciar toba_vista_araireportes
$report = new toba_vista_araireportes();
$report->set_path_reporte($uri);
</source>
(Observar que en el método get_path_reporte_jasper de la clase ''guarani_nucleo.php'' es dónde se define el mecanismo de buscar primero el archivo .jrmxl en la carpeta de personalizaciones, o tomar la plantilla brindada por Guaraní, en caso de no existir la propia.)
<br><br>
Aquí también se realizará el pasaje de parámetros a la plantilla con sentencias del estilo: <br>
<source lang="php" enclose="div">
$report->set_parametros($params); dónde $params es un arreglo asociativo
</source>
Y, para el caso de la segunda alternativa, también se encontrarán las sentencias donde se asocia el xml correspondiente, por ejemplo:
<source lang="php" enclose="div">
$xml = $this->dep('cuadro')->vista_xml(); //Se genera un xml a partir de los datos del cuadro
$report->set_xml(utf8_e_seguro($xml));
</source>

A partir de la versión 3.23.0 cambia;
Hacer uso de la clase arai_reportes y toba_vista_araireportes :

use siu\modelo_g3\arai_reportes;
use siu\modelo_g3\toba_vista_araireportes;

Para saber si un reporte esta habilitado en Araí Reportes:

// Me fijo si esta habilitado para Araí Reportes
$reporteHabilitado = arai_reportes::esReporteHabilitado($id);
Para recuperar información de un reporte:

// Recupero información del reporte
$informacionReporte = arai_reportes::getInformacionReporteById($id);
Setear parámetros, como por ejemplo logo y titulo:

// Recupero la URI del logo
$uri_img = arai_reportes::getUriLogoImpresion();
$report->set_parametro('uri_logo', 'S', $uri_img);

// Seteo el título del reporte
$report->set_parametro('titulo', 'S', $informacionReporte['titulo']);
Luego el logo se puede mostrar de la siguiente manera en el .jrxml:

<imageExpression><![CDATA["repo:" + $P{uri_logo}]]></imageExpression>
Pasar imágenes en BASE64, ej QR:

// Genero el base64 del QR a partir de la imagen
$base64_qr = base64_encode(file_get_contents($path_qr));
// Elimino la imagen del QR
unlink($path_qr);
$report->set_parametro('verificacion_qr', 'S', $base64_qr);
Luego el QR se puede mostrar de la siguiente manera en el .jrxml:

<import value="java.util.Base64"/>

<imageExpression><![CDATA[Base64.getDecoder().decode($P{verificacion_qr})]]></imageExpression>

Se utilizará <path proyecto Guaraní> para referirse al path donde se encuentra instalado el SIU-Guaraní Gestión.

SIU-Guarani/Version3.23.0/personalizaciones/impresiones nuevo esquema

2025-03-20T22:24:02Z

Jschnaiderman: Página creada con «<!--== Personalizar impresiones == Guaraní realiza la impresión de comprobantes y reportes a partir de documentos PDF. Estos son creados utilizando '''SIU-Guarani/Versi...»

SIU-Guarani/preinscripcion3.22.0/actualizacion

2025-03-06T12:56:41Z

Jschnaiderman:

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>

== Actualización desde versión 3.11.0 ==

Si se dispone de una instalación en producción de la versión 3.11.0 de Preinscripción y se desea actualizar a 3.22.0, recomendamos seguir los siguientes pasos:

=== Copia de personalizaciones ===

Si se han desarrollado personalizaciones en la versión 3.11.0, seguir los siguientes pasos en un '''servidor de desarrollo''':

'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.11.0, todas las personalizaciones

Realizar una copia de las personalizaciones anteriores a la nueva versión.
<source lang="bash" enclose="div">
svn cp
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.11.0/src/pers/nombre_carpeta_pers
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.22.0/src/pers/nombre_carpeta_pers
-m "Personalizaciones Preinscripción 3.22.0 <institución>: se copian las personalizaciones de la versión 3.11.0"
</source>
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.

=== Instalación de desarrollo ===
Realizar una [[SIU-Guarani/preinscripcion3.22.0/instalacion_desde_cero/instalacion|instalación desde cero]] de desarrollo de la versión 3.22.0 para probar la compatibilidad de personalizaciones.

=== Versión de cuatro dígitos ===
Una vez testeada la instalación del paso anterior, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.22.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.

<source lang="bash" enclose="div">
svn cp
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.22.0
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.22.0.x
-m "<siglas institución> Creación de la version 3.22.0.x de Preinscripción"
</source>

=== Instalación en producción ===

Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:

#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.
#Realizar un backup de la base de datos de producción.
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:
#:<source lang="bash" enclose="div">
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.22.0.1
</source>
#Sobre la base de producción, correr el script '''mig_3.21.0_a_3.22.0.sql''', distribuido con la versión en la carpeta '''BD/conversion'''.
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' y completarlo, usando como referencia el archivo guardado en el paso 1, y definiendo las nuevas configuraciones de la presente versión.
#Actualizar las dependencias del proyecto.
#:Dentro de la carpeta raíz del proyecto correr el comando:
#:<source lang="php" enclose="div">
composer install --prefer-dist --no-dev --optimize-autoloader
</source>
#:Para mas información ver en la [https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies Documentación de Composer].
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.22.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.

[[SIU-Guarani/preinscripcion3.22.0/documentacion_tecnica|< Volver]]

SIU-Guarani/preinscripcion3.23.0/actualizacion

2025-03-06T12:56:41Z

Jschnaiderman:

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>

== Actualización desde versión 3.11.0 ==

Si se dispone de una instalación en producción de la versión 3.11.0 de Preinscripción y se desea actualizar a 3.23.0, recomendamos seguir los siguientes pasos:

=== Copia de personalizaciones ===

Si se han desarrollado personalizaciones en la versión 3.11.0, seguir los siguientes pasos en un '''servidor de desarrollo''':

'''PRECONDICIÓN''': Tener versionadas en el repositorio SVN, en la rama de la versión 3.11.0, todas las personalizaciones

Realizar una copia de las personalizaciones anteriores a la nueva versión.
<source lang="bash" enclose="div">
svn cp
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.11.0/src/pers/nombre_carpeta_pers
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.23.0/src/pers/nombre_carpeta_pers
-m "Personalizaciones Preinscripción 3.23.0 <institución>: se copian las personalizaciones de la versión 3.11.0"
</source>
Con esta acción se realiza la copia de las personalizaciones anteriores directamente en el repositorio y se mantiene la historia de las mismas.

=== Instalación de desarrollo ===
Realizar una [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/instalacion|instalación desde cero]] de desarrollo de la versión 3.23.0 para probar la compatibilidad de personalizaciones.

=== Versión de cuatro dígitos ===
Una vez testeada la instalación del paso anterior, siguiendo el mismo esquema de versionado propuesto para los otros módulos del sistema, se recomienda generar una [[SIU-Guarani/preinscripcion3.23.0/crear_version_propia|versión propia de cuatro dígitos]], inalterable, para publicar en producción.

<source lang="bash" enclose="div">
svn cp
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/trunk/3.23.0
https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.23.0.x
-m "<siglas institución> Creación de la version 3.23.0.x de Preinscripción"
</source>

=== Instalación en producción ===

Disponiendo de la versión de cuatro dígitos, seguir los siguientes pasos:

#Mover el archivo '''config.php''' de la versión actual a una carpeta externa, para tener como referencia.
#Realizar un backup de la base de datos de producción.
#Realizar un ''svn switch'' de la ''working copy''. Ejemplo:
#:<source lang="bash" enclose="div">
svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/sigla_institucion/preinscripcion/versiones/3.23.0.1
</source>
#Sobre la base de producción, correr el script '''mig_3.21.0_a_3.23.0.sql''', distribuido con la versión en la carpeta '''BD/conversion'''.
#Crear, a partir del archivo '''config_template.php''' el '''config.php''' y completarlo, usando como referencia el archivo guardado en el paso 1, y definiendo las nuevas configuraciones de la presente versión.
#Actualizar las dependencias del proyecto.
#:Dentro de la carpeta raíz del proyecto correr el comando:
#:<source lang="php" enclose="div">
composer install --prefer-dist --no-dev --optimize-autoloader
</source>
#:Para mas información ver en la [https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies Documentación de Composer].
#Seguir los pasos finales de [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/instalacion#Puesta_en_producci.C3.B3n|puesta en producción]] de la documentación de instalación desde cero.

[[SIU-Guarani/preinscripcion3.23.0/documentacion_tecnica|< Volver]]

SIU-Guarani/Version3.22.0/Novedades tecnicas preinscripcion

2025-03-06T12:35:36Z

Jschnaiderman:

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/preinscripcion3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''08/07/2024'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* Se elimina el campo '''usuario''' de la tabla '''sga_preinscripcion''', se deja solamente el campo '''e_mail'''

SIU-Guarani/Version3.22.0/Novedades tecnicas

2025-03-05T16:33:00Z

Jschnaiderman:

__NOTOC__
__NOTOC__
= Principales novedades técnicas =


<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2024'''</p>
</div>
<p style="clear: both;"></p>
=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.22.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.22.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.3&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.3]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.2&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.22.1 Con versión 3.19.0]

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''08/07/2024'''</p>
</div>
<p style="clear: both;"></p>

<br>
'''Importante:''' al momento de actualizar es posible hacerlo salteando versiones, no es necesario pasar por versiones intermedias. Sin embargo hay cuestiones técnicas que son necesarias para asegurar el correcto funcionamiento de la versión. Por favor lean las novedades técnicas de todas las versiones intermedias antes de comenzar el proceso.

== Base de Datos ==
[https://colab.siu.edu.ar/modelo/032200/html_v3.22.0.html Modelo 3.22.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.3&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.3]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.2&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Actualización versiones de [https://expedientes.siu.edu.ar/docs/guarani EEI].
** Se debe utilizar '''SIU-Araí Documentos''' a una versión mayor o igual a 1.3.0. [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-par%C3%A1metros-para-ara%C3%AD-documentos-en-siu-guaran%C3%AD Ver documentación aquí].
** Se debe utilizar '''Composer''' versión 2. [[SIU-Guarani/Version3.22.0/instalacion_desde_cero/requisitos_previos/linux | Ver documentación aquí]].

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<div style="background-color: #fcf8e3; color: #c09853; padding: 1em; margin: 1em 0px; border: 1px solid #fbeed5; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;"><strong>¡Nueva versión de API v2.1!</strong> (No rompe compatibilidad hacia atrás). [https://documentacion.siu.edu.ar/apis/?spec=guarani_v2 Ver Referencia de API para Guaraní (v2.1)]</div>

* Se agregan los siguiente Web Services para mejorar la interoperabilidad con SIU Sanavirón Quilmes:
** '''GET /licencias-estudiantiles''': Devuelve una lista de Licencias Estudiantiles.
** '''GET /alumnos-no-regulares''': Devuelve una lista de alumnos no regulares en un período de tiempo con fecha de perdida de regularidad y readmisión.
** '''GET /alumnos-pasivos''': Devuelve una lista de alumnos pasivos en un período de tiempo con historial de cambios de calidad.
** '''GET /alumnos-cambios-calidades''': Devuelve una lista de alumnos con cambios de calidades en un período de tiempo.

* Se agregan y modifican los siguiente Web Services para mejorar la interoperabilidad con SIU Tehuelche:
** '''POST /reaperturas-convocatorias''': Recibe reaperturas a convocatorias a becas emitidas por Tehuelche.
** '''GET /convocatorias/{id_convocatoria}/definicion''': Se agrega '''Documentación requerida''' para el relevamiento.
** '''GET /convocatorias/{id_convocatoria}/aspirantes''': Se agrega '''Documentación requerida''' para el relevamiento, datos modificados por reapertura. Ademas de los filtros '''cuil''' y '''con_reaperturas'''.

<div style="background-color: #fcf8e3; color: #c09853; padding: 1em; margin: 1em 0px; border: 1px solid #fbeed5; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;">Recrear el archivo <strong>instalacion/i__desarrollo/p__guarani/rest/recursos_usuarios.php</strong> a partir del template <strong>php/rest/recursos_usuarios_template.php</strong>, [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#Configuraci.C3.B3n_de_Usuarios_y_Perfil_Funcional | Ver documentación aquí]].</div>

== Gestión ==
* Se incorporó el parámetro [[SIU-Guarani/Version3.22.0/configuracion_del_sistema/parametros#Generales | nombre_persona_doc_oficiales]] que define con qué nombre deberán aparecer las personas en los documentos oficiales.

<div style="background-color: #fcf8e3; color: #c09853; padding: 1em; margin: 1em 0px; border: 1px solid #fbeed5; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;">La incorporación hizo que se modificaran las plantillas de jaspers, por lo cual si había personalizaciones en las mismas debemos volver a adaptar esas personalizaciones a este nuevo cambio.</div>

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.6.0/CHANGELOG.md v2.6.0].

* Se incorporó la opción '''--no-interactivo''' al comando '''bin/guarani importar_fotos''', pasando dicha opción se puede ejecutar con un cron, ej:

<div style="background-color: #d9edf7; color: #3a87ad; padding: 1em; margin: 1em 0px; border: 1px solid #bce8f1; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; display: inline-block;">$ bin/guarani importar_fotos des01 --no-interactivo
</div>

</div></div>

SIU-Guarani/Version3.22.0/Novedades tecnicas

2024-05-13T18:15:57Z

Jschnaiderman: /* Gestión */

__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''dd/mm/2024'''</p>
</div>
<p style="clear: both;"></p>

<br>
'''Importante:''' al momento de actualizar es posible hacerlo salteando versiones, no es necesario pasar por versiones intermedias. Sin embargo hay cuestiones técnicas que son necesarias para asegurar el correcto funcionamiento de la versión. Por favor lean las novedades técnicas de todas las versiones intermedias antes de comenzar el proceso.

== Base de Datos ==
[https://colab.siu.edu.ar/modelo/032200/html_v3.22.0.html Modelo 3.22.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.18.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Actualización versiones de [https://expedientes.siu.edu.ar/docs/guarani/ EEI].
** Se debe utilizar '''SIU-Araí Documentos''' a una versión mayor o igual a 1.3.0. [https://expedientes.siu.edu.ar/docs/guarani/#configurar-los-par%C3%A1metros-para-ara%C3%AD-documentos-en-siu-guaran%C3%AD Ver documentación aquí].

* SIU-Guaraní es compatible con '''Moodle 4'''.
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/moodle|Ver documentación aquí]].</dd>

* Se debe utilizar '''yui-compressor''' 2.4.8 o superior.
<dd>Para más información [[SIU-Guarani/version3.22.0/instalacion_desde_cero/requisitos_previos/linux|Ver documentación aquí]].</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nueva versión de API v2! </pre>

Es de vital importancia que, al actualizar el módulo de Gestión y al comenzar a utilizar la nueva versión de la API de SIU-Guaraní, se actualicen también las configuraciones de otros sistemas que la consumen, por ejemplo SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua, SIDCER, etc.. .

* Nueva versión [https://documentacion.siu.edu.ar/apis/?spec=guarani_v2 API v2]
** Para utilizar la API v2, se debe agregar el bloque [v2] en el archivo servidor.ini [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#Configuraci.C3.B3n_T.C3.A9cnica|ver documentación]]
** Registro de Cambios. [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#changelog|Ver Changelog]]
** La versión v1 puede seguir activa, para flexibilizar los cambios de versión
* Se agregan los usuarios para los módulos '''SIU-Tehuelche''' y '''SIU-Pilagá''' al template recursos_usuarios_template.php
* Se agregan mensajes de errores más detallados, para solucionar problemas de conexión.
* Se agregan los campos '''Fecha de inicio de tramite de egreso''' y '''Nro de expediente''' en los datos del Analítico, que se informan a SIDCer en el modelo de Personas.

* Se cambian los '''tipos de documentos''' enviados a '''SIU-Araí Documentos'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#tipos-de-documentos Ver documentación aquí].</dd>

== Gestión ==
*Se incorporo el parámetro '''nombre_persona_doc_oficiales''' que define con qué nombre deberán aparecer las personas en los documentos oficiales.

La incorporación hizo que se modificaran las plantillas de jaspers, por lo cual si había personalizaciones en las mismas debemos volver a adaptar esas personalizaciones a este nuevo cambio.

* Se migró de la versión '''3.3.22''' de '''SIU-Toba''' a la versión '''3.3.23'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.23/CHANGELOG.md ver documentación aquí].</dd>

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

* Se agrega el comando de consola '''bin/guarani vincular_usuarios_arai''' para vincular los usuarios de una instalación de '''Araí''' preexistente con personas de '''SIU-Guaraní'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#vincular-cuentas-de-siu-guaraní-con-araí-usuarios Ver documentación aquí].</dd>

* Se agrega la directiva '''version_api''' en el archivo '''instalacion/i__desarrollo/p__guarani/rest/arai_usuarios/cliente.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la opción de crear '''Grupos de Moodle''' por comisión.
<dd>Se deben agregar las funciones '''core_group_create_groups''', '''core_group_add_group_members''' y '''core_group_delete_groups''' en Moodle. [[SIU-Guarani/version3.22.0/interfaces/moodle#Agregar_funciones_para_el_servicio_creado_en_el_punto_3_.28hacer_click_en_el_link_marcado_en_violeta.29|ver documentación aquí]]</dd>

* Se agregan nuevos [[SIU-Guarani/version3.22.0/interfaces/moodle_comandos|Comandos de Moodle]].

* Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña. [[SIU-Guarani/Version3.22.0/configuracion-ttl-token|Ver documentación aquí]].

* Se mejoran las operaciones '''» Egresados » Actualizaciones » Adjuntar Documentación a Expediente de Egreso''' y '''» Egresados » Actualizaciones » Administrar Diploma y Analítico Digital'''. Ahora se puede seleccionar el '''Modelo de Firma''' ('''Simple''' o '''Cadena / Escalonada'''), y en el caso de ser '''Cadena / Escalonada''' se puede elegir el orden de los firmantes. Ademas los documentos serán adjuntados al expediente de SUDOCU una vez autorizados si los mismos tienen un trámite asociado.

== Autogestión ==

* Se agregan nuevas directivas en el archivo de configuración [[SIU-Guarani/Version3.22.0/3w/configuracion#config|instalacion/config.php]], se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
** Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña.

* Se actualizó la versión de Jasper a la 5.6.1.2, se debe reiniciar el servicio una vez realizada la actualización de versión.

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.5.0/CHANGELOG.md v2.5.0].

* Se incorpora la posibilidad de integrar con servicios del '''Renaper''', que permiten validar los datos del aspirante:
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/renaper|ver documentación aquí]].</dd>

* Se incorporó la personalización de '''Boleto Estudiantil''' al core de '''SIU-Guaraní Autogestión''':
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/boleto-estudiantil|ver documentación aquí]].</dd>

* Se agrega la directiva '''version_api''' para la entrada '''arai_usuarios''' en el archivo '''instalacion/servicios_web_config.php'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

</div></div>

SIU-Guarani/Version3.22.0/Novedades tecnicas

2024-05-13T18:10:08Z

Jschnaiderman:

__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''dd/mm/2024'''</p>
</div>
<p style="clear: both;"></p>

<br>
'''Importante:''' al momento de actualizar es posible hacerlo salteando versiones, no es necesario pasar por versiones intermedias. Sin embargo hay cuestiones técnicas que son necesarias para asegurar el correcto funcionamiento de la versión. Por favor lean las novedades técnicas de todas las versiones intermedias antes de comenzar el proceso.

== Base de Datos ==
[https://colab.siu.edu.ar/modelo/032200/html_v3.22.0.html Modelo 3.22.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.18.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Actualización versiones de [https://expedientes.siu.edu.ar/docs/guarani/ EEI].
** Se debe utilizar '''SIU-Araí Documentos''' a una versión mayor o igual a 1.3.0. [https://expedientes.siu.edu.ar/docs/guarani/#configurar-los-par%C3%A1metros-para-ara%C3%AD-documentos-en-siu-guaran%C3%AD Ver documentación aquí].

* SIU-Guaraní es compatible con '''Moodle 4'''.
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/moodle|Ver documentación aquí]].</dd>

* Se debe utilizar '''yui-compressor''' 2.4.8 o superior.
<dd>Para más información [[SIU-Guarani/version3.22.0/instalacion_desde_cero/requisitos_previos/linux|Ver documentación aquí]].</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nueva versión de API v2! </pre>

Es de vital importancia que, al actualizar el módulo de Gestión y al comenzar a utilizar la nueva versión de la API de SIU-Guaraní, se actualicen también las configuraciones de otros sistemas que la consumen, por ejemplo SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua, SIDCER, etc.. .

* Nueva versión [https://documentacion.siu.edu.ar/apis/?spec=guarani_v2 API v2]
** Para utilizar la API v2, se debe agregar el bloque [v2] en el archivo servidor.ini [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#Configuraci.C3.B3n_T.C3.A9cnica|ver documentación]]
** Registro de Cambios. [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#changelog|Ver Changelog]]
** La versión v1 puede seguir activa, para flexibilizar los cambios de versión
* Se agregan los usuarios para los módulos '''SIU-Tehuelche''' y '''SIU-Pilagá''' al template recursos_usuarios_template.php
* Se agregan mensajes de errores más detallados, para solucionar problemas de conexión.
* Se agregan los campos '''Fecha de inicio de tramite de egreso''' y '''Nro de expediente''' en los datos del Analítico, que se informan a SIDCer en el modelo de Personas.

* Se cambian los '''tipos de documentos''' enviados a '''SIU-Araí Documentos'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#tipos-de-documentos Ver documentación aquí].</dd>

== Gestión ==

* Se migró de la versión '''3.3.22''' de '''SIU-Toba''' a la versión '''3.3.23'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.23/CHANGELOG.md ver documentación aquí].</dd>

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

* Se agrega el comando de consola '''bin/guarani vincular_usuarios_arai''' para vincular los usuarios de una instalación de '''Araí''' preexistente con personas de '''SIU-Guaraní'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#vincular-cuentas-de-siu-guaraní-con-araí-usuarios Ver documentación aquí].</dd>

* Se agrega la directiva '''version_api''' en el archivo '''instalacion/i__desarrollo/p__guarani/rest/arai_usuarios/cliente.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la opción de crear '''Grupos de Moodle''' por comisión.
<dd>Se deben agregar las funciones '''core_group_create_groups''', '''core_group_add_group_members''' y '''core_group_delete_groups''' en Moodle. [[SIU-Guarani/version3.22.0/interfaces/moodle#Agregar_funciones_para_el_servicio_creado_en_el_punto_3_.28hacer_click_en_el_link_marcado_en_violeta.29|ver documentación aquí]]</dd>

* Se agregan nuevos [[SIU-Guarani/version3.22.0/interfaces/moodle_comandos|Comandos de Moodle]].

* Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña. [[SIU-Guarani/Version3.22.0/configuracion-ttl-token|Ver documentación aquí]].

* Se mejoran las operaciones '''» Egresados » Actualizaciones » Adjuntar Documentación a Expediente de Egreso''' y '''» Egresados » Actualizaciones » Administrar Diploma y Analítico Digital'''. Ahora se puede seleccionar el '''Modelo de Firma''' ('''Simple''' o '''Cadena / Escalonada'''), y en el caso de ser '''Cadena / Escalonada''' se puede elegir el orden de los firmantes. Ademas los documentos serán adjuntados al expediente de SUDOCU una vez autorizados si los mismos tienen un trámite asociado.

== Autogestión ==

* Se agregan nuevas directivas en el archivo de configuración [[SIU-Guarani/Version3.22.0/3w/configuracion#config|instalacion/config.php]], se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
** Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña.

* Se actualizó la versión de Jasper a la 5.6.1.2, se debe reiniciar el servicio una vez realizada la actualización de versión.

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.5.0/CHANGELOG.md v2.5.0].

* Se incorpora la posibilidad de integrar con servicios del '''Renaper''', que permiten validar los datos del aspirante:
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/renaper|ver documentación aquí]].</dd>

* Se incorporó la personalización de '''Boleto Estudiantil''' al core de '''SIU-Guaraní Autogestión''':
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/boleto-estudiantil|ver documentación aquí]].</dd>

* Se agrega la directiva '''version_api''' para la entrada '''arai_usuarios''' en el archivo '''instalacion/servicios_web_config.php'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

</div></div>

SIU-Guarani/Version3.22.0/Novedades tecnicas

2024-05-13T18:09:33Z

Jschnaiderman:

__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.22.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.22.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''02/12/2022'''</p>
</div>
<p style="clear: both;"></p>

<br>
'''Importante:''' al momento de actualizar es posible hacerlo salteando versiones, no es necesario pasar por versiones intermedias. Sin embargo hay cuestiones técnicas que son necesarias para asegurar el correcto funcionamiento de la versión. Por favor lean las novedades técnicas de todas las versiones intermedias antes de comenzar el proceso.

== Base de Datos ==
[https://colab.siu.edu.ar/modelo/032200/html_v3.22.0.html Modelo 3.22.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.22.0 Con versión 3.18.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Actualización versiones de [https://expedientes.siu.edu.ar/docs/guarani/ EEI].
** Se debe utilizar '''SIU-Araí Documentos''' a una versión mayor o igual a 1.3.0. [https://expedientes.siu.edu.ar/docs/guarani/#configurar-los-par%C3%A1metros-para-ara%C3%AD-documentos-en-siu-guaran%C3%AD Ver documentación aquí].

* SIU-Guaraní es compatible con '''Moodle 4'''.
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/moodle|Ver documentación aquí]].</dd>

* Se debe utilizar '''yui-compressor''' 2.4.8 o superior.
<dd>Para más información [[SIU-Guarani/version3.22.0/instalacion_desde_cero/requisitos_previos/linux|Ver documentación aquí]].</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nueva versión de API v2! </pre>

Es de vital importancia que, al actualizar el módulo de Gestión y al comenzar a utilizar la nueva versión de la API de SIU-Guaraní, se actualicen también las configuraciones de otros sistemas que la consumen, por ejemplo SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua, SIDCER, etc.. .

* Nueva versión [https://documentacion.siu.edu.ar/apis/?spec=guarani_v2 API v2]
** Para utilizar la API v2, se debe agregar el bloque [v2] en el archivo servidor.ini [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#Configuraci.C3.B3n_T.C3.A9cnica|ver documentación]]
** Registro de Cambios. [[SIU-Guarani/Version3.22.0/API_REST_GUARANI#changelog|Ver Changelog]]
** La versión v1 puede seguir activa, para flexibilizar los cambios de versión
* Se agregan los usuarios para los módulos '''SIU-Tehuelche''' y '''SIU-Pilagá''' al template recursos_usuarios_template.php
* Se agregan mensajes de errores más detallados, para solucionar problemas de conexión.
* Se agregan los campos '''Fecha de inicio de tramite de egreso''' y '''Nro de expediente''' en los datos del Analítico, que se informan a SIDCer en el modelo de Personas.

* Se cambian los '''tipos de documentos''' enviados a '''SIU-Araí Documentos'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#tipos-de-documentos Ver documentación aquí].</dd>

== Gestión ==

* Se migró de la versión '''3.3.22''' de '''SIU-Toba''' a la versión '''3.3.23'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.23/CHANGELOG.md ver documentación aquí].</dd>

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

* Se agrega el comando de consola '''bin/guarani vincular_usuarios_arai''' para vincular los usuarios de una instalación de '''Araí''' preexistente con personas de '''SIU-Guaraní'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#vincular-cuentas-de-siu-guaraní-con-araí-usuarios Ver documentación aquí].</dd>

* Se agrega la directiva '''version_api''' en el archivo '''instalacion/i__desarrollo/p__guarani/rest/arai_usuarios/cliente.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la opción de crear '''Grupos de Moodle''' por comisión.
<dd>Se deben agregar las funciones '''core_group_create_groups''', '''core_group_add_group_members''' y '''core_group_delete_groups''' en Moodle. [[SIU-Guarani/version3.22.0/interfaces/moodle#Agregar_funciones_para_el_servicio_creado_en_el_punto_3_.28hacer_click_en_el_link_marcado_en_violeta.29|ver documentación aquí]]</dd>

* Se agregan nuevos [[SIU-Guarani/version3.22.0/interfaces/moodle_comandos|Comandos de Moodle]].

* Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña. [[SIU-Guarani/Version3.22.0/configuracion-ttl-token|Ver documentación aquí]].

* Se mejoran las operaciones '''» Egresados » Actualizaciones » Adjuntar Documentación a Expediente de Egreso''' y '''» Egresados » Actualizaciones » Administrar Diploma y Analítico Digital'''. Ahora se puede seleccionar el '''Modelo de Firma''' ('''Simple''' o '''Cadena / Escalonada'''), y en el caso de ser '''Cadena / Escalonada''' se puede elegir el orden de los firmantes. Ademas los documentos serán adjuntados al expediente de SUDOCU una vez autorizados si los mismos tienen un trámite asociado.

== Autogestión ==

* Se agregan nuevas directivas en el archivo de configuración [[SIU-Guarani/Version3.22.0/3w/configuracion#config|instalacion/config.php]], se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
** Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña.

* Se actualizó la versión de Jasper a la 5.6.1.2, se debe reiniciar el servicio una vez realizada la actualización de versión.

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.5.0/CHANGELOG.md v2.5.0].

* Se incorpora la posibilidad de integrar con servicios del '''Renaper''', que permiten validar los datos del aspirante:
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/renaper|ver documentación aquí]].</dd>

* Se incorporó la personalización de '''Boleto Estudiantil''' al core de '''SIU-Guaraní Autogestión''':
<dd>Para más información [[SIU-Guarani/version3.22.0/interfaces/boleto-estudiantil|ver documentación aquí]].</dd>

* Se agrega la directiva '''version_api''' para la entrada '''arai_usuarios''' en el archivo '''instalacion/servicios_web_config.php'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

</div></div>

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-11-02T13:51:55Z

Jschnaiderman: /* Preinscripción */

__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<p style="clear: both;"></p>
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.21.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.21.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''xx/11/2023'''</p>
</div>
<p style="clear: both;"></p>
=== Diferencias con versiones anteriores ===
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.21.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.21.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.21.3 Con versión 3.18.1]
<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">
== Gestión ==

* Se agrega el parámetro '''sq_notif_insc_pendientes''', para mas información ver en [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.21.0/configuracion_del_sistema/parametros#Sanavir.C3.B3n-Quilmes Parámetros del Sistema - Sanavirón-Quilmes].

== Autogestión ==

* Se actualiza '''Google Analytics''', ver si es necesario generar un '''ID de medición''' nuevo.

== Preinscripción ==

* Se agregan nuevas directivas en el archivo de login '''instalacion/login.php''', se debe recrear a partir de su template (archivo '''instalacion/login_template.php'''):
** Se agrega la directiva '''form_documento''' para poder habilitar si el aspirante puede iniciar sesión usando su documento.
** se agrega un apartado para los datos de ayuda ('''datos_ayuda''') para la preinscripción que se mostraran al aspirante cuando no pueda acceder. Dentro tendrán '''datos_ayuda_email''', '''datos_ayuda_telefono''', '''datos_ayuda_url_3w''', '''datos_ayuda_url_ayuda'''
* Se actualiza '''Google Analytics''', ver si es necesario generar un '''ID de medición''' nuevo.

<p style="clear: both;"></p>
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.21.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.21.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/07/2023'''</p>
</div>
<p style="clear: both;"></p>
=== Diferencias con versiones anteriores ===
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.1&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.21.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.21.2 Con versión 3.18.1]
<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Gestión ==

* Se agrega la directiva '''host_notificaciones''' en el archivo '''instalacion/arai_documentos.ini''' (se utiliza para los [https://documentacion.siu.edu.ar/documentos/docs/notificaciones/ Servicios de Notificaciones a Aplicaciones]).
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani/#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní Ver documentación aquí].</dd>

== Autogestión ==

* Se agrega la directiva '''host_notificaciones''' en el archivo '''instalacion/arai_documentos.ini''' (se utiliza para los [https://documentacion.siu.edu.ar/documentos/docs/notificaciones/ Servicios de Notificaciones a Aplicaciones]).
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani/#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní Ver documentación aquí].</dd>

* Se agregan nuevas directivas en el archivo de configuración [[SIU-Guarani/Version3.21.0/3w/configuracion#config|instalacion/config.php]], se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
** Se agrega la directiva '''ui_autocomplete_min_length''' para configurar el número mínimo de caracteres que un usuario debe escribir antes de realizar una búsqueda en un [https://api.jqueryui.com/autocomplete/#option-minLength Autocomplete].

== Preinscripción ==

* Se arreglan '''Warnings''' y '''Notices'''.

<p style="clear: both;"></p>
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.21.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.21.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''20/04/2023'''</p>
</div>
<p style="clear: both;"></p>
=== Diferencias con versiones anteriores ===
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.21.0&new=HEAD@/branches/base_diff/versiones/3.21.1 Con versión 3.21.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.21.1 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.21.1 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.21.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.21.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.21.1 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.21.1 Con versión 3.18.1]
<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">
== Gestión ==
* Se mejora el '''Reporte Alumnos''' en el siguiente link te explicamos como personalizarlo. [[SIU-Guarani/Version3.21.0/personalizaciones/reporte_alumnos | Ver documentación aquí]]

== Autogestión ==

* Se agregan nuevas directivas en el archivo de configuración [[SIU-Guarani/Version3.21.0/3w/configuracion#config|instalacion/config.php]], se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
** Se agrega la directiva '''control_simultaneidad_operaciones''' para controlar que el alumno no pueda efectuar dos o más inscripciones simultáneas.

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.21.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.21.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''02/12/2022'''</p>
</div>
<p style="clear: both;"></p>

<br>
'''Importante:''' al momento de actualizar es posible hacerlo salteando versiones, no es necesario pasar por versiones intermedias. Sin embargo hay cuestiones técnicas que son necesarias para asegurar el correcto funcionamiento de la versión. Por favor lean las novedades técnicas de todas las versiones intermedias antes de comenzar el proceso.

== Base de Datos ==
[https://colab.siu.edu.ar/modelo/032100/html_v3.21.0.html Modelo 3.21.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.21.0 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.21.0 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.21.0 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.21.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.21.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.21.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.21.0 Con versión 3.18.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Actualización versiones de [https://expedientes.siu.edu.ar/docs/guarani/ EEI].
** Se debe utilizar '''SIU-Araí Documentos''' a una versión mayor o igual a 1.3.0. [https://expedientes.siu.edu.ar/docs/guarani/#configurar-los-par%C3%A1metros-para-ara%C3%AD-documentos-en-siu-guaran%C3%AD Ver documentación aquí].

* SIU-Guaraní es compatible con '''Moodle 4'''.
<dd>Para más información [[SIU-Guarani/version3.21.0/interfaces/moodle|Ver documentación aquí]].</dd>

* Se debe utilizar '''yui-compressor''' 2.4.8 o superior.
<dd>Para más información [[SIU-Guarani/version3.21.0/instalacion_desde_cero/requisitos_previos/linux|Ver documentación aquí]].</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nueva versión de API v2! </pre>

Es de vital importancia que, al actualizar el módulo de Gestión y al comenzar a utilizar la nueva versión de la API de SIU-Guaraní, se actualicen también las configuraciones de otros sistemas que la consumen, por ejemplo SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua, SIDCER, etc.. .

* Nueva versión [https://documentacion.siu.edu.ar/apis/?spec=guarani_v2 API v2]
** Para utilizar la API v2, se debe agregar el bloque [v2] en el archivo servidor.ini [[SIU-Guarani/Version3.21.0/API_REST_GUARANI#Configuraci.C3.B3n_T.C3.A9cnica|ver documentación]]
** Registro de Cambios. [[SIU-Guarani/Version3.21.0/API_REST_GUARANI#changelog|Ver Changelog]]
** La versión v1 puede seguir activa, para flexibilizar los cambios de versión
* Se agregan los usuarios para los módulos '''SIU-Tehuelche''' y '''SIU-Pilagá''' al template recursos_usuarios_template.php
* Se agregan mensajes de errores más detallados, para solucionar problemas de conexión.
* Se agregan los campos '''Fecha de inicio de tramite de egreso''' y '''Nro de expediente''' en los datos del Analítico, que se informan a SIDCer en el modelo de Personas.

* Se cambian los '''tipos de documentos''' enviados a '''SIU-Araí Documentos'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#tipos-de-documentos Ver documentación aquí].</dd>

== Gestión ==

* Se migró de la versión '''3.3.21''' de '''SIU-Toba''' a la versión '''3.3.23'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.23/CHANGELOG.md ver documentación aquí].</dd>

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

* Se agrega el comando de consola '''bin/guarani vincular_usuarios_arai''' para vincular los usuarios de una instalación de '''Araí''' preexistente con personas de '''SIU-Guaraní'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#vincular-cuentas-de-siu-guaraní-con-araí-usuarios Ver documentación aquí].</dd>

* Se agrega la directiva '''version_api''' en el archivo '''instalacion/i__desarrollo/p__guarani/rest/arai_usuarios/cliente.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-gestión Ver documentación aquí].</dd>

* Se agrega la opción de crear '''Grupos de Moodle''' por comisión.
<dd>Se deben agregar las funciones '''core_group_create_groups''', '''core_group_add_group_members''' y '''core_group_delete_groups''' en Moodle. [[SIU-Guarani/version3.21.0/interfaces/moodle#Agregar_funciones_para_el_servicio_creado_en_el_punto_3_.28hacer_click_en_el_link_marcado_en_violeta.29|ver documentación aquí]]</dd>

* Se agregan nuevos [[SIU-Guarani/version3.21.0/interfaces/moodle_comandos|Comandos de Moodle]].

* Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña. [[SIU-Guarani/Version3.21.0/configuracion-ttl-token|Ver documentación aquí]].

* Se mejoran las operaciones '''» Egresados » Actualizaciones » Adjuntar Documentación a Expediente de Egreso''' y '''» Egresados » Actualizaciones » Administrar Diploma y Analítico Digital'''. Ahora se puede seleccionar el '''Modelo de Firma''' ('''Simple''' o '''Cadena / Escalonada'''), y en el caso de ser '''Cadena / Escalonada''' se puede elegir el orden de los firmantes. Ademas los documentos serán adjuntados al expediente de SUDOCU una vez autorizados si los mismos tienen un trámite asociado.

== Autogestión ==

* Se agregan nuevas directivas en el archivo de configuración [[SIU-Guarani/Version3.21.0/3w/configuracion#config|instalacion/config.php]], se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
** Se agrega la directiva '''ttl_token''' para configurar el tiempo de expiración del token para recuperar contraseña.

* Se actualizó la versión de Jasper a la 5.6.1.2, se debe reiniciar el servicio una vez realizada la actualización de versión.

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.5.0/CHANGELOG.md v2.5.0].

* Se incorpora la posibilidad de integrar con servicios del '''Renaper''', que permiten validar los datos del aspirante:
<dd>Para más información [[SIU-Guarani/version3.21.0/interfaces/renaper|ver documentación aquí]].</dd>

* Se incorporó la personalización de '''Boleto Estudiantil''' al core de '''SIU-Guaraní Autogestión''':
<dd>Para más información [[SIU-Guarani/version3.21.0/interfaces/boleto-estudiantil|ver documentación aquí]].</dd>

* Se agrega la directiva '''version_api''' para la entrada '''arai_usuarios''' en el archivo '''instalacion/servicios_web_config.php'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-el-cliente-de-usuarios-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

* Se agrega la directiva '''version''' en el archivo '''instalacion/arai_documentos.ini'''.
<dd>Para más información [https://expedientes.siu.edu.ar/docs/guarani#configurar-los-parámetros-para-araí-documentos-en-siu-guaraní-autogestión Ver documentación aquí].</dd>

</div></div>

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-21T16:03:26Z

Jschnaiderman:

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-21T16:00:14Z

Jschnaiderman:

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-21T14:04:04Z

Jschnaiderman:

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-21T14:02:38Z

Jschnaiderman:

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-21T13:59:09Z

Jschnaiderman: /* Diferencias con versiones anteriores */

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-21T13:50:14Z

Jschnaiderman: /* Diferencias con versiones anteriores */

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-21T13:46:52Z

Jschnaiderman: /* Principales novedades técnicas */

SIU-Guarani/Version3.21.0/Novedades tecnicas

2023-04-20T20:04:19Z

Jschnaiderman:

SIU-Guarani/Version3.21.0/Migracion/Desde sistemas externos/Migracion/Matricula

2023-04-03T18:31:49Z

Jschnaiderman: /* Pasos para la Migración */

{|
|__TOC__
|}

= Migración de Sistemas Externos a Guaraní 3 =

== Módulo: '''Matrículas''' ==
A continuación se detallarán los pasos necesarios para la migración del módulo '''Matrículas'''.<br>

==== Pre-Requisitos ====
* Verificar correcta instalación del Kettle y conexión a la base de datos PostgreSql.
* Carga de datos a Guaraní 3 por sistema:
{| class="wikitable"
|-
! <small>Dato a Cargar</small> !! <small>Descripción</small> !! <small>Menú de G3</small>
|-
| '''Ubicaciones''' || Ubicación geográfica (Sedes, subsedes, etc..) || <small>» UNIDADES DE GESTIÓN » UBICACIONES » UBICACIONES</small>
|-
| '''Responsables Académicas''' || Responsables académicas de las propuestas y actividades || <small>» UNIDADES DE GESTIÓN » ADMINISTRAR RESPONSABLES ACADÉMICAS</small>
|-
| '''Años académicos''' || Este dato lo creará en forma automática el proceso de migración en el caso de no existir creado en la base de datos|| <small>» CALENDARIO » ACTUALIZACIONES » AÑOS ACADÉMICOS</small>
|-
| '''Períodos de inscripción''' || Este dato lo creará en forma automática el proceso de migración en el caso de no existir creado en la base de datos|| <small>» CALENDARIO » PERÍODOS DE INSCRIPCIÓN » PERÍODOS DE INSCRIPCIÓN A PROPUESTAS</small>
|-
| '''Certificaciones''' || Certificados que otorga cada plan de estudios|| <small>» CONSTANCIAS Y CERTIFICADOS » ADMINISTRAR CONSTANCIAS Y CERTIFICADOS</small><br><small>» PROPUESTAS FORMATIVAS » PLANES DE ESTUDIO » ASIGNACIÓN DE CERTIFICADOS</small>
|-
| '''Actividades''' || Actividades de los planes de estudios|| <small>» PROPUESTAS FORMATIVAS » ACTIVIDADES » ACTIVIDADES</small>
|-
| '''Propuestas''' || Propuestas Formativas que estarán asociadas al plan de estudios|| <small>» PROPUESTAS FORMATIVAS » ADMINISTRAR PROPUESTAS FORMATIVAS</small>
|-
| '''Planes de Estudios ''' || Creación de planes, asignación de propuestas y certificaciones que cada plan otorga. El plan debe estar activo.|| <small>» PROPUESTAS FORMATIVAS » PLANES DE ESTUDIO » ADMINISTRAR PLANES DE ESTUDIO</small>
|-
| '''Motivos de Excepción''' || Motivos de excepción de requisitos de ingreso|| <small>» REQUISITOS » REQUISITOS DE INGRESO » MOTIVOS DE EXCEPCIÓN DE REQUISITOS</small>
|}
Habiendo verificado los datos cargados en Guaraní 3, se puede avanzar con la migración del módulo. <br>

==== Pasos para la Migración ====
<big>1. Creación de los archivos CSV: <br></big>
* Delimitador: '''|'''<br>
* Directorio: '''Externos/01_Schema/CSV'''<br>
'''mig_alumnos.csv'''
* Formato del archivo:<br>
{| class="wikitable"
|-
! <small>Nro</small>!! <small>Columna</small>!! <small>Tipo de dato</small> !! <small>Permite Nulos</small> !! <small>Formato</small> !! <small>Descripción</small> !! <small>Tablas Relacionadas</small>
|-
| 1 || legajo||varchar(20)||S|| || Nro de legajo del alumno ||
|-
| 2 || tipo_documento||smallint||N ||0 - DNI||Tipo de documento || mdp_tipo_documento.tipo_documento
|-
| 3 || nro_documento||varchar(15)||N|| || Nro de documento. ||
|-
| 4 || propuesta||integer||N|| || ID de la propuesta || sga_propuestas.propuesta
|-
| 5 || plan_version_ingreso ||integer|| N || || Versión de plan de estudios con el que ingresó a la propuesta|| sga_planes_versiones.plan_version
|-
| 6 || plan_version_actual ||integer|| N || || Versión de plan de estudios actual del alumno || sga_planes_versiones.plan_version
|-
| 7 || plan_version_actual_fecha ||date|| S || || Fecha de cambio a la versión actual. Solo si plan_version_ingreso <> plan_version_actual ||
|-
| 8 || ubicacion ||integer|| N || || Ubicación/sede donde se encuentra el alumno || sga_ubicaciones.ubicacion
|-
| 9 || modalidad ||char(1)|| N || P-Presencial <br> D- A distancia|| Modalidad de Cursada || sga_modalidad_cursada.modalidad
|-
| 10 || regular ||char(1)|| N ||S-Es Regular <br> N-No es Regular|| Condicion de Regularidad en la propuesta ||
|-
| 11 || calidad ||char(1)|| N ||A-Alumno Activo <br> P-Alumno Pasivo || Calidad del Alumno en la propuesta || sga_alumnos_calidad.calidad
|-
| 12 || anio_academico ||integer|| N || aaaa || Año académico de ingreso en la propuesta || sga_anios_academicos
|-
| 13 || fecha_inscripcion ||date|| N || dd/mm/aaaa|| Fecha de Inscripción en la propuesta ||
|-
| 14 || estado_inscripcion ||char(1)|| N || P-Pendiente <br> A-Aceptado <br> R-Rechazado || Estado de Inscripción en la propuesta ||
|-
| 15 || noreg_anio_academico ||integer||S||aaaa|| Datos relacionados con la pérdida de regularidad en la propuesta. Año académico en que dejó de ser regular.<br> Dato obligatorio si ''regular'' = N ||
|-
| 16 || noreg_fecha ||date||S||dd/mm/aaaa||Fecha en que pasó a ser no regular en la carrera.<br>Dato obligatorio si ''regular'' = N ||
|-
| 17 || noreg_causa ||integer||S|| || Causa que hizo que pierda la regularidad en la propuesta.<br>Dato obligatorio si ''regular'' = N || sga_perdida_regularidad_causas.causa_perdida_reg (Desde 100 en adelante)
|-
| 18 || pasivo_fecha ||date||S||dd/mm/aaaa||Fecha en que pasó a ser alumno pasivo.<br>Dato obligatorio si ''calidad'' = P ||
|-
| 19 || pasivo_motivo ||integer||S|| || Motivo del cambio de calidad a la calidad actual del alumno en la propuesta. Dato obligatorio si ''calidad'' = P || sga_alumnos_motivos_calidad
|-
| 20 || egre_titulo ||integer||S|| || Para egresados, indicar el título por el cual egresó. Se inserta registro en sga_certificados_otorg || sga_certificados.certificado
|-
| 21 || egre_fecha_egreso || date|| S || dd/mm/aaaa || Para egresados, indicar la fecha de egreso.<br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 22 || egre_nro_expediente ||varchar(30) ||S|| ||Para egresados, Nro de expediente del trámite de egreso ||
|-
| 23 || egre_promedio || numerico(8,2) ||S|| || Para egresados, promedio con aplazos. <br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 24 || egre_promedio_sin_aplazos || numerico(8,2) ||S|| || Para egresados, promedio sin aplazos.<br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 25 || egre_observaciones || varchar(255) ||S|| ||Para egresados, observaciones acerca de la solicitud del titulo ||
|}

El tipo_documento + nro_documento identifican a la persona, la cual debe existir en la tabla de migración '''mig_personas'''.<br>
Los campos "egre_fecha_egreso, egre_promedio y egre_promedio_sin_aplazos" son de ingreso obligatorio si se registró un titulo (egre_titulo).<br>
El campo promedio lo deben migrar con coma (,).<br>

'''mig_requisitos.csv'''
* Formato del archivo:<br>
{| class="wikitable"
|-
! <small>Nro</small>!! <small>Columna</small>!! <small>Tipo de dato</small> !! <small>Permite Nulos</small> !! <small>Formato</small> !! <small>Descripción</small>!! <small>Tablas Relacionadas</small>
|-
| 1 || tipo_documento||smallint||N||0 - DNI|| Tipo de documento del alumno || mdp_tipo_documento.tipo_documento
|-
| 2 || nro_documento||varchar(15)|| N || || Nro de documento del alumno ||
|-
| 3 || propuesta ||integer|| N || || ID de la prpuesta por la que presentó el requisito de ingreso. || sga_propuestas.propuesta
|-
| 4 || requisito ||integer|| N || || ID del requisito de ingreso ||sga_requisitos.requisito
|-
| 5 || presentado_exceptuado ||char(1)|| N ||P-Presentado<br>E-Exceptuado|| Indica si el requisito fue presentado por el alumno o fue exceptuado su presentación ||
|-
| 6 || fecha ||date|| N || dd/mm/aaaa ||Fecha de presentación o de excepción del requisito ||
|-
| 7 || observaciones ||varchar(200)|| S || || Observaciones sobre el requisito ||
|-
| 8 || restrictivo ||char(1)|| N || S-Si <br> N-No || Si es restrictivo para la generación del legajo del alumno ||
|-
| 9 || motivo_excepcion ||integer|| S || || Motivo por el cual fue exceptuado el requisito al alumno. Solo debe ingresarse si presentado_exceptuado = P. || sga_req_motivos_excepcion.motivo_excepcion
|-
| 10 || fecha_vencimiento ||date|| S ||dd/mm/aaaa ||Solo para requisitos presentados en el caso que tengan vencimiento ||
|-
| 11 || fecha_prorroga ||date||S|| dd/mm/aaaa || Fecha de prórroga si se le otorgó prórroga al alumno ||
|}

El '''tipo_documento + nro_documento''' identifican a la persona, la cual debe existir en la tabla de migración '''mig_personas'''.
El '''tipo_documento + nro_documento + propuesta''' identifican a la inscripción del alumno en la propuesta, el cual debe existir '''mig_alumnos'''.

<big>2. Creación de tablas. Esquema '''ext.''' de la base de datos</big><br>
# Ejecutar trabajo: <big>Externos/01_Schema/04_Matriculas/'''script_ mig_matriculas.kjb'''</big><br>
Como resultado se crearán la tablas 'mig_alumnos' y 'mig_requisitos' en el esquema 'ext', y se llenarán las mismas con los datos los CSV creados en el paso anterior.<br>
[[Archivo:Mig externos 0016.png|ninguna]]<br>

<big>3. Migración del Módulo</big><br>
En el directorio Externos/02_Modulos/04_Matriculas, 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:
# Precontroles <br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/01_Pre_Controles/''prectrl_matriculas.kjb'''''<br>[[Archivo:Mig externos 0017.png|ninguna]]<br>
## Revisar el archivo Excel generado por el trabajo del pre-control: '''Prectrl_Personas_Alumnos.xls''', dentro del mismo directorio <br>[[Archivo:Mig externos 0018.png|ninguna]]<br>
## Arreglar errores que detallen en el archivo de precontroles y volver a correrlos para asegurarse que los datos queden consistentes.<br>
## Si el archivo '''Prectrl_Personas_Alumnos.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.
# Migración<br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/02_Migracion/''mig_matriculas.kjb'''''<br>[[Archivo:Mig externos 0020.png|ninguna]]<br>
# Poscontroles<br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/03_Pos_Controles/''posctrl_matriculas.kjb'''''<br>[[Archivo:Mig externos 0021.png|ninguna]]<br>
## Revisar el archivo Excel generado por el trabajo del post-control: '''Pos_Controles_Matriculas.xls''', dentro del mismo directorio <br>
## 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.<br>

<br>

----

<br>

{| style="width:100%;"
|-
| [[SIU-Guarani/Version3.21.0/Migracion/Desde sistemas externos/Migracion/Calendario_Academico|< Migrar Calendario Académico]] <br> [[SIU-Guarani/Version3.21.0/Migracion/Desde sistemas externos|< Migración Sistemas Externos]]|| align="right" | [[SIU-Guarani/Version3.21.0/Migracion/Desde sistemas externos/Migracion/Cursadas|Migrar Cursadas >]]
|}

SIU-Guarani/Version3.22.0/Migracion/Desde sistemas externos/Migracion/Matricula

2023-04-03T18:31:49Z

Jschnaiderman:

{|
|__TOC__
|}

= Migración de Sistemas Externos a Guaraní 3 =

== Módulo: '''Matrículas''' ==
A continuación se detallarán los pasos necesarios para la migración del módulo '''Matrículas'''.<br>

==== Pre-Requisitos ====
* Verificar correcta instalación del Kettle y conexión a la base de datos PostgreSql.
* Carga de datos a Guaraní 3 por sistema:
{| class="wikitable"
|-
! <small>Dato a Cargar</small> !! <small>Descripción</small> !! <small>Menú de G3</small>
|-
| '''Ubicaciones''' || Ubicación geográfica (Sedes, subsedes, etc..) || <small>» UNIDADES DE GESTIÓN » UBICACIONES » UBICACIONES</small>
|-
| '''Responsables Académicas''' || Responsables académicas de las propuestas y actividades || <small>» UNIDADES DE GESTIÓN » ADMINISTRAR RESPONSABLES ACADÉMICAS</small>
|-
| '''Años académicos''' || Este dato lo creará en forma automática el proceso de migración en el caso de no existir creado en la base de datos|| <small>» CALENDARIO » ACTUALIZACIONES » AÑOS ACADÉMICOS</small>
|-
| '''Períodos de inscripción''' || Este dato lo creará en forma automática el proceso de migración en el caso de no existir creado en la base de datos|| <small>» CALENDARIO » PERÍODOS DE INSCRIPCIÓN » PERÍODOS DE INSCRIPCIÓN A PROPUESTAS</small>
|-
| '''Certificaciones''' || Certificados que otorga cada plan de estudios|| <small>» CONSTANCIAS Y CERTIFICADOS » ADMINISTRAR CONSTANCIAS Y CERTIFICADOS</small><br><small>» PROPUESTAS FORMATIVAS » PLANES DE ESTUDIO » ASIGNACIÓN DE CERTIFICADOS</small>
|-
| '''Actividades''' || Actividades de los planes de estudios|| <small>» PROPUESTAS FORMATIVAS » ACTIVIDADES » ACTIVIDADES</small>
|-
| '''Propuestas''' || Propuestas Formativas que estarán asociadas al plan de estudios|| <small>» PROPUESTAS FORMATIVAS » ADMINISTRAR PROPUESTAS FORMATIVAS</small>
|-
| '''Planes de Estudios ''' || Creación de planes, asignación de propuestas y certificaciones que cada plan otorga. El plan debe estar activo.|| <small>» PROPUESTAS FORMATIVAS » PLANES DE ESTUDIO » ADMINISTRAR PLANES DE ESTUDIO</small>
|-
| '''Motivos de Excepción''' || Motivos de excepción de requisitos de ingreso|| <small>» REQUISITOS » REQUISITOS DE INGRESO » MOTIVOS DE EXCEPCIÓN DE REQUISITOS</small>
|}
Habiendo verificado los datos cargados en Guaraní 3, se puede avanzar con la migración del módulo. <br>

==== Pasos para la Migración ====
<big>1. Creación de los archivos CSV: <br></big>
* Delimitador: '''|'''<br>
* Directorio: '''Externos/01_Schema/CSV'''<br>
'''mig_alumnos.csv'''
* Formato del archivo:<br>
{| class="wikitable"
|-
! <small>Nro</small>!! <small>Columna</small>!! <small>Tipo de dato</small> !! <small>Permite Nulos</small> !! <small>Formato</small> !! <small>Descripción</small> !! <small>Tablas Relacionadas</small>
|-
| 1 || legajo||varchar(20)||S|| || Nro de legajo del alumno ||
|-
| 2 || tipo_documento||smallint||N ||0 - DNI||Tipo de documento || mdp_tipo_documento.tipo_documento
|-
| 3 || nro_documento||varchar(15)||N|| || Nro de documento. ||
|-
| 4 || propuesta||integer||N|| || ID de la propuesta || sga_propuestas.propuesta
|-
| 5 || plan_version_ingreso ||integer|| N || || Versión de plan de estudios con el que ingresó a la propuesta|| sga_planes_versiones.plan_version
|-
| 6 || plan_version_actual ||integer|| N || || Versión de plan de estudios actual del alumno || sga_planes_versiones.plan_version
|-
| 7 || plan_version_actual_fecha ||date|| S || || Fecha de cambio a la versión actual. Solo si plan_version_ingreso <> plan_version_actual ||
|-
| 8 || ubicacion ||integer|| N || || Ubicación/sede donde se encuentra el alumno || sga_ubicaciones.ubicacion
|-
| 9 || modalidad ||char(1)|| N || P-Presencial <br> D- A distancia|| Modalidad de Cursada || sga_modalidad_cursada.modalidad
|-
| 10 || regular ||char(1)|| N ||S-Es Regular <br> N-No es Regular|| Condicion de Regularidad en la propuesta ||
|-
| 11 || calidad ||char(1)|| N ||A-Alumno Activo <br> P-Alumno Pasivo || Calidad del Alumno en la propuesta || sga_alumnos_calidad.calidad
|-
| 12 || anio_academico ||integer|| N || aaaa || Año académico de ingreso en la propuesta || sga_anios_academicos
|-
| 13 || fecha_inscripcion ||date|| N || dd/mm/aaaa|| Fecha de Inscripción en la propuesta ||
|-
| 14 || estado_inscripcion ||char(1)|| N || P-Pendiente <br> A-Aceptado <br> R-Rechazado || Estado de Inscripción en la propuesta ||
|-
| 15 || noreg_anio_academico ||integer||S||aaaa|| Datos relacionados con la pérdida de regularidad en la propuesta. Año académico en que dejó de ser regular.<br> Dato obligatorio si ''regular'' = N ||
|-
| 16 || noreg_fecha ||date||S||dd/mm/aaaa||Fecha en que pasó a ser no regular en la carrera.<br>Dato obligatorio si ''regular'' = N ||
|-
| 17 || noreg_causa ||integer||S|| || Causa que hizo que pierda la regularidad en la propuesta.<br>Dato obligatorio si ''regular'' = N || sga_perdida_regularidad_causas.causa_perdida_reg (Desde 100 en adelante)
|-
| 18 || pasivo_fecha ||date||S||dd/mm/aaaa||Fecha en que pasó a ser alumno pasivo.<br>Dato obligatorio si ''calidad'' = P ||
|-
| 19 || pasivo_motivo ||integer||S|| || Motivo del cambio de calidad a la calidad actual del alumno en la propuesta. Dato obligatorio si ''calidad'' = P || sga_alumnos_motivos_calidad
|-
| 20 || egre_titulo ||integer||S|| || Para egresados, indicar el título por el cual egresó. Se inserta registro en sga_certificados_otorg || sga_certificados.certificado
|-
| 21 || egre_fecha_egreso || date|| S || dd/mm/aaaa || Para egresados, indicar la fecha de egreso.<br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 22 || egre_nro_expediente ||varchar(30) ||S|| ||Para egresados, Nro de expediente del trámite de egreso ||
|-
| 23 || egre_promedio || numerico(8,2) ||S|| || Para egresados, promedio con aplazos. <br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 24 || egre_promedio_sin_aplazos || numerico(8,2) ||S|| || Para egresados, promedio sin aplazos.<br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 25 || egre_observaciones || varchar(255) ||S|| ||Para egresados, observaciones acerca de la solicitud del titulo ||
|}

El tipo_documento + nro_documento identifican a la persona, la cual debe existir en la tabla de migración '''mig_personas'''.<br>
Los campos "egre_fecha_egreso, egre_promedio y egre_promedio_sin_aplazos" son de ingreso obligatorio si se registró un titulo (egre_titulo).<br>
El campo promedio lo deben migrar con coma (,).<br>

'''mig_requisitos.csv'''
* Formato del archivo:<br>
{| class="wikitable"
|-
! <small>Nro</small>!! <small>Columna</small>!! <small>Tipo de dato</small> !! <small>Permite Nulos</small> !! <small>Formato</small> !! <small>Descripción</small>!! <small>Tablas Relacionadas</small>
|-
| 1 || tipo_documento||smallint||N||0 - DNI|| Tipo de documento del alumno || mdp_tipo_documento.tipo_documento
|-
| 2 || nro_documento||varchar(15)|| N || || Nro de documento del alumno ||
|-
| 3 || propuesta ||integer|| N || || ID de la prpuesta por la que presentó el requisito de ingreso. || sga_propuestas.propuesta
|-
| 4 || requisito ||integer|| N || || ID del requisito de ingreso ||sga_requisitos.requisito
|-
| 5 || presentado_exceptuado ||char(1)|| N ||P-Presentado<br>E-Exceptuado|| Indica si el requisito fue presentado por el alumno o fue exceptuado su presentación ||
|-
| 6 || fecha ||date|| N || dd/mm/aaaa ||Fecha de presentación o de excepción del requisito ||
|-
| 7 || observaciones ||varchar(200)|| S || || Observaciones sobre el requisito ||
|-
| 8 || restrictivo ||char(1)|| N || S-Si <br> N-No || Si es restrictivo para la generación del legajo del alumno ||
|-
| 9 || motivo_excepcion ||integer|| S || || Motivo por el cual fue exceptuado el requisito al alumno. Solo debe ingresarse si presentado_exceptuado = P. || sga_req_motivos_excepcion.motivo_excepcion
|-
| 10 || fecha_vencimiento ||date|| S ||dd/mm/aaaa ||Solo para requisitos presentados en el caso que tengan vencimiento ||
|-
| 11 || fecha_prorroga ||date||S|| dd/mm/aaaa || Fecha de prórroga si se le otorgó prórroga al alumno ||
|}

El '''tipo_documento + nro_documento''' identifican a la persona, la cual debe existir en la tabla de migración '''mig_personas'''.
El '''tipo_documento + nro_documento + propuesta''' identifican a la inscripción del alumno en la propuesta, el cual debe existir '''mig_alumnos'''.

<big>2. Creación de tablas. Esquema '''ext.''' de la base de datos</big><br>
# Ejecutar trabajo: <big>Externos/01_Schema/04_Matriculas/'''script_ mig_matriculas.kjb'''</big><br>
Como resultado se crearán la tablas 'mig_alumnos' y 'mig_requisitos' en el esquema 'ext', y se llenarán las mismas con los datos los CSV creados en el paso anterior.<br>
[[Archivo:Mig externos 0016.png|ninguna]]<br>

<big>3. Migración del Módulo</big><br>
En el directorio Externos/02_Modulos/04_Matriculas, 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:
# Precontroles <br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/01_Pre_Controles/''prectrl_matriculas.kjb'''''<br>[[Archivo:Mig externos 0017.png|ninguna]]<br>
## Revisar el archivo Excel generado por el trabajo del pre-control: '''Prectrl_Personas_Alumnos.xls''', dentro del mismo directorio <br>[[Archivo:Mig externos 0018.png|ninguna]]<br>
## Arreglar errores que detallen en el archivo de precontroles y volver a correrlos para asegurarse que los datos queden consistentes.<br>
## Si el archivo '''Prectrl_Personas_Alumnos.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.
# Migración<br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/02_Migracion/''mig_matriculas.kjb'''''<br>[[Archivo:Mig externos 0020.png|ninguna]]<br>
# Poscontroles<br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/03_Pos_Controles/''posctrl_matriculas.kjb'''''<br>[[Archivo:Mig externos 0021.png|ninguna]]<br>
## Revisar el archivo Excel generado por el trabajo del post-control: '''Pos_Controles_Matriculas.xls''', dentro del mismo directorio <br>
## 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.<br>

<br>

----

<br>

{| style="width:100%;"
|-
| [[SIU-Guarani/Version3.22.0/Migracion/Desde sistemas externos/Migracion/Calendario_Academico|< Migrar Calendario Académico]] <br> [[SIU-Guarani/Version3.22.0/Migracion/Desde sistemas externos|< Migración Sistemas Externos]]|| align="right" | [[SIU-Guarani/Version3.22.0/Migracion/Desde sistemas externos/Migracion/Cursadas|Migrar Cursadas >]]
|}

SIU-Guarani/Version3.20.0/Migracion/Desde sistemas externos/Migracion/Matricula

2023-04-03T18:31:08Z

Jschnaiderman:

{|
|__TOC__
|}

= Migración de Sistemas Externos a Guaraní 3 =

== Módulo: '''Matrículas''' ==
A continuación se detallarán los pasos necesarios para la migración del módulo '''Matrículas'''.<br>

==== Pre-Requisitos ====
* Verificar correcta instalación del Kettle y conexión a la base de datos PostgreSql.
* Carga de datos a Guaraní 3 por sistema:
{| class="wikitable"
|-
! <small>Dato a Cargar</small> !! <small>Descripción</small> !! <small>Menú de G3</small>
|-
| '''Ubicaciones''' || Ubicación geográfica (Sedes, subsedes, etc..) || <small>» UNIDADES DE GESTIÓN » UBICACIONES » UBICACIONES</small>
|-
| '''Responsables Académicas''' || Responsables académicas de las propuestas y actividades || <small>» UNIDADES DE GESTIÓN » ADMINISTRAR RESPONSABLES ACADÉMICAS</small>
|-
| '''Años académicos''' || Este dato lo creará en forma automática el proceso de migración en el caso de no existir creado en la base de datos|| <small>» CALENDARIO » ACTUALIZACIONES » AÑOS ACADÉMICOS</small>
|-
| '''Períodos de inscripción''' || Este dato lo creará en forma automática el proceso de migración en el caso de no existir creado en la base de datos|| <small>» CALENDARIO » PERÍODOS DE INSCRIPCIÓN » PERÍODOS DE INSCRIPCIÓN A PROPUESTAS</small>
|-
| '''Certificaciones''' || Certificados que otorga cada plan de estudios|| <small>» CONSTANCIAS Y CERTIFICADOS » ADMINISTRAR CONSTANCIAS Y CERTIFICADOS</small><br><small>» PROPUESTAS FORMATIVAS » PLANES DE ESTUDIO » ASIGNACIÓN DE CERTIFICADOS</small>
|-
| '''Actividades''' || Actividades de los planes de estudios|| <small>» PROPUESTAS FORMATIVAS » ACTIVIDADES » ACTIVIDADES</small>
|-
| '''Propuestas''' || Propuestas Formativas que estarán asociadas al plan de estudios|| <small>» PROPUESTAS FORMATIVAS » ADMINISTRAR PROPUESTAS FORMATIVAS</small>
|-
| '''Planes de Estudios ''' || Creación de planes, asignación de propuestas y certificaciones que cada plan otorga. El plan debe estar activo.|| <small>» PROPUESTAS FORMATIVAS » PLANES DE ESTUDIO » ADMINISTRAR PLANES DE ESTUDIO</small>
|-
| '''Motivos de Excepción''' || Motivos de excepción de requisitos de ingreso|| <small>» REQUISITOS » REQUISITOS DE INGRESO » MOTIVOS DE EXCEPCIÓN DE REQUISITOS</small>
|}
Habiendo verificado los datos cargados en Guaraní 3, se puede avanzar con la migración del módulo. <br>

==== Pasos para la Migración ====
<big>1. Creación de los archivos CSV: <br></big>
* Delimitador: '''|'''<br>
* Directorio: '''Externos/01_Schema/CSV'''<br>
'''mig_alumnos.csv'''
* Formato del archivo:<br>
{| class="wikitable"
|-
! <small>Nro</small>!! <small>Columna</small>!! <small>Tipo de dato</small> !! <small>Permite Nulos</small> !! <small>Formato</small> !! <small>Descripción</small> !! <small>Tablas Relacionadas</small>
|-
| 1 || legajo||varchar(20)||S|| || Nro de legajo del alumno ||
|-
| 2 || tipo_documento||smallint||N ||0 - DNI||Tipo de documento || mdp_tipo_documento.tipo_documento
|-
| 3 || nro_documento||varchar(15)||N|| || Nro de documento. ||
|-
| 4 || propuesta||integer||N|| || ID de la propuesta || sga_propuestas.propuesta
|-
| 5 || plan_version_ingreso ||integer|| N || || Versión de plan de estudios con el que ingresó a la propuesta|| sga_planes_versiones.plan_version
|-
| 6 || plan_version_actual ||integer|| N || || Versión de plan de estudios actual del alumno || sga_planes_versiones.plan_version
|-
| 7 || plan_version_actual_fecha ||date|| S || || Fecha de cambio a la versión actual. Solo si plan_version_ingreso <> plan_version_actual ||
|-
| 8 || ubicacion ||integer|| N || || Ubicación/sede donde se encuentra el alumno || sga_ubicaciones.ubicacion
|-
| 9 || modalidad ||char(1)|| N || P-Presencial <br> D- A distancia|| Modalidad de Cursada || sga_modalidad_cursada.modalidad
|-
| 10 || regular ||char(1)|| N ||S-Es Regular <br> N-No es Regular|| Condicion de Regularidad en la propuesta ||
|-
| 11 || calidad ||char(1)|| N ||A-Alumno Activo <br> P-Alumno Pasivo || Calidad del Alumno en la propuesta || sga_alumnos_calidad.calidad
|-
| 12 || anio_academico ||integer|| N || aaaa || Año académico de ingreso en la propuesta || sga_anios_academicos
|-
| 13 || fecha_inscripcion ||date|| N || dd/mm/aaaa|| Fecha de Inscripción en la propuesta ||
|-
| 14 || estado_inscripcion ||char(1)|| N || P-Pendiente <br> A-Aceptado <br> R-Rechazado || Estado de Inscripción en la propuesta ||
|-
| 15 || noreg_anio_academico ||integer||S||aaaa|| Datos relacionados con la pérdida de regularidad en la propuesta. Año académico en que dejó de ser regular.<br> Dato obligatorio si ''regular'' = N ||
|-
| 16 || noreg_fecha ||date||S||dd/mm/aaaa||Fecha en que pasó a ser no regular en la carrera.<br>Dato obligatorio si ''regular'' = N ||
|-
| 17 || noreg_causa ||integer||S|| || Causa que hizo que pierda la regularidad en la propuesta.<br>Dato obligatorio si ''regular'' = N || sga_perdida_regularidad_causas.causa_perdida_reg (Desde 100 en adelante)
|-
| 18 || pasivo_fecha ||date||S||dd/mm/aaaa||Fecha en que pasó a ser alumno pasivo.<br>Dato obligatorio si ''calidad'' = P ||
|-
| 19 || pasivo_motivo ||integer||S|| || Motivo del cambio de calidad a la calidad actual del alumno en la propuesta. Dato obligatorio si ''calidad'' = P || sga_motivos_cambio_calidad
|-
| 20 || egre_titulo ||integer||S|| || Para egresados, indicar el título por el cual egresó. Se inserta registro en sga_certificados_otorg || sga_certificados.certificado
|-
| 21 || egre_fecha_egreso || date|| S || dd/mm/aaaa || Para egresados, indicar la fecha de egreso.<br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 22 || egre_nro_expediente ||varchar(30) ||S|| ||Para egresados, Nro de expediente del trámite de egreso ||
|-
| 23 || egre_promedio || numerico(8,2) ||S|| || Para egresados, promedio con aplazos. <br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 24 || egre_promedio_sin_aplazos || numerico(8,2) ||S|| || Para egresados, promedio sin aplazos.<br>Dato obligatorio si se registró titulo en campo ''egre_titulo'' ||
|-
| 25 || egre_observaciones || varchar(255) ||S|| ||Para egresados, observaciones acerca de la solicitud del titulo ||
|}

El tipo_documento + nro_documento identifican a la persona, la cual debe existir en la tabla de migración '''mig_personas'''.<br>
Los campos "egre_fecha_egreso, egre_promedio y egre_promedio_sin_aplazos" son de ingreso obligatorio si se registró un titulo (egre_titulo).<br>
El campo promedio lo deben migrar con coma (,).<br>

'''mig_requisitos.csv'''
* Formato del archivo:<br>
{| class="wikitable"
|-
! <small>Nro</small>!! <small>Columna</small>!! <small>Tipo de dato</small> !! <small>Permite Nulos</small> !! <small>Formato</small> !! <small>Descripción</small>!! <small>Tablas Relacionadas</small>
|-
| 1 || tipo_documento||smallint||N||0 - DNI|| Tipo de documento del alumno || mdp_tipo_documento.tipo_documento
|-
| 2 || nro_documento||varchar(15)|| N || || Nro de documento del alumno ||
|-
| 3 || propuesta ||integer|| N || || ID de la prpuesta por la que presentó el requisito de ingreso. || sga_propuestas.propuesta
|-
| 4 || requisito ||integer|| N || || ID del requisito de ingreso ||sga_requisitos.requisito
|-
| 5 || presentado_exceptuado ||char(1)|| N ||P-Presentado<br>E-Exceptuado|| Indica si el requisito fue presentado por el alumno o fue exceptuado su presentación ||
|-
| 6 || fecha ||date|| N || dd/mm/aaaa ||Fecha de presentación o de excepción del requisito ||
|-
| 7 || observaciones ||varchar(200)|| S || || Observaciones sobre el requisito ||
|-
| 8 || restrictivo ||char(1)|| N || S-Si <br> N-No || Si es restrictivo para la generación del legajo del alumno ||
|-
| 9 || motivo_excepcion ||integer|| S || || Motivo por el cual fue exceptuado el requisito al alumno. Solo debe ingresarse si presentado_exceptuado = P. || sga_req_motivos_excepcion.motivo_excepcion
|-
| 10 || fecha_vencimiento ||date|| S ||dd/mm/aaaa ||Solo para requisitos presentados en el caso que tengan vencimiento ||
|-
| 11 || fecha_prorroga ||date||S|| dd/mm/aaaa || Fecha de prórroga si se le otorgó prórroga al alumno ||
|}

El '''tipo_documento + nro_documento''' identifican a la persona, la cual debe existir en la tabla de migración '''mig_personas'''.
El '''tipo_documento + nro_documento + propuesta''' identifican a la inscripción del alumno en la propuesta, el cual debe existir '''mig_alumnos'''.

<big>2. Creación de tablas. Esquema '''ext.''' de la base de datos</big><br>
# Ejecutar trabajo: <big>Externos/01_Schema/04_Matriculas/'''script_ mig_matriculas.kjb'''</big><br>
Como resultado se crearán la tablas 'mig_alumnos' y 'mig_requisitos' en el esquema 'ext', y se llenarán las mismas con los datos los CSV creados en el paso anterior.<br>
[[Archivo:Mig externos 0016.png|ninguna]]<br>

<big>3. Migración del Módulo</big><br>
En el directorio Externos/02_Modulos/04_Matriculas, 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:
# Precontroles <br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/01_Pre_Controles/''prectrl_matriculas.kjb'''''<br>[[Archivo:Mig externos 0017.png|ninguna]]<br>
## Revisar el archivo Excel generado por el trabajo del pre-control: '''Prectrl_Personas_Alumnos.xls''', dentro del mismo directorio <br>[[Archivo:Mig externos 0018.png|ninguna]]<br>
## Arreglar errores que detallen en el archivo de precontroles y volver a correrlos para asegurarse que los datos queden consistentes.<br>
## Si el archivo '''Prectrl_Personas_Alumnos.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.
# Migración<br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/02_Migracion/''mig_matriculas.kjb'''''<br>[[Archivo:Mig externos 0020.png|ninguna]]<br>
# Poscontroles<br>
## Ejecutar trabajo: '''Externos/02_Modulos/04_Matriculas/03_Pos_Controles/''posctrl_matriculas.kjb'''''<br>[[Archivo:Mig externos 0021.png|ninguna]]<br>
## Revisar el archivo Excel generado por el trabajo del post-control: '''Pos_Controles_Matriculas.xls''', dentro del mismo directorio <br>
## 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.<br>

<br>

----

<br>

{| style="width:100%;"
|-
| [[SIU-Guarani/Version3.20.0/Migracion/Desde sistemas externos/Migracion/Calendario_Academico|< Migrar Calendario Académico]] <br> [[SIU-Guarani/Version3.20.0/Migracion/Desde sistemas externos|< Migración Sistemas Externos]]|| align="right" | [[SIU-Guarani/Version3.20.0/Migracion/Desde sistemas externos/Migracion/Cursadas|Migrar Cursadas >]]
|}

SIU-Guarani/Version3.20.0/Novedades tecnicas

2022-12-12T16:26:04Z

Jschnaiderman:

__NOTOC__
__NOTOC__


<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.3 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>12/12/2022</strong></p>
</div>
<p style="clear: both;"></p>

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.2&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.20.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.1&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.20.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.3 Con versión 3.17.0]

== Gestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' realizada la actualización de versión.
== Autogestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.2 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>15/06/2022</strong></p>
</div>
<p style="clear: both;"></p>

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.1]

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.0]

== API-REST Guaraní ==

* Se mejoran los Web Sevices de '''Boleto Estudiantil''', se deben volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/WS/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/ws Revisar cambios en la configuración de los mismos].

== Gestión ==

* Se mejoran los comandos '''bin/guarani pro_solicitudes_sube''' y '''bin/guarani notif_solicitudes_sube''' para que cuando un alumno recupera la regularidad se le vuelva a habilitar el beneficio de '''Boleto Estudiantil'''.

== Autogestión ==

* Se mejora la personalización de '''Boleto Estudiantil''', se debe volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/3W/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/3w Revisar cambios en la configuración de la misma].

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.1 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: ''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.1] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Se agrega configuración de URL y puerto para usar Jasper, hay que regenerar el archivo [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php].
* Se agrega genero x en la API

<div class="mw-collapsible-content">

== API-REST Guaraní ==

* Se refactoriza el código de la API REST para que reconozca personalizaciones realizadas por la universidad, en caso de tener personalizaciones en la API REST [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest revisar la siguiente documentación].

== Gestión ==

* Se agrega '''jasper_host''' y '''jasper_port''' al archivo '''instalacion/instalacion.ini''' para personalizar host y puerto del servicio Jasper, respectivamente. Por defecto toma los siguientes valores:
<source lang="ini" enclose="div" style="width: 450px;">
jasper_host = "127.0.0.1"
jasper_port = "8081"
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#gestion Configuración de Jasper].

* Se mejora el comando '''bin/guarani exportar_usuarios_arai''':
** Da la opción de exportar personas con o sin email asignado.
** Si la persona tiene varios emails se exportaran todos siguiendo el siguiente orden de importancia: '''Email Principal''', '''Email Secundario''' y '''Email Institucional'''.
** Permite exportar el género '''No Binario''' hacia SIU-Araí (se deben utilizar versiones de '''SIU-Araí Usuarios >= v3.1.6''' en el caso que se necesite [https://expedientes.siu.edu.ar/docs/guarani/#sincronizar-cuentas-de-usuarios Sincronizar cuentas de usuarios]).

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''jasper_host''' para configurar la IP/URL donde se encuentre alojado el servicio '''Jasper''', por defecto '127.0.0.1'.
* Se agrega la directiva '''jasper_port''' para configurar el puerto donde se encuentre alojado el servicio '''Jasper''', por defecto '8081'.
</dd>
<source lang="php" enclose="div" style="width: 450px;">
/**
* Host donde se corre Jasper
* - Ejemplo: 127.0.0.1
*/
'jasper_host' => '127.0.0.1',

/**
* Puerto donde se corre Jasper
* - Ejemplo: 8081
*/
'jasper_port' => '8081',
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#autogestion Configuración de Jasper].

</div></div>
__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2021'''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Cambios en la documentación de [https://expedientes.siu.edu.ar/docs/guarani/ Expedientes].

* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.20.0/instalacion_desde_cero/requisitos_previos/linux Se modifican los requisitos previos]:
<dd>Actualización de tecnologías de base:
* Se actualiza a la versión de '''PHP 7.4.x.'''
Importante:
[https://www.php.net/manual/es/migration74.php Consideraciones de migración de PHP 7.3 a 7.4]
* Se actualiza a la versión de '''Composer 2.x.x'''
Para actualizar de Composer 1 a Composer 2 ejecutar el comando '''composer self-update --2'''.
</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nuevo esquema de versionado de API! </pre> Permite mantener vivas las versiones anteriores de la API Guaraní, para ello se agrega un indicador de versión a la url. El resultado es ''http://<url_gestion>/rest/v1/''.

Es muy '''IMPORTANTE''' que al actualizar el módulo de Gestión, cambien las configuraciones de otros sistemas que consumen la API de SIU-Guaraní como SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua y SIDCER.

Ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/API_REST_GUARANI configuración de API REST].

Si se posee personalizaciones en la API REST ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest Personalizar servicios REST].

== Gestión ==

* Se migró de la versión '''3.3.14''' de '''SIU-Toba''' a la versión '''3.3.20'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.20/CHANGELOG.md ver documentación aquí].</dd>

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''huarpe_url_bandeja''' para configurar la URL de la bandeja de documentos pendientes de autorización de '''SIU-Huarpe'''.
</dd>

* Se migró de la versión '''2.3.0''' de '''Chulupí''' a la versión '''2.4.0'''.

</div></div>

SIU-Guarani/Version3.20.0/Novedades tecnicas

2022-12-12T14:36:00Z

Jschnaiderman:

__NOTOC__
__NOTOC__


<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.3 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>12/12/2022</strong></p>
</div>
<p style="clear: both;"></p>

== Gestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' realizada la actualización de versión.
== Autogestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.2 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>15/06/2022</strong></p>
</div>
<p style="clear: both;"></p>

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.1]

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.0]

== API-REST Guaraní ==

* Se mejoran los Web Sevices de '''Boleto Estudiantil''', se deben volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/WS/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/ws Revisar cambios en la configuración de los mismos].

== Gestión ==

* Se mejoran los comandos '''bin/guarani pro_solicitudes_sube''' y '''bin/guarani notif_solicitudes_sube''' para que cuando un alumno recupera la regularidad se le vuelva a habilitar el beneficio de '''Boleto Estudiantil'''.

== Autogestión ==

* Se mejora la personalización de '''Boleto Estudiantil''', se debe volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/3W/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/3w Revisar cambios en la configuración de la misma].

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.1 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: ''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.1] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Se agrega configuración de URL y puerto para usar Jasper, hay que regenerar el archivo [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php].
* Se agrega genero x en la API

<div class="mw-collapsible-content">

== API-REST Guaraní ==

* Se refactoriza el código de la API REST para que reconozca personalizaciones realizadas por la universidad, en caso de tener personalizaciones en la API REST [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest revisar la siguiente documentación].

== Gestión ==

* Se agrega '''jasper_host''' y '''jasper_port''' al archivo '''instalacion/instalacion.ini''' para personalizar host y puerto del servicio Jasper, respectivamente. Por defecto toma los siguientes valores:
<source lang="ini" enclose="div" style="width: 450px;">
jasper_host = "127.0.0.1"
jasper_port = "8081"
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#gestion Configuración de Jasper].

* Se mejora el comando '''bin/guarani exportar_usuarios_arai''':
** Da la opción de exportar personas con o sin email asignado.
** Si la persona tiene varios emails se exportaran todos siguiendo el siguiente orden de importancia: '''Email Principal''', '''Email Secundario''' y '''Email Institucional'''.
** Permite exportar el género '''No Binario''' hacia SIU-Araí (se deben utilizar versiones de '''SIU-Araí Usuarios >= v3.1.6''' en el caso que se necesite [https://expedientes.siu.edu.ar/docs/guarani/#sincronizar-cuentas-de-usuarios Sincronizar cuentas de usuarios]).

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''jasper_host''' para configurar la IP/URL donde se encuentre alojado el servicio '''Jasper''', por defecto '127.0.0.1'.
* Se agrega la directiva '''jasper_port''' para configurar el puerto donde se encuentre alojado el servicio '''Jasper''', por defecto '8081'.
</dd>
<source lang="php" enclose="div" style="width: 450px;">
/**
* Host donde se corre Jasper
* - Ejemplo: 127.0.0.1
*/
'jasper_host' => '127.0.0.1',

/**
* Puerto donde se corre Jasper
* - Ejemplo: 8081
*/
'jasper_port' => '8081',
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#autogestion Configuración de Jasper].

</div></div>
__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2021'''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Cambios en la documentación de [https://expedientes.siu.edu.ar/docs/guarani/ Expedientes].

* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.20.0/instalacion_desde_cero/requisitos_previos/linux Se modifican los requisitos previos]:
<dd>Actualización de tecnologías de base:
* Se actualiza a la versión de '''PHP 7.4.x.'''
Importante:
[https://www.php.net/manual/es/migration74.php Consideraciones de migración de PHP 7.3 a 7.4]
* Se actualiza a la versión de '''Composer 2.x.x'''
Para actualizar de Composer 1 a Composer 2 ejecutar el comando '''composer self-update --2'''.
</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nuevo esquema de versionado de API! </pre> Permite mantener vivas las versiones anteriores de la API Guaraní, para ello se agrega un indicador de versión a la url. El resultado es ''http://<url_gestion>/rest/v1/''.

Es muy '''IMPORTANTE''' que al actualizar el módulo de Gestión, cambien las configuraciones de otros sistemas que consumen la API de SIU-Guaraní como SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua y SIDCER.

Ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/API_REST_GUARANI configuración de API REST].

Si se posee personalizaciones en la API REST ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest Personalizar servicios REST].

== Gestión ==

* Se migró de la versión '''3.3.14''' de '''SIU-Toba''' a la versión '''3.3.20'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.20/CHANGELOG.md ver documentación aquí].</dd>

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''huarpe_url_bandeja''' para configurar la URL de la bandeja de documentos pendientes de autorización de '''SIU-Huarpe'''.
</dd>

* Se migró de la versión '''2.3.0''' de '''Chulupí''' a la versión '''2.4.0'''.

</div></div>

SIU-Guarani/Version3.20.0/Novedades tecnicas

2022-12-12T14:35:18Z

Jschnaiderman:

__NOTOC__
__NOTOC__

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.3 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>12/12/2022</strong></p>
</div>
<p style="clear: both;"></p>

== Gestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' realizada la actualización de versión.
== Autogestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.2 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>15/06/2022</strong></p>
</div>
<p style="clear: both;"></p>

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.1]

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.0]

== API-REST Guaraní ==

* Se mejoran los Web Sevices de '''Boleto Estudiantil''', se deben volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/WS/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/ws Revisar cambios en la configuración de los mismos].

== Gestión ==

* Se mejoran los comandos '''bin/guarani pro_solicitudes_sube''' y '''bin/guarani notif_solicitudes_sube''' para que cuando un alumno recupera la regularidad se le vuelva a habilitar el beneficio de '''Boleto Estudiantil'''.

== Autogestión ==

* Se mejora la personalización de '''Boleto Estudiantil''', se debe volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/3W/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/3w Revisar cambios en la configuración de la misma].

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.1 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: ''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.1] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Se agrega configuración de URL y puerto para usar Jasper, hay que regenerar el archivo [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php].
* Se agrega genero x en la API

<div class="mw-collapsible-content">

== API-REST Guaraní ==

* Se refactoriza el código de la API REST para que reconozca personalizaciones realizadas por la universidad, en caso de tener personalizaciones en la API REST [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest revisar la siguiente documentación].

== Gestión ==

* Se agrega '''jasper_host''' y '''jasper_port''' al archivo '''instalacion/instalacion.ini''' para personalizar host y puerto del servicio Jasper, respectivamente. Por defecto toma los siguientes valores:
<source lang="ini" enclose="div" style="width: 450px;">
jasper_host = "127.0.0.1"
jasper_port = "8081"
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#gestion Configuración de Jasper].

* Se mejora el comando '''bin/guarani exportar_usuarios_arai''':
** Da la opción de exportar personas con o sin email asignado.
** Si la persona tiene varios emails se exportaran todos siguiendo el siguiente orden de importancia: '''Email Principal''', '''Email Secundario''' y '''Email Institucional'''.
** Permite exportar el género '''No Binario''' hacia SIU-Araí (se deben utilizar versiones de '''SIU-Araí Usuarios >= v3.1.6''' en el caso que se necesite [https://expedientes.siu.edu.ar/docs/guarani/#sincronizar-cuentas-de-usuarios Sincronizar cuentas de usuarios]).

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''jasper_host''' para configurar la IP/URL donde se encuentre alojado el servicio '''Jasper''', por defecto '127.0.0.1'.
* Se agrega la directiva '''jasper_port''' para configurar el puerto donde se encuentre alojado el servicio '''Jasper''', por defecto '8081'.
</dd>
<source lang="php" enclose="div" style="width: 450px;">
/**
* Host donde se corre Jasper
* - Ejemplo: 127.0.0.1
*/
'jasper_host' => '127.0.0.1',

/**
* Puerto donde se corre Jasper
* - Ejemplo: 8081
*/
'jasper_port' => '8081',
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#autogestion Configuración de Jasper].

</div></div>
__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2021'''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Cambios en la documentación de [https://expedientes.siu.edu.ar/docs/guarani/ Expedientes].

* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.20.0/instalacion_desde_cero/requisitos_previos/linux Se modifican los requisitos previos]:
<dd>Actualización de tecnologías de base:
* Se actualiza a la versión de '''PHP 7.4.x.'''
Importante:
[https://www.php.net/manual/es/migration74.php Consideraciones de migración de PHP 7.3 a 7.4]
* Se actualiza a la versión de '''Composer 2.x.x'''
Para actualizar de Composer 1 a Composer 2 ejecutar el comando '''composer self-update --2'''.
</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nuevo esquema de versionado de API! </pre> Permite mantener vivas las versiones anteriores de la API Guaraní, para ello se agrega un indicador de versión a la url. El resultado es ''http://<url_gestion>/rest/v1/''.

Es muy '''IMPORTANTE''' que al actualizar el módulo de Gestión, cambien las configuraciones de otros sistemas que consumen la API de SIU-Guaraní como SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua y SIDCER.

Ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/API_REST_GUARANI configuración de API REST].

Si se posee personalizaciones en la API REST ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest Personalizar servicios REST].

== Gestión ==

* Se migró de la versión '''3.3.14''' de '''SIU-Toba''' a la versión '''3.3.20'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.20/CHANGELOG.md ver documentación aquí].</dd>

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''huarpe_url_bandeja''' para configurar la URL de la bandeja de documentos pendientes de autorización de '''SIU-Huarpe'''.
</dd>

* Se migró de la versión '''2.3.0''' de '''Chulupí''' a la versión '''2.4.0'''.

</div></div>

SIU-Guarani/Version3.20.0/Novedades tecnicas

2022-12-12T14:34:44Z

Jschnaiderman:

__NOTOC__
__NOTOC__

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.3 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>12/12/2022</strong></p>
</div>
<p style="clear: both;"></p>
== API-REST Guaraní ==

*
== Gestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' realizada la actualización de versión.
== Autogestión ==

* Se actualizó la versión de Jasper a la 5.6.1.2, '''se debe reiniciar el servicio''' una vez realizada la actualización de versión.

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.2 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>15/06/2022</strong></p>
</div>
<p style="clear: both;"></p>

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.1]

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.0]

== API-REST Guaraní ==

* Se mejoran los Web Sevices de '''Boleto Estudiantil''', se deben volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/WS/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/ws Revisar cambios en la configuración de los mismos].

== Gestión ==

* Se mejoran los comandos '''bin/guarani pro_solicitudes_sube''' y '''bin/guarani notif_solicitudes_sube''' para que cuando un alumno recupera la regularidad se le vuelva a habilitar el beneficio de '''Boleto Estudiantil'''.

== Autogestión ==

* Se mejora la personalización de '''Boleto Estudiantil''', se debe volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/3W/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/3w Revisar cambios en la configuración de la misma].

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.1 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: ''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.1] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Se agrega configuración de URL y puerto para usar Jasper, hay que regenerar el archivo [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php].
* Se agrega genero x en la API

<div class="mw-collapsible-content">

== API-REST Guaraní ==

* Se refactoriza el código de la API REST para que reconozca personalizaciones realizadas por la universidad, en caso de tener personalizaciones en la API REST [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest revisar la siguiente documentación].

== Gestión ==

* Se agrega '''jasper_host''' y '''jasper_port''' al archivo '''instalacion/instalacion.ini''' para personalizar host y puerto del servicio Jasper, respectivamente. Por defecto toma los siguientes valores:
<source lang="ini" enclose="div" style="width: 450px;">
jasper_host = "127.0.0.1"
jasper_port = "8081"
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#gestion Configuración de Jasper].

* Se mejora el comando '''bin/guarani exportar_usuarios_arai''':
** Da la opción de exportar personas con o sin email asignado.
** Si la persona tiene varios emails se exportaran todos siguiendo el siguiente orden de importancia: '''Email Principal''', '''Email Secundario''' y '''Email Institucional'''.
** Permite exportar el género '''No Binario''' hacia SIU-Araí (se deben utilizar versiones de '''SIU-Araí Usuarios >= v3.1.6''' en el caso que se necesite [https://expedientes.siu.edu.ar/docs/guarani/#sincronizar-cuentas-de-usuarios Sincronizar cuentas de usuarios]).

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''jasper_host''' para configurar la IP/URL donde se encuentre alojado el servicio '''Jasper''', por defecto '127.0.0.1'.
* Se agrega la directiva '''jasper_port''' para configurar el puerto donde se encuentre alojado el servicio '''Jasper''', por defecto '8081'.
</dd>
<source lang="php" enclose="div" style="width: 450px;">
/**
* Host donde se corre Jasper
* - Ejemplo: 127.0.0.1
*/
'jasper_host' => '127.0.0.1',

/**
* Puerto donde se corre Jasper
* - Ejemplo: 8081
*/
'jasper_port' => '8081',
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#autogestion Configuración de Jasper].

</div></div>
__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2021'''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Cambios en la documentación de [https://expedientes.siu.edu.ar/docs/guarani/ Expedientes].

* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.20.0/instalacion_desde_cero/requisitos_previos/linux Se modifican los requisitos previos]:
<dd>Actualización de tecnologías de base:
* Se actualiza a la versión de '''PHP 7.4.x.'''
Importante:
[https://www.php.net/manual/es/migration74.php Consideraciones de migración de PHP 7.3 a 7.4]
* Se actualiza a la versión de '''Composer 2.x.x'''
Para actualizar de Composer 1 a Composer 2 ejecutar el comando '''composer self-update --2'''.
</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nuevo esquema de versionado de API! </pre> Permite mantener vivas las versiones anteriores de la API Guaraní, para ello se agrega un indicador de versión a la url. El resultado es ''http://<url_gestion>/rest/v1/''.

Es muy '''IMPORTANTE''' que al actualizar el módulo de Gestión, cambien las configuraciones de otros sistemas que consumen la API de SIU-Guaraní como SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua y SIDCER.

Ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/API_REST_GUARANI configuración de API REST].

Si se posee personalizaciones en la API REST ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest Personalizar servicios REST].

== Gestión ==

* Se migró de la versión '''3.3.14''' de '''SIU-Toba''' a la versión '''3.3.20'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.20/CHANGELOG.md ver documentación aquí].</dd>

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''huarpe_url_bandeja''' para configurar la URL de la bandeja de documentos pendientes de autorización de '''SIU-Huarpe'''.
</dd>

* Se migró de la versión '''2.3.0''' de '''Chulupí''' a la versión '''2.4.0'''.

</div></div>

SIU-Guarani/Version3.20.0/Novedades tecnicas

2022-12-07T14:18:48Z

Jschnaiderman:

__NOTOC__
__NOTOC__


= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.2 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: <strong>15/06/2022</strong></p>
</div>
<p style="clear: both;"></p>

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.1]

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.2 Con versión 3.15.0]

== API-REST Guaraní ==

* Se mejoran los Web Sevices de '''Boleto Estudiantil''', se deben volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/WS/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/ws Revisar cambios en la configuración de los mismos].

== Gestión ==

* Se mejoran los comandos '''bin/guarani pro_solicitudes_sube''' y '''bin/guarani notif_solicitudes_sube''' para que cuando un alumno recupera la regularidad se le vuelva a habilitar el beneficio de '''Boleto Estudiantil'''.

== Autogestión ==

* Se mejora la personalización de '''Boleto Estudiantil''', se debe volver a descargar desde [https://colab.siu.edu.ar/svn/guarani3/contrib/3.20.x/boleto_estudiantil/3W/ aquí]. [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil/3w Revisar cambios en la configuración de la misma].

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.1 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.1</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: ''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.1] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.20.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Se agrega configuración de URL y puerto para usar Jasper, hay que regenerar el archivo [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php].
* Se agrega genero x en la API

<div class="mw-collapsible-content">

== API-REST Guaraní ==

* Se refactoriza el código de la API REST para que reconozca personalizaciones realizadas por la universidad, en caso de tener personalizaciones en la API REST [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest revisar la siguiente documentación].

== Gestión ==

* Se agrega '''jasper_host''' y '''jasper_port''' al archivo '''instalacion/instalacion.ini''' para personalizar host y puerto del servicio Jasper, respectivamente. Por defecto toma los siguientes valores:
<source lang="ini" enclose="div" style="width: 450px;">
jasper_host = "127.0.0.1"
jasper_port = "8081"
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#gestion Configuración de Jasper].

* Se mejora el comando '''bin/guarani exportar_usuarios_arai''':
** Da la opción de exportar personas con o sin email asignado.
** Si la persona tiene varios emails se exportaran todos siguiendo el siguiente orden de importancia: '''Email Principal''', '''Email Secundario''' y '''Email Institucional'''.
** Permite exportar el género '''No Binario''' hacia SIU-Araí (se deben utilizar versiones de '''SIU-Araí Usuarios >= v3.1.6''' en el caso que se necesite [https://expedientes.siu.edu.ar/docs/guarani/#sincronizar-cuentas-de-usuarios Sincronizar cuentas de usuarios]).

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config instalacion/config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''jasper_host''' para configurar la IP/URL donde se encuentre alojado el servicio '''Jasper''', por defecto '127.0.0.1'.
* Se agrega la directiva '''jasper_port''' para configurar el puerto donde se encuentre alojado el servicio '''Jasper''', por defecto '8081'.
</dd>
<source lang="php" enclose="div" style="width: 450px;">
/**
* Host donde se corre Jasper
* - Ejemplo: 127.0.0.1
*/
'jasper_host' => '127.0.0.1',

/**
* Puerto donde se corre Jasper
* - Ejemplo: 8081
*/
'jasper_port' => '8081',
</source>
Ver documentación [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/configuracion-jasper#autogestion Configuración de Jasper].

</div></div>
__NOTOC__
__NOTOC__
= Principales novedades técnicas =

<p style="clear: both;"></p>

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2021'''</p>
</div>
<p style="clear: both;"></p>
== Base de Datos ==
* [https://colab.siu.edu.ar/modelo/032000/html%20v3.20.0.html Modelo 3.20.0] (Se accede con credenciales de Colab)

=== Diferencias con versiones anteriores ===

* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.17.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.2]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.0]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.1]
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Cambios en la documentación de [https://expedientes.siu.edu.ar/docs/guarani/ Expedientes].

* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.20.0/instalacion_desde_cero/requisitos_previos/linux Se modifican los requisitos previos]:
<dd>Actualización de tecnologías de base:
* Se actualiza a la versión de '''PHP 7.4.x.'''
Importante:
[https://www.php.net/manual/es/migration74.php Consideraciones de migración de PHP 7.3 a 7.4]
* Se actualiza a la versión de '''Composer 2.x.x'''
Para actualizar de Composer 1 a Composer 2 ejecutar el comando '''composer self-update --2'''.
</dd>

<div class="mw-collapsible-content">

== API-REST Guaraní ==

<pre style="color: red"> ¡Nuevo esquema de versionado de API! </pre> Permite mantener vivas las versiones anteriores de la API Guaraní, para ello se agrega un indicador de versión a la url. El resultado es ''http://<url_gestion>/rest/v1/''.

Es muy '''IMPORTANTE''' que al actualizar el módulo de Gestión, cambien las configuraciones de otros sistemas que consumen la API de SIU-Guaraní como SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua y SIDCER.

Ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/API_REST_GUARANI configuración de API REST].

Si se posee personalizaciones en la API REST ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest Personalizar servicios REST].

== Gestión ==

* Se migró de la versión '''3.3.14''' de '''SIU-Toba''' a la versión '''3.3.20'''.
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.20/CHANGELOG.md ver documentación aquí].</dd>

== Autogestión ==

* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion#config config.php]:
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):
* Se agrega la directiva '''huarpe_url_bandeja''' para configurar la URL de la bandeja de documentos pendientes de autorización de '''SIU-Huarpe'''.
</dd>

* Se migró de la versión '''2.3.0''' de '''Chulupí''' a la versión '''2.4.0'''.

</div></div>