SIU - Contribuciones del usuario [es]

SIU-Guarani/Version3.23.0/Novedades tecnicas preinscripcion

2026-01-09T19:04:46Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/requisitos | Se modifican los requisitos previos]]:
<dd>Actualización de tecnologías de base:
* Se actualiza a la versión de '''PHP 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''
</dd>

* Se migra '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

* Se agrega [[SIU-Guarani/preinscripcion3.23.0/personalizacion#Personalizaci.C3.B3n_de_par.C3.A1metros_de_configuraci.C3.B3n | Personalización de parámetros de configuración]] y [[SIU-Guarani/preinscripcion3.23.0/personalizacion#Personalizaci.C3.B3n_de_comandos_de_consola | Personalización de comandos de consola]].

* Se agrega el [[SIU-Guarani/preinscripcion3.23.0/sistema_recordatorios_automaticos | Sistema de recordatorios automáticos]].

* 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 '''url_preinscripcion''' para configurar la URL base de Preinscripción.

SIU-Guarani/preinscripcion3.22.0/sistema recordatorios automaticos

2026-01-09T19:02:58Z

Lleonardis:

== Sistema de recordatorios automáticos ==

Programar la ejecución automática del comando '''bin/preinscripcion notificar_recordatorios''', el cual notifica, vía email, a los aspirantes que aún no enviaron la preinscripción.

En el archivo '''instalacion/config.php''' se debe configurar la directiva '''url_preinscripcion''', además de contar con el '''SMTP''' correctamente configurado, para garantizar la ejecución del comando y el envío del recordatorio.

[[SIU-Guarani/preinscripcion3.22.0/documentacion_tecnica|< Volver]]

SIU-Guarani/preinscripcion3.23.0/sistema recordatorios automaticos

2026-01-09T19:02:30Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-09T19:00:32Z

Lleonardis:

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* [[SIU-Guarani/version3.23.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 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''

* Se cambia la forma de ejecutar '''Jasper''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/instalacion/gestion/linux | Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Desarrollo]] y [[SIU-Guarani/version3.23.0/instalacion/3w | Instalación de SIU-Guaraní 3w versión 3.23.x en entorno de Desarrollo o Producción]]:

<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>

</dd>

<div class="mw-collapsible-content">

== Interfaces con otros módulos SIU ==

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/bioma | BIOMA]].

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/arai-reportes | Araí-Reportes]].

== Interfaces con Sistemas externos ==

* Se adapta la conexión con [[SIU-Guarani/version3.23.0/interfaces/renaper | Renaper]].

== Gestión ==

* Se migra '''SIU TOBA Framework''' a la versión [https://github.com/SIU-Toba/framework/blob/v3.4.3/CHANGELOG.md v3.4.3].

* Se incorpora la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migra '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

* Se agrega [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_parametros_configuracion | Personalización de parámetros de configuración]] y [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_comandos_consola | Personalización de comandos de consola]].

</div></div>

SIU-Guarani/Version3.23.0/Novedades tecnicas preinscripcion

2026-01-09T18:59:30Z

Lleonardis:

SIU-Guarani/version3.23.0/interfaces/bioma

2026-01-09T18:52:58Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
== Interfaz SIU-Guaraní - BIOMA ==

===En SIU-Guaraní Gestión===
1) Configurar el parámetro '''usa_arai_gateway''' poniéndole '''Se utiliza el módulo Araí Gateway''', con esto se habilita la comunicación entre ambos módulos.

2) Configurar el parámetro '''gateway_id_institucion''' con el '''Identificador de la institución de Guaraní en Araí Gateway.'''.

3) Configurar el parámetro '''gateway_id_modulo''' con el '''Identificador del módulo de Guaraní en Araí Gateway.'''.

Ver los parámetros de [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.23.0/configuracion_del_sistema/parametros#Compartir_informaci.C3.B3n_entre_Instituciones Compartir información entre Instituciones].

4) Solicitar al administrador de '''Araí-Gateway (API Interna)''' 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/arai_gateway/cliente.ini</tt>
<source lang="ini" enclose="div">
;cliente.ini
[conexion]
to = "<url_arai_gateway_api_interna>/v1/"
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_arai_gateway_api_interna>: por la URL de la API Interna donde se encuentra '''Araí-Gateway'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Gateway'''
* <password>: Password otorgado por el administrador de '''Araí-Gateway'''

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

5) Programar la ejecución automática de los comandos '''bin/guarani worker_gateway_actualizar_paquetes''' y '''bin/guarani worker_gateway_procesar_novedades''':

'''bin/guarani worker_gateway_actualizar_paquetes''': Actualiza el estado de los paquetes que no estén finalizados.

'''bin/guarani worker_gateway_procesar_novedades''': Procesa novedades de paquetes disponibles para ser recibidas por el módulo.

===En SIU-Guaraní Autogestión===
1) Solicitar al administrador de '''Araí-Gateway (API Interna)''' 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_gateway' => [
'tipo' => 'rest',
'parametros' => [ //usa cliente Guzzle, son opciones en formato guzzle
'base_uri' => "<url_arai_gateway_api_interna>/v1/",
'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_arai_gateway_api_interna>: por la URL de la API Interna donde se encuentra '''Araí-Gateway'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Gateway'''
* <password>: Password otorgado por el administrador de '''Araí-Gateway'''
* <tipo-auth>: '''basic''' o '''digest'''. [http://docs.guzzlephp.org/en/stable/request-options.html#auth Ver documentación de Guzzle].

SIU-Guarani/version3.23.0/interfaces/bioma

2026-01-09T18:52:25Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
== Interfaz SIU-Guaraní - BIOMA ==

===En SIU-Guaraní Gestión===
1) Configurar el parámetro '''usa_arai_gateway''' poniéndole '''Se utiliza el módulo Araí Gateway''', con esto se habilita la comunicación entre ambos módulos.

2) Configurar el parámetro '''gateway_id_institucion''' con el '''Identificador de la institución de Guaraní en Araí Gateway.'''.

3) Configurar el parámetro '''gateway_id_modulo''' con el '''Identificador del módulo de Guaraní en Araí Gateway.'''.

Ver los parámetros de [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.23.0/configuracion_del_sistema/parametros#Compartir_informaci.C3.B3n_entre_Instituciones Compartir información entre Instituciones].

4) Solicitar al administrador de '''Araí-Gateway (API Interna)''' 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/arai_gateway/cliente.ini</tt>
<source lang="ini" enclose="div">
;cliente.ini
[conexion]
to = "<url_arai_gateway_api_interna>/v1/"
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_arai_gateway_api_interna>: por la URL de la API Interna donde se encuentra '''Araí-Gateway'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Gateway'''
* <password>: Password otorgado por el administrador de '''Araí-Gateway'''

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

4) Programar la ejecución automática de los comandos '''bin/guarani worker_gateway_actualizar_paquetes''' y '''bin/guarani worker_gateway_procesar_novedades'''

'''bin/guarani worker_gateway_actualizar_paquetes''': Actualiza el estado de los paquetes que no estén finalizados.

'''bin/guarani worker_gateway_procesar_novedades''': Procesa novedades de paquetes disponibles para ser recibidas por el módulo.

===En SIU-Guaraní Autogestión===
1) Solicitar al administrador de '''Araí-Gateway (API Interna)''' 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_gateway' => [
'tipo' => 'rest',
'parametros' => [ //usa cliente Guzzle, son opciones en formato guzzle
'base_uri' => "<url_arai_gateway_api_interna>/v1/",
'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_arai_gateway_api_interna>: por la URL de la API Interna donde se encuentra '''Araí-Gateway'''
* <usuario>: Usuario otorgado por el administrador de '''Araí-Gateway'''
* <password>: Password otorgado por el administrador de '''Araí-Gateway'''
* <tipo-auth>: '''basic''' o '''digest'''. [http://docs.guzzlephp.org/en/stable/request-options.html#auth Ver documentación de Guzzle].

SIU-Guarani/Version3.23.0/Novedades tecnicas preinscripcion

2026-01-09T16:46:13Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-09T16:45:13Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* [[SIU-Guarani/version3.23.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 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''

* Se cambia la forma de ejecutar '''Jasper''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/instalacion/gestion/linux | Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Desarrollo]] y [[SIU-Guarani/version3.23.0/instalacion/3w | Instalación de SIU-Guaraní 3w versión 3.23.x en entorno de Desarrollo o Producción]]:

<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>

</dd>

<div class="mw-collapsible-content">

== Interfaces con otros módulos SIU ==

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/bioma | BIOMA]].

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/arai-reportes | Araí-Reportes]].

== Interfaces con Sistemas externos ==

* Se adapta la conexión con [[SIU-Guarani/version3.23.0/interfaces/renaper | Renaper]].

== Gestión ==

* Se migró '''SIU TOBA Framework''' a la versión [https://github.com/SIU-Toba/framework/blob/v3.4.3/CHANGELOG.md v3.4.3].

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

* Se agregó [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_parametros_configuracion | Personalización de parámetros de configuración]] y [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_comandos_consola | Personalización de comandos de consola]].

</div></div>

SIU-Guarani/preinscripcion3.23.0/personalizacion

2026-01-09T16:25:32Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
== Personalizaciones ==

Preinscripción fue pensado para ser ampliamente configurable y personalizable sin necesidad de recodificación. Para ello se dispone de variables de configuración en el archivo "config.php" que afectan distintos comportamientos del sistema, y operaciones en el panel de administración que permiten definir para los campos de formulario, su visibilidad, obligatoriedad y si se imprimen o no en el comprobante. Si esto no alcanza para cubrir las necesidades, o si se desean realizar cambios de estilo (logo, colores, etc) se debe personalizar.

=== Preparar el proyecto para implementar personalizaciones ===

Para preparar el proyecto para implementar personalizaciones, seguir los siguientes pasos:
#En la carpeta "src/pers/" crear un subdirectorio para contener todos los archivos de personalización. Típicamente se suele nombrar a esa nueva carpeta con el nombre del nodo (siglas de la institucion).
#En el archivo de configuración '"config.php"' de la carpeta "instalacion", verificar que la variable "produccion" esté en "false". Esto es necesario para poder visualizar los cambios que se efectúen antes de pasar a producción.
#En el mismo archivo, establecer la variable "usar_personalizaciones" en "true".
#En el mismo archivo, en la sección "Configuración de puntos de acceso", setear la variable "personalizacion", que por defecto viene en NULL, con el nombre de la carpeta creado en el paso 1 (ej: "personalizacion" => "mi_institucion").
#:'''IMPORTANTE''': realizar este paso para la configuración de los bloques de acceso en los cuales se quiera personalizar.

A partir de este punto, el proyecto está preparado para ser personalizado.

Para personalizar algo, se debe buscar el archivo que se desea modificar y copiar sólo ese archivo en la carpeta de personalizaciones creada en el paso 1, respetando la estructura de directorios relativa. El motor de personalizaciones elegirá siempre en primer lugar el archivo personalizado antes que el entregado por el SIU, de allí la importancia de copiar sólo lo que se quiere cambiar y nada más.

=== Personalización de ejemplo ===

Junto con la distribución, se entrega una personalización de ejemplo (denominada, justamente, "ejemplo"). En la misma, se puede ver cómo personalizar algunas características del sistema.

==== Etiquetas y mensajes ====

Todo mensaje o etiqueta que se ve en pantalla o en el comprobante PDF que genera el alumno al finalizar el proceso, está definido en el archivo "mensajes.es.php", de la carpeta "src/siu/mensajes/".

Para cada mensaje o etiqueta, hay definida una entrada del tipo "<id_etiqueta>" => "<Descripción>" en ese archivo. Por ejemplo: "nombre_sistema" => "SIU-Preinscripción". Toda etiqueta es referenciada en el sistema por su ID, y un mecanismo de traducción busca en ese archivo la descripción correspondiente.

Por defecto, los mensajes están definidos en español, en un registro de confianza (voseo).

Para personalizarlo, lo que se debe hacer es crear un archivo "mensajes.es.php" en la estructura de carpetas "src/pers/mi_institucion/mensajes". En ese nuevo archivo, '''reescribir sólo las entradas que se deseen personalizar'''. Las incluidas en el archivo personalizado serán utilizadas en lugar de las originales.

<source lang="php" enclose="div">
src
|_ siu
| |_ mensajes
| |_ mensajes.es.php
|
|_ pers
|_ mi_institucion
|_ mensajes
|_ mensajes.es.php
</source>
Además, si se desea que algunas etiquetas de los campos de formulario se vean diferentes en el comprobante PDF respecto a cómo se ven en pantalla, se deben agregar al final del archivo entradas respetando la siguiente convención:

<source lang="php" enclose="div">
'pdf_<nombre_campo_original>' => '<Nueva etiqueta>',
</source>

Ejemplo: si se desea que para la etiqueta 'nro_documento' se imprima 'Nro. documento' en lugar de 'Número de documento' (como está definida para la salida en pantalla), agregar una entrada:

<source lang="php" enclose="div">
'pdf_nro_documento' => 'Nro. documento',
</source>

==== Logo de página y favicon ====

Una necesidad común puede ser cambiar el logo de página. El entregado por defecto tiene el nombre "logo-transparente.png", y está configurado en la variable "logo_pagina" del "config.php". Para cambiarlo, basta con crear la siguiente estructura de carpetas, y copiar el nuevo logo:

<source lang="php" enclose="div">
src
|_ siu
| |_ www
| |_ img
| |_ logo-transparente.png
|
|_ pers
|_ mi_institucion
|_ www
|_ img
|_ logo-transparente.png
</source>

Si se desea renombrar el nombre del archivo, ajustarlo en la variable "logo_pagina" del archivo de configuración.

De la misma manera, en la personalización de ejemplo se muestra que para cambiar el favicon (ícono de página) basta con guardar un archivo "favicon.ico" en la misma carpeta del logo.

Se debe tener una consideración especial con respecto al logo que se muestra en el encabezado de página del comprobante PDF. Por limitaciones de la librería EZPDF, utilizada para la generación, sólo se permiten archivos en formato PNG y sin canal alfa. El nombre del archivo se define por medio de la variable "rep_encabezado_logo" del "config.php".

==== Estilos ====

Si se desean personalizar los estilos, se debe crear un archivo "preinscripcion.css" en la ruta "src/pers/mi_institucion/www/css/" y redefinir sólo las clases css que se deseen cambiar, independientemente del archivo en el que se encuentra el estilo original. En la personalización de ejemplo, se redefine el color de los títulos, los colores de fondo de la cabecera y de los agrupados, y se agrega el estilo cursiva para los labels obligatorios.

==== Manejo de datos propios ====

En "src/pers/ejemplo/modelo/manejador_datos.php" se dejó un ejemplo documentado de cómo proceder en caso de tener que recolectar datos extra a los manejados por el SIU.

Ahí mismo se deja una sugerencia de manejo de la tabla anexa, con las claves foráneas y triggers recomendados para operar según lo que se documenta.

Se deben redefinir dos métodos (el que setea los datos y el que los obtiene) según la documentación inline presente en ese archivo.

==== Otros casos ====

En la personalización de ejemplo se muestra además cómo personalizar:

*El comprobante, más allá de las configuraciones que ya vienen definidas en "config.php". Se entrega el archivo "src/pers/ejemplo/operaciones/_comun/generador_pdf.php", que extiende del generador base entregado por el SIU, y redefine el encabezado (elimina el código QR y amplía el espacio para la foto), no genera las secciones "CBC", "Avisos", "Fecha y firma" y "Credencial provisoria" (independientemente de lo establecido en "config.php") y se cambia el orden de la sección "Datos de estudios" para que se muestre luego de "Datos personales".
*La cabecera de página. Se exhibe el logo a la derecha, y se muestra también el nombre y apellido de la persona logueada. Ver: "src/pers/ejemplo/operaciones/_comun/templates/header.twig"
*El layout y el estilo de una sección de la operación de carga de datos (Idiomas). Se redefine el ancho de los combos de selección vía css, se cambia el color de fondo de ese agrupado y se define un margen. Además, se personaliza la definición de los campos del formulario, para cambiar la clase css del campo "alu_idioma_otro" (form::clase_css => "input-xxlarge"). Los archivos se pueden ver en: "src/pers/ejemplo/operaciones/censo/idiomas/"

La salida html del proyecto se realiza en base al motor de plantillas twig. Se puede encontrar documentación online en http://twig.sensiolabs.org/

==== Personalización de scripts de Composer ====

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''src/pers/Composer.php''':

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

namespace pers;

use Composer\Script\Event;

class Composer
{
public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}
}
</source>

==== Personalización de parámetros de configuración ====

Se pueden agregar parámetros de configuración en '''instalacion/config.php''' dentro de la sección '''accesos''', ej:

<source lang="php" enclose="div">
'accesos' =>
[
'des01' =>
[
'personalizacion' => 'nombre_pers',
'clave_parametro_pers' => 'valor_parametro_pers',
],

],
</source>

Luego creamos la clase '''src/pers/nombre_pers/extension_kernel/proyecto.php''':

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

namespace nombre_pers\extension_kernel;

use siu\extension_kernel\proyecto as proyecto_siu;

class proyecto extends proyecto_siu
{

function get_parametro_pers()
{
$id_pto_acceso = $this->get('id_pto_acceso');
$accesos = $this->get('accesos');
return $accesos[$id_pto_acceso]['clave_parametro_pers'] ?? '';
}

}
</source>

Finalmente hacemos uso del parámetro de configuración personalizado:

<source lang="php" enclose="div">
$parametro_pers = kernel::proyecto()->get_parametro_pers();
</source>

Como referencia, puede ver la personalización dentro de la carpeta '''src/pers/ejemplo02/'''.

==== Personalización de comandos de consola ====

Se puede crear un nuevo comando, ej: '''src/pers/nombre_pers/util/consola/comandos/comando_pers.php'''

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

namespace nombre_pers\util\consola\comandos;

use Symfony\Component\Console;
use SIU\Chulupi\kernel;
use siu\util\consola\comandos\comando_guarani;

class comando_pers extends comando_guarani
{

/** @var Console\Input\InputInterface */
protected $input;
/** @var Console\Output\OutputInterface */
protected $output;

protected function configure()
{
$this
->setName('comando_pers')
->setDescription("Comando personalizado.")
->setHelp(sprintf(
"%sComando personalizado.%s",
PHP_EOL,
PHP_EOL
));
}

protected function execute(Console\Input\InputInterface $input, Console\Output\OutputInterface $output)
{
$this->input = $input;
$this->output = $output;

// Para que pueda colorear el output
$this->output->setDecorated(true);

$this->output->writeln("<info>Mensaje de información</info>");

$this->output->writeln("<comment>Comentario</comment>");

$this->output->writeln("<error>Mensaje de error</error>");

return 0;
}
}
</source>

Finalmente hay que agregar dicho comando al archivo '''src/pers/nombre_pers/util/consola/gadmin.php''':

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

namespace nombre_pers\util\consola;

use siu\util\consola\gadmin as gadmin_siu;

class gadmin extends gadmin_siu
{

public function __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
{
parent::__construct("SIU-Guaran\u{00ED} Pers", "3.23.0");

$this->addCommands([
new comandos\comando_pers(),
]);

}
}
</source>

Como referencia, puede ver la personalización dentro de la carpeta '''src/pers/ejemplo02/'''.

[[SIU-Guarani/preinscripcion3.23.0/documentacion_tecnica|< Volver]]

SIU-Guarani/preinscripcion3.23.0/personalizacion

2026-01-09T16:25:10Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
== Personalizaciones ==

Preinscripción fue pensado para ser ampliamente configurable y personalizable sin necesidad de recodificación. Para ello se dispone de variables de configuración en el archivo "config.php" que afectan distintos comportamientos del sistema, y operaciones en el panel de administración que permiten definir para los campos de formulario, su visibilidad, obligatoriedad y si se imprimen o no en el comprobante. Si esto no alcanza para cubrir las necesidades, o si se desean realizar cambios de estilo (logo, colores, etc) se debe personalizar.

=== Preparar el proyecto para implementar personalizaciones ===

Para preparar el proyecto para implementar personalizaciones, seguir los siguientes pasos:
#En la carpeta "src/pers/" crear un subdirectorio para contener todos los archivos de personalización. Típicamente se suele nombrar a esa nueva carpeta con el nombre del nodo (siglas de la institucion).
#En el archivo de configuración '"config.php"' de la carpeta "instalacion", verificar que la variable "produccion" esté en "false". Esto es necesario para poder visualizar los cambios que se efectúen antes de pasar a producción.
#En el mismo archivo, establecer la variable "usar_personalizaciones" en "true".
#En el mismo archivo, en la sección "Configuración de puntos de acceso", setear la variable "personalizacion", que por defecto viene en NULL, con el nombre de la carpeta creado en el paso 1 (ej: "personalizacion" => "mi_institucion").
#:'''IMPORTANTE''': realizar este paso para la configuración de los bloques de acceso en los cuales se quiera personalizar.

A partir de este punto, el proyecto está preparado para ser personalizado.

Para personalizar algo, se debe buscar el archivo que se desea modificar y copiar sólo ese archivo en la carpeta de personalizaciones creada en el paso 1, respetando la estructura de directorios relativa. El motor de personalizaciones elegirá siempre en primer lugar el archivo personalizado antes que el entregado por el SIU, de allí la importancia de copiar sólo lo que se quiere cambiar y nada más.

=== Personalización de ejemplo ===

Junto con la distribución, se entrega una personalización de ejemplo (denominada, justamente, "ejemplo"). En la misma, se puede ver cómo personalizar algunas características del sistema.

==== Etiquetas y mensajes ====

Todo mensaje o etiqueta que se ve en pantalla o en el comprobante PDF que genera el alumno al finalizar el proceso, está definido en el archivo "mensajes.es.php", de la carpeta "src/siu/mensajes/".

Para cada mensaje o etiqueta, hay definida una entrada del tipo "<id_etiqueta>" => "<Descripción>" en ese archivo. Por ejemplo: "nombre_sistema" => "SIU-Preinscripción". Toda etiqueta es referenciada en el sistema por su ID, y un mecanismo de traducción busca en ese archivo la descripción correspondiente.

Por defecto, los mensajes están definidos en español, en un registro de confianza (voseo).

Para personalizarlo, lo que se debe hacer es crear un archivo "mensajes.es.php" en la estructura de carpetas "src/pers/mi_institucion/mensajes". En ese nuevo archivo, '''reescribir sólo las entradas que se deseen personalizar'''. Las incluidas en el archivo personalizado serán utilizadas en lugar de las originales.

<source lang="php" enclose="div">
src
|_ siu
| |_ mensajes
| |_ mensajes.es.php
|
|_ pers
|_ mi_institucion
|_ mensajes
|_ mensajes.es.php
</source>
Además, si se desea que algunas etiquetas de los campos de formulario se vean diferentes en el comprobante PDF respecto a cómo se ven en pantalla, se deben agregar al final del archivo entradas respetando la siguiente convención:

<source lang="php" enclose="div">
'pdf_<nombre_campo_original>' => '<Nueva etiqueta>',
</source>

Ejemplo: si se desea que para la etiqueta 'nro_documento' se imprima 'Nro. documento' en lugar de 'Número de documento' (como está definida para la salida en pantalla), agregar una entrada:

<source lang="php" enclose="div">
'pdf_nro_documento' => 'Nro. documento',
</source>

==== Logo de página y favicon ====

Una necesidad común puede ser cambiar el logo de página. El entregado por defecto tiene el nombre "logo-transparente.png", y está configurado en la variable "logo_pagina" del "config.php". Para cambiarlo, basta con crear la siguiente estructura de carpetas, y copiar el nuevo logo:

<source lang="php" enclose="div">
src
|_ siu
| |_ www
| |_ img
| |_ logo-transparente.png
|
|_ pers
|_ mi_institucion
|_ www
|_ img
|_ logo-transparente.png
</source>

Si se desea renombrar el nombre del archivo, ajustarlo en la variable "logo_pagina" del archivo de configuración.

De la misma manera, en la personalización de ejemplo se muestra que para cambiar el favicon (ícono de página) basta con guardar un archivo "favicon.ico" en la misma carpeta del logo.

Se debe tener una consideración especial con respecto al logo que se muestra en el encabezado de página del comprobante PDF. Por limitaciones de la librería EZPDF, utilizada para la generación, sólo se permiten archivos en formato PNG y sin canal alfa. El nombre del archivo se define por medio de la variable "rep_encabezado_logo" del "config.php".

==== Estilos ====

Si se desean personalizar los estilos, se debe crear un archivo "preinscripcion.css" en la ruta "src/pers/mi_institucion/www/css/" y redefinir sólo las clases css que se deseen cambiar, independientemente del archivo en el que se encuentra el estilo original. En la personalización de ejemplo, se redefine el color de los títulos, los colores de fondo de la cabecera y de los agrupados, y se agrega el estilo cursiva para los labels obligatorios.

==== Manejo de datos propios ====

En "src/pers/ejemplo/modelo/manejador_datos.php" se dejó un ejemplo documentado de cómo proceder en caso de tener que recolectar datos extra a los manejados por el SIU.

Ahí mismo se deja una sugerencia de manejo de la tabla anexa, con las claves foráneas y triggers recomendados para operar según lo que se documenta.

Se deben redefinir dos métodos (el que setea los datos y el que los obtiene) según la documentación inline presente en ese archivo.

==== Otros casos ====

En la personalización de ejemplo se muestra además cómo personalizar:

*El comprobante, más allá de las configuraciones que ya vienen definidas en "config.php". Se entrega el archivo "src/pers/ejemplo/operaciones/_comun/generador_pdf.php", que extiende del generador base entregado por el SIU, y redefine el encabezado (elimina el código QR y amplía el espacio para la foto), no genera las secciones "CBC", "Avisos", "Fecha y firma" y "Credencial provisoria" (independientemente de lo establecido en "config.php") y se cambia el orden de la sección "Datos de estudios" para que se muestre luego de "Datos personales".
*La cabecera de página. Se exhibe el logo a la derecha, y se muestra también el nombre y apellido de la persona logueada. Ver: "src/pers/ejemplo/operaciones/_comun/templates/header.twig"
*El layout y el estilo de una sección de la operación de carga de datos (Idiomas). Se redefine el ancho de los combos de selección vía css, se cambia el color de fondo de ese agrupado y se define un margen. Además, se personaliza la definición de los campos del formulario, para cambiar la clase css del campo "alu_idioma_otro" (form::clase_css => "input-xxlarge"). Los archivos se pueden ver en: "src/pers/ejemplo/operaciones/censo/idiomas/"

La salida html del proyecto se realiza en base al motor de plantillas twig. Se puede encontrar documentación online en http://twig.sensiolabs.org/

==== Personalización de scripts de Composer ====

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''src/pers/Composer.php''':

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

namespace pers;

use Composer\Script\Event;

class Composer
{
public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}
}
</source>

==== Personalización de parámetros de configuración ====

Se pueden agregar parámetros de configuración en '''instalacion/config.php''' dentro de la sección '''accesos''', ej:

<source lang="php" enclose="div">
'accesos' =>
[
'des01' =>
[
'personalizacion' => 'nombre_pers',
'clave_parametro_pers' => 'valor_parametro_pers',
],

],
</source>

Luego creamos la clase '''src/pers/nombre_pers/extension_kernel/proyecto.php''':

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

namespace nombre_pers\extension_kernel;

use siu\extension_kernel\proyecto as proyecto_siu;

class proyecto extends proyecto_siu
{

function get_parametro_pers()
{
$id_pto_acceso = $this->get('id_pto_acceso');
$accesos = $this->get('accesos');
return $accesos[$id_pto_acceso]['clave_parametro_pers'] ?? '';
}

}
</source>

Finalmente hacemos uso del parámetro de configuración personalizado:

<source lang="php" enclose="div">
$parametro_pers = kernel::proyecto()->get_parametro_pers();
</source>

==== Personalización de comandos de consola ====

Se puede crear un nuevo comando, ej: '''src/pers/nombre_pers/util/consola/comandos/comando_pers.php'''

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

namespace nombre_pers\util\consola\comandos;

use Symfony\Component\Console;
use SIU\Chulupi\kernel;
use siu\util\consola\comandos\comando_guarani;

class comando_pers extends comando_guarani
{

/** @var Console\Input\InputInterface */
protected $input;
/** @var Console\Output\OutputInterface */
protected $output;

protected function configure()
{
$this
->setName('comando_pers')
->setDescription("Comando personalizado.")
->setHelp(sprintf(
"%sComando personalizado.%s",
PHP_EOL,
PHP_EOL
));
}

protected function execute(Console\Input\InputInterface $input, Console\Output\OutputInterface $output)
{
$this->input = $input;
$this->output = $output;

// Para que pueda colorear el output
$this->output->setDecorated(true);

$this->output->writeln("<info>Mensaje de información</info>");

$this->output->writeln("<comment>Comentario</comment>");

$this->output->writeln("<error>Mensaje de error</error>");

return 0;
}
}
</source>

Finalmente hay que agregar dicho comando al archivo '''src/pers/nombre_pers/util/consola/gadmin.php''':

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

namespace nombre_pers\util\consola;

use siu\util\consola\gadmin as gadmin_siu;

class gadmin extends gadmin_siu
{

public function __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
{
parent::__construct("SIU-Guaran\u{00ED} Pers", "3.23.0");

$this->addCommands([
new comandos\comando_pers(),
]);

}
}
</source>

Como referencia, puede ver la personalización dentro de la carpeta '''src/pers/ejemplo02/'''.

[[SIU-Guarani/preinscripcion3.23.0/documentacion_tecnica|< Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion parametros configuracion

2026-01-09T16:24:27Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de parámetros de configuración ==

Se pueden agregar parámetros de configuración en '''instalacion/config.php''' dentro de la sección '''accesos''', ej:

<source lang="php" enclose="div">
'accesos' =>
[
'des01' =>
[
'personalizacion' => 'nombre_pers',
'clave_parametro_pers' => 'valor_parametro_pers',
],

],
</source>

Luego creamos la clase '''src/pers/nombre_pers/extension_kernel/proyecto.php''':

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

namespace nombre_pers\extension_kernel;

use siu\extension_kernel\proyecto as proyecto_siu;

class proyecto extends proyecto_siu
{

function get_parametro_pers()
{
$id_pto_acceso = $this->get('id_pto_acceso');
$accesos = $this->get('accesos');
return $accesos[$id_pto_acceso]['clave_parametro_pers'] ?? '';
}

}
</source>

Finalmente hacemos uso del parámetro de configuración personalizado:

<source lang="php" enclose="div">
$parametro_pers = kernel::proyecto()->get_parametro_pers();
</source>

Como referencia, puede ver la personalización dentro de la carpeta '''src/pers/ejemplo04/'''.

[[SIU-Guarani/version3.23.0/personalizacion|🔙 Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion comandos consola

2026-01-09T16:24:01Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de comandos de consola ==

Se puede crear un nuevo comando, ej: '''src/pers/nombre_pers/util/consola/comandos/comando_pers.php'''

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

namespace nombre_pers\util\consola\comandos;

use Symfony\Component\Console;
use SIU\Chulupi\kernel;
use siu\util\consola\comandos\comando_guarani;

class comando_pers extends comando_guarani
{

/** @var Console\Input\InputInterface */
protected $input;
/** @var Console\Output\OutputInterface */
protected $output;

protected function configure()
{
$this
->setName('comando_pers')
->setDescription("Comando personalizado.")
->setHelp(sprintf(
"%sComando personalizado.%s",
PHP_EOL,
PHP_EOL
));
}

protected function execute(Console\Input\InputInterface $input, Console\Output\OutputInterface $output)
{
$this->input = $input;
$this->output = $output;

// Para que pueda colorear el output
$this->output->setDecorated(true);

$this->output->writeln("<info>Mensaje de información</info>");

$this->output->writeln("<comment>Comentario</comment>");

$this->output->writeln("<error>Mensaje de error</error>");

return 0;
}
}
</source>

Finalmente hay que agregar dicho comando al archivo '''src/pers/nombre_pers/util/consola/gadmin.php''':

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

namespace nombre_pers\util\consola;

use siu\util\consola\gadmin as gadmin_siu;

class gadmin extends gadmin_siu
{

public function __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
{
parent::__construct("SIU-Guaran\u{00ED} Pers", "3.23.0");

$this->addCommands([
new comandos\comando_pers(),
]);

}
}
</source>

Como referencia, puede ver la personalización dentro de la carpeta '''src/pers/ejemplo04/'''.

[[SIU-Guarani/version3.23.0/personalizacion|🔙 Volver]]

SIU-Guarani/preinscripcion3.23.0/personalizacion

2026-01-09T16:19:12Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
== Personalizaciones ==

Preinscripción fue pensado para ser ampliamente configurable y personalizable sin necesidad de recodificación. Para ello se dispone de variables de configuración en el archivo "config.php" que afectan distintos comportamientos del sistema, y operaciones en el panel de administración que permiten definir para los campos de formulario, su visibilidad, obligatoriedad y si se imprimen o no en el comprobante. Si esto no alcanza para cubrir las necesidades, o si se desean realizar cambios de estilo (logo, colores, etc) se debe personalizar.

=== Preparar el proyecto para implementar personalizaciones ===

Para preparar el proyecto para implementar personalizaciones, seguir los siguientes pasos:
#En la carpeta "src/pers/" crear un subdirectorio para contener todos los archivos de personalización. Típicamente se suele nombrar a esa nueva carpeta con el nombre del nodo (siglas de la institucion).
#En el archivo de configuración '"config.php"' de la carpeta "instalacion", verificar que la variable "produccion" esté en "false". Esto es necesario para poder visualizar los cambios que se efectúen antes de pasar a producción.
#En el mismo archivo, establecer la variable "usar_personalizaciones" en "true".
#En el mismo archivo, en la sección "Configuración de puntos de acceso", setear la variable "personalizacion", que por defecto viene en NULL, con el nombre de la carpeta creado en el paso 1 (ej: "personalizacion" => "mi_institucion").
#:'''IMPORTANTE''': realizar este paso para la configuración de los bloques de acceso en los cuales se quiera personalizar.

A partir de este punto, el proyecto está preparado para ser personalizado.

Para personalizar algo, se debe buscar el archivo que se desea modificar y copiar sólo ese archivo en la carpeta de personalizaciones creada en el paso 1, respetando la estructura de directorios relativa. El motor de personalizaciones elegirá siempre en primer lugar el archivo personalizado antes que el entregado por el SIU, de allí la importancia de copiar sólo lo que se quiere cambiar y nada más.

=== Personalización de ejemplo ===

Junto con la distribución, se entrega una personalización de ejemplo (denominada, justamente, "ejemplo"). En la misma, se puede ver cómo personalizar algunas características del sistema.

==== Etiquetas y mensajes ====

Todo mensaje o etiqueta que se ve en pantalla o en el comprobante PDF que genera el alumno al finalizar el proceso, está definido en el archivo "mensajes.es.php", de la carpeta "src/siu/mensajes/".

Para cada mensaje o etiqueta, hay definida una entrada del tipo "<id_etiqueta>" => "<Descripción>" en ese archivo. Por ejemplo: "nombre_sistema" => "SIU-Preinscripción". Toda etiqueta es referenciada en el sistema por su ID, y un mecanismo de traducción busca en ese archivo la descripción correspondiente.

Por defecto, los mensajes están definidos en español, en un registro de confianza (voseo).

Para personalizarlo, lo que se debe hacer es crear un archivo "mensajes.es.php" en la estructura de carpetas "src/pers/mi_institucion/mensajes". En ese nuevo archivo, '''reescribir sólo las entradas que se deseen personalizar'''. Las incluidas en el archivo personalizado serán utilizadas en lugar de las originales.

<source lang="php" enclose="div">
src
|_ siu
| |_ mensajes
| |_ mensajes.es.php
|
|_ pers
|_ mi_institucion
|_ mensajes
|_ mensajes.es.php
</source>
Además, si se desea que algunas etiquetas de los campos de formulario se vean diferentes en el comprobante PDF respecto a cómo se ven en pantalla, se deben agregar al final del archivo entradas respetando la siguiente convención:

<source lang="php" enclose="div">
'pdf_<nombre_campo_original>' => '<Nueva etiqueta>',
</source>

Ejemplo: si se desea que para la etiqueta 'nro_documento' se imprima 'Nro. documento' en lugar de 'Número de documento' (como está definida para la salida en pantalla), agregar una entrada:

<source lang="php" enclose="div">
'pdf_nro_documento' => 'Nro. documento',
</source>

==== Logo de página y favicon ====

Una necesidad común puede ser cambiar el logo de página. El entregado por defecto tiene el nombre "logo-transparente.png", y está configurado en la variable "logo_pagina" del "config.php". Para cambiarlo, basta con crear la siguiente estructura de carpetas, y copiar el nuevo logo:

<source lang="php" enclose="div">
src
|_ siu
| |_ www
| |_ img
| |_ logo-transparente.png
|
|_ pers
|_ mi_institucion
|_ www
|_ img
|_ logo-transparente.png
</source>

Si se desea renombrar el nombre del archivo, ajustarlo en la variable "logo_pagina" del archivo de configuración.

De la misma manera, en la personalización de ejemplo se muestra que para cambiar el favicon (ícono de página) basta con guardar un archivo "favicon.ico" en la misma carpeta del logo.

Se debe tener una consideración especial con respecto al logo que se muestra en el encabezado de página del comprobante PDF. Por limitaciones de la librería EZPDF, utilizada para la generación, sólo se permiten archivos en formato PNG y sin canal alfa. El nombre del archivo se define por medio de la variable "rep_encabezado_logo" del "config.php".

==== Estilos ====

Si se desean personalizar los estilos, se debe crear un archivo "preinscripcion.css" en la ruta "src/pers/mi_institucion/www/css/" y redefinir sólo las clases css que se deseen cambiar, independientemente del archivo en el que se encuentra el estilo original. En la personalización de ejemplo, se redefine el color de los títulos, los colores de fondo de la cabecera y de los agrupados, y se agrega el estilo cursiva para los labels obligatorios.

==== Manejo de datos propios ====

En "src/pers/ejemplo/modelo/manejador_datos.php" se dejó un ejemplo documentado de cómo proceder en caso de tener que recolectar datos extra a los manejados por el SIU.

Ahí mismo se deja una sugerencia de manejo de la tabla anexa, con las claves foráneas y triggers recomendados para operar según lo que se documenta.

Se deben redefinir dos métodos (el que setea los datos y el que los obtiene) según la documentación inline presente en ese archivo.

==== Otros casos ====

En la personalización de ejemplo se muestra además cómo personalizar:

*El comprobante, más allá de las configuraciones que ya vienen definidas en "config.php". Se entrega el archivo "src/pers/ejemplo/operaciones/_comun/generador_pdf.php", que extiende del generador base entregado por el SIU, y redefine el encabezado (elimina el código QR y amplía el espacio para la foto), no genera las secciones "CBC", "Avisos", "Fecha y firma" y "Credencial provisoria" (independientemente de lo establecido en "config.php") y se cambia el orden de la sección "Datos de estudios" para que se muestre luego de "Datos personales".
*La cabecera de página. Se exhibe el logo a la derecha, y se muestra también el nombre y apellido de la persona logueada. Ver: "src/pers/ejemplo/operaciones/_comun/templates/header.twig"
*El layout y el estilo de una sección de la operación de carga de datos (Idiomas). Se redefine el ancho de los combos de selección vía css, se cambia el color de fondo de ese agrupado y se define un margen. Además, se personaliza la definición de los campos del formulario, para cambiar la clase css del campo "alu_idioma_otro" (form::clase_css => "input-xxlarge"). Los archivos se pueden ver en: "src/pers/ejemplo/operaciones/censo/idiomas/"

La salida html del proyecto se realiza en base al motor de plantillas twig. Se puede encontrar documentación online en http://twig.sensiolabs.org/

==== Personalización de scripts de Composer ====

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''src/pers/Composer.php''':

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

namespace pers;

use Composer\Script\Event;

class Composer
{
public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}
}
</source>

==== Personalización de parámetros de configuración ====

Se pueden agregar parámetros de configuración en '''instalacion/config.php''' dentro de la sección '''accesos''', ej:

<source lang="php" enclose="div">
'accesos' =>
[
'des01' =>
[
'personalizacion' => 'nombre_pers',
'clave_parametro_pers' => 'valor_parametro_pers',
],

],
</source>

Luego creamos la clase '''src/pers/nombre_pers/extension_kernel/proyecto.php''':

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

namespace nombre_pers\extension_kernel;

use siu\extension_kernel\proyecto as proyecto_siu;

class proyecto extends proyecto_siu
{

function get_parametro_pers()
{
$id_pto_acceso = $this->get('id_pto_acceso');
$accesos = $this->get('accesos');
return $accesos[$id_pto_acceso]['clave_parametro_pers'] ?? '';
}

}
</source>

Finalmente hacemos uso del parámetro de configuración personalizado:

<source lang="php" enclose="div">
$parametro_pers = kernel::proyecto()->get_parametro_pers();
</source>

==== Personalización de comandos de consola ====

Se puede crear un nuevo comando, ej: '''src/pers/nombre_pers/util/consola/comandos/comando_pers.php'''

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

namespace nombre_pers\util\consola\comandos;

use Symfony\Component\Console;
use SIU\Chulupi\kernel;
use siu\util\consola\comandos\comando_guarani;

class comando_pers extends comando_guarani
{

/** @var Console\Input\InputInterface */
protected $input;
/** @var Console\Output\OutputInterface */
protected $output;

protected function configure()
{
$this
->setName('comando_pers')
->setDescription("Comando personalizado.")
->setHelp(sprintf(
"%sComando personalizado.%s",
PHP_EOL,
PHP_EOL
));
}

protected function execute(Console\Input\InputInterface $input, Console\Output\OutputInterface $output)
{
$this->input = $input;
$this->output = $output;

// Para que pueda colorear el output
$this->output->setDecorated(true);

$this->output->writeln("<info>Mensaje de información</info>");

$this->output->writeln("<comment>Comentario</comment>");

$this->output->writeln("<error>Mensaje de error</error>");

return 0;
}
}
</source>

Finalmente hay que agregar dicho comando al archivo '''src/pers/nombre_pers/util/consola/gadmin.php''':

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

namespace nombre_pers\util\consola;

use siu\util\consola\gadmin as gadmin_siu;

class gadmin extends gadmin_siu
{

public function __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
{
parent::__construct("SIU-Guaran\u{00ED} Pers", "3.23.0");

$this->addCommands([
new comandos\comando_pers(),
]);

}
}
</source>

[[SIU-Guarani/preinscripcion3.23.0/documentacion_tecnica|< Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion comandos consola

2026-01-09T16:17:46Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de comandos de consola ==

Se puede crear un nuevo comando, ej: '''src/pers/nombre_pers/util/consola/comandos/comando_pers.php'''

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

namespace nombre_pers\util\consola\comandos;

use Symfony\Component\Console;
use SIU\Chulupi\kernel;
use siu\util\consola\comandos\comando_guarani;

class comando_pers extends comando_guarani
{

/** @var Console\Input\InputInterface */
protected $input;
/** @var Console\Output\OutputInterface */
protected $output;

protected function configure()
{
$this
->setName('comando_pers')
->setDescription("Comando personalizado.")
->setHelp(sprintf(
"%sComando personalizado.%s",
PHP_EOL,
PHP_EOL
));
}

protected function execute(Console\Input\InputInterface $input, Console\Output\OutputInterface $output)
{
$this->input = $input;
$this->output = $output;

// Para que pueda colorear el output
$this->output->setDecorated(true);

$this->output->writeln("<info>Mensaje de información</info>");

$this->output->writeln("<comment>Comentario</comment>");

$this->output->writeln("<error>Mensaje de error</error>");

return 0;
}
}
</source>

Finalmente hay que agregar dicho comando al archivo '''src/pers/nombre_pers/util/consola/gadmin.php''':

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

namespace nombre_pers\util\consola;

use siu\util\consola\gadmin as gadmin_siu;

class gadmin extends gadmin_siu
{

public function __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
{
parent::__construct("SIU-Guaran\u{00ED} Pers", "3.23.0");

$this->addCommands([
new comandos\comando_pers(),
]);

}
}
</source>

[[SIU-Guarani/version3.23.0/personalizacion|🔙 Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion comandos consola

2026-01-09T16:17:01Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de comandos de consola ==

Se puede crear un nuevo comando, ej: '''src/pers/nombre_pers/util/consola/comandos/comando_pers.php'''

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

namespace nombre_pers\util\consola\comandos;

use Symfony\Component\Console;
use SIU\Chulupi\kernel;
use siu\util\consola\comandos\comando_guarani;

class comando_pers extends comando_guarani
{

/** @var Console\Input\InputInterface */
protected $input;
/** @var Console\Output\OutputInterface */
protected $output;

protected function configure()
{
$this
->setName('comando_pers')
->setDescription("Comando personalizado.")
->setHelp(sprintf(
"%sComando personalizado.%s",
PHP_EOL,
PHP_EOL
));
}

protected function execute(Console\Input\InputInterface $input, Console\Output\OutputInterface $output)
{
$this->input = $input;
$this->output = $output;

// Para que pueda colorear el output
$this->output->setDecorated(true);

$this->output->writeln("<info>Mensaje de información<info>");

$this->output->writeln("<comment>Comentario</comment>");

$this->output->writeln("<error>Mensaje de error</error>");

return 0;
}
}
</source>

Finalmente hay que agregar el comando al archivo '''src/pers/nombre_pers/util/consola/gadmin.php''':

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

namespace nombre_pers\util\consola;

use siu\util\consola\gadmin as gadmin_siu;

class gadmin extends gadmin_siu
{

public function __construct(string $name = 'UNKNOWN', string $version = 'UNKNOWN')
{
parent::__construct("SIU-Guaran\u{00ED} Pers", "3.23.0");

$this->addCommands([
new comandos\comando_pers(),
]);

}
}
</source>

[[SIU-Guarani/version3.23.0/personalizacion|🔙 Volver]]

SIU-Guarani/version3.23.0/personalizacion

2026-01-09T16:08:44Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
== ¿Cómo personalizo el sistema? ==
=== Personalizaciones en Gestión ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/activar_personalizaciones|Activar personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/trabajo_diario|Trabajo diario con personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/procesos_personalizables|Procesos que se pueden personalizar]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/formas_de_menu|Distintas formas de ver el menú]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/manejo_de_perfiles|Manejo de perfiles]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizaciones_gestion|Personalizaciones en Gestión]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/cambiar_logo|Cambiar el logo de la Institución]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/requisito_proceso|Crear un requisito de tipo proceso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/instancias|Agregar una nueva Instancia de Examen]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_actividad|Agregar nuevo tipo de Actividad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_propuesta|Agregar nuevo tipo de Propuesta]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/constancias|Personalizar impresiones - Constancias y Certificados]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte|Personalizar un reporte]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte_alumnos|Personalizar Reporte de Alumnos - columnas opcionales]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/extender_tablas|Extender tablas]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/circuito_egreso|Editar Circuito de Egreso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/suplemento|Personalizar Suplemento del Título]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/bitacora_alumno|Personalizar Bitácora del Alumno]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/rest|Personalizar servicios REST]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscCursada|Criterios de ordenamiento de alumnos para el procesamiento de inscripciones a actividades por prioridad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscIngresantes|Criterios de ordenamiento de alumnos ingresantes para las inscripciones a actividades de 1er año]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_scripts_composer_gestion|Personalización de scripts de Composer]]

=== Personalizaciones en 3w ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_chulupi|Esquema de personalización del Framework Chulupí]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/creacion_operacion_3w|Ejemplo de la creación de una operación]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/operaciones_en_zonas|Operaciones dentro de las zonas]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_de_acceso|Personalización de acceso]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_scripts_composer|Personalización de scripts de Composer]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_parametros_configuracion|Personalización de parámetros de configuración]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_comandos_consola|Personalización de comandos de consola]]


[[SIU-Guarani/Version3.23.0|< Volver]]

SIU-Guarani/preinscripcion3.23.0/personalizacion

2026-01-09T14:49:55Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
== Personalizaciones ==

Preinscripción fue pensado para ser ampliamente configurable y personalizable sin necesidad de recodificación. Para ello se dispone de variables de configuración en el archivo "config.php" que afectan distintos comportamientos del sistema, y operaciones en el panel de administración que permiten definir para los campos de formulario, su visibilidad, obligatoriedad y si se imprimen o no en el comprobante. Si esto no alcanza para cubrir las necesidades, o si se desean realizar cambios de estilo (logo, colores, etc) se debe personalizar.

=== Preparar el proyecto para implementar personalizaciones ===

Para preparar el proyecto para implementar personalizaciones, seguir los siguientes pasos:
#En la carpeta "src/pers/" crear un subdirectorio para contener todos los archivos de personalización. Típicamente se suele nombrar a esa nueva carpeta con el nombre del nodo (siglas de la institucion).
#En el archivo de configuración '"config.php"' de la carpeta "instalacion", verificar que la variable "produccion" esté en "false". Esto es necesario para poder visualizar los cambios que se efectúen antes de pasar a producción.
#En el mismo archivo, establecer la variable "usar_personalizaciones" en "true".
#En el mismo archivo, en la sección "Configuración de puntos de acceso", setear la variable "personalizacion", que por defecto viene en NULL, con el nombre de la carpeta creado en el paso 1 (ej: "personalizacion" => "mi_institucion").
#:'''IMPORTANTE''': realizar este paso para la configuración de los bloques de acceso en los cuales se quiera personalizar.

A partir de este punto, el proyecto está preparado para ser personalizado.

Para personalizar algo, se debe buscar el archivo que se desea modificar y copiar sólo ese archivo en la carpeta de personalizaciones creada en el paso 1, respetando la estructura de directorios relativa. El motor de personalizaciones elegirá siempre en primer lugar el archivo personalizado antes que el entregado por el SIU, de allí la importancia de copiar sólo lo que se quiere cambiar y nada más.

=== Personalización de ejemplo ===

Junto con la distribución, se entrega una personalización de ejemplo (denominada, justamente, "ejemplo"). En la misma, se puede ver cómo personalizar algunas características del sistema.

==== Etiquetas y mensajes ====

Todo mensaje o etiqueta que se ve en pantalla o en el comprobante PDF que genera el alumno al finalizar el proceso, está definido en el archivo "mensajes.es.php", de la carpeta "src/siu/mensajes/".

Para cada mensaje o etiqueta, hay definida una entrada del tipo "<id_etiqueta>" => "<Descripción>" en ese archivo. Por ejemplo: "nombre_sistema" => "SIU-Preinscripción". Toda etiqueta es referenciada en el sistema por su ID, y un mecanismo de traducción busca en ese archivo la descripción correspondiente.

Por defecto, los mensajes están definidos en español, en un registro de confianza (voseo).

Para personalizarlo, lo que se debe hacer es crear un archivo "mensajes.es.php" en la estructura de carpetas "src/pers/mi_institucion/mensajes". En ese nuevo archivo, '''reescribir sólo las entradas que se deseen personalizar'''. Las incluidas en el archivo personalizado serán utilizadas en lugar de las originales.

<source lang="php" enclose="div">
src
|_ siu
| |_ mensajes
| |_ mensajes.es.php
|
|_ pers
|_ mi_institucion
|_ mensajes
|_ mensajes.es.php
</source>
Además, si se desea que algunas etiquetas de los campos de formulario se vean diferentes en el comprobante PDF respecto a cómo se ven en pantalla, se deben agregar al final del archivo entradas respetando la siguiente convención:

<source lang="php" enclose="div">
'pdf_<nombre_campo_original>' => '<Nueva etiqueta>',
</source>

Ejemplo: si se desea que para la etiqueta 'nro_documento' se imprima 'Nro. documento' en lugar de 'Número de documento' (como está definida para la salida en pantalla), agregar una entrada:

<source lang="php" enclose="div">
'pdf_nro_documento' => 'Nro. documento',
</source>

==== Logo de página y favicon ====

Una necesidad común puede ser cambiar el logo de página. El entregado por defecto tiene el nombre "logo-transparente.png", y está configurado en la variable "logo_pagina" del "config.php". Para cambiarlo, basta con crear la siguiente estructura de carpetas, y copiar el nuevo logo:

<source lang="php" enclose="div">
src
|_ siu
| |_ www
| |_ img
| |_ logo-transparente.png
|
|_ pers
|_ mi_institucion
|_ www
|_ img
|_ logo-transparente.png
</source>

Si se desea renombrar el nombre del archivo, ajustarlo en la variable "logo_pagina" del archivo de configuración.

De la misma manera, en la personalización de ejemplo se muestra que para cambiar el favicon (ícono de página) basta con guardar un archivo "favicon.ico" en la misma carpeta del logo.

Se debe tener una consideración especial con respecto al logo que se muestra en el encabezado de página del comprobante PDF. Por limitaciones de la librería EZPDF, utilizada para la generación, sólo se permiten archivos en formato PNG y sin canal alfa. El nombre del archivo se define por medio de la variable "rep_encabezado_logo" del "config.php".

==== Estilos ====

Si se desean personalizar los estilos, se debe crear un archivo "preinscripcion.css" en la ruta "src/pers/mi_institucion/www/css/" y redefinir sólo las clases css que se deseen cambiar, independientemente del archivo en el que se encuentra el estilo original. En la personalización de ejemplo, se redefine el color de los títulos, los colores de fondo de la cabecera y de los agrupados, y se agrega el estilo cursiva para los labels obligatorios.

==== Manejo de datos propios ====

En "src/pers/ejemplo/modelo/manejador_datos.php" se dejó un ejemplo documentado de cómo proceder en caso de tener que recolectar datos extra a los manejados por el SIU.

Ahí mismo se deja una sugerencia de manejo de la tabla anexa, con las claves foráneas y triggers recomendados para operar según lo que se documenta.

Se deben redefinir dos métodos (el que setea los datos y el que los obtiene) según la documentación inline presente en ese archivo.

==== Otros casos ====

En la personalización de ejemplo se muestra además cómo personalizar:

*El comprobante, más allá de las configuraciones que ya vienen definidas en "config.php". Se entrega el archivo "src/pers/ejemplo/operaciones/_comun/generador_pdf.php", que extiende del generador base entregado por el SIU, y redefine el encabezado (elimina el código QR y amplía el espacio para la foto), no genera las secciones "CBC", "Avisos", "Fecha y firma" y "Credencial provisoria" (independientemente de lo establecido en "config.php") y se cambia el orden de la sección "Datos de estudios" para que se muestre luego de "Datos personales".
*La cabecera de página. Se exhibe el logo a la derecha, y se muestra también el nombre y apellido de la persona logueada. Ver: "src/pers/ejemplo/operaciones/_comun/templates/header.twig"
*El layout y el estilo de una sección de la operación de carga de datos (Idiomas). Se redefine el ancho de los combos de selección vía css, se cambia el color de fondo de ese agrupado y se define un margen. Además, se personaliza la definición de los campos del formulario, para cambiar la clase css del campo "alu_idioma_otro" (form::clase_css => "input-xxlarge"). Los archivos se pueden ver en: "src/pers/ejemplo/operaciones/censo/idiomas/"

La salida html del proyecto se realiza en base al motor de plantillas twig. Se puede encontrar documentación online en http://twig.sensiolabs.org/

==== Personalización de scripts de Composer ====

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''src/pers/Composer.php''':

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

namespace pers;

use Composer\Script\Event;

class Composer
{
public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}
}
</source>

==== Personalización de parámetros de configuración ====

Se pueden agregar parámetros de configuración en '''instalacion/config.php''' dentro de la sección '''accesos''', ej:

<source lang="php" enclose="div">
'accesos' =>
[
'des01' =>
[
'personalizacion' => 'nombre_pers',
'clave_parametro_pers' => 'valor_parametro_pers',
],

],
</source>

Luego creamos la clase '''src/pers/nombre_pers/extension_kernel/proyecto.php''':

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

namespace nombre_pers\extension_kernel;

use siu\extension_kernel\proyecto as proyecto_siu;

class proyecto extends proyecto_siu
{

function get_parametro_pers()
{
$id_pto_acceso = $this->get('id_pto_acceso');
$accesos = $this->get('accesos');
return $accesos[$id_pto_acceso]['clave_parametro_pers'] ?? '';
}

}
</source>

Finalmente hacemos uso del parámetro de configuración personalizado:

<source lang="php" enclose="div">
$parametro_pers = kernel::proyecto()->get_parametro_pers();
</source>

[[SIU-Guarani/preinscripcion3.23.0/documentacion_tecnica|< Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion parametros configuracion

2026-01-09T14:45:52Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de parámetros de configuración ==

Se pueden agregar parámetros de configuración en '''instalacion/config.php''' dentro de la sección '''accesos''', ej:

<source lang="php" enclose="div">
'accesos' =>
[
'des01' =>
[
'personalizacion' => 'nombre_pers',
'clave_parametro_pers' => 'valor_parametro_pers',
],

],
</source>

Luego creamos la clase '''src/pers/nombre_pers/extension_kernel/proyecto.php''':

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

namespace nombre_pers\extension_kernel;

use siu\extension_kernel\proyecto as proyecto_siu;

class proyecto extends proyecto_siu
{

function get_parametro_pers()
{
$id_pto_acceso = $this->get('id_pto_acceso');
$accesos = $this->get('accesos');
return $accesos[$id_pto_acceso]['clave_parametro_pers'] ?? '';
}

}
</source>

Finalmente hacemos uso del parámetro de configuración personalizado:

<source lang="php" enclose="div">
$parametro_pers = kernel::proyecto()->get_parametro_pers();
</source>

[[SIU-Guarani/version3.23.0/personalizacion|🔙 Volver]]

SIU-Guarani/version3.23.0/personalizacion

2026-01-09T14:36:13Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
== ¿Cómo personalizo el sistema? ==
=== Personalizaciones en Gestión ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/activar_personalizaciones|Activar personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/trabajo_diario|Trabajo diario con personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/procesos_personalizables|Procesos que se pueden personalizar]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/formas_de_menu|Distintas formas de ver el menú]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/manejo_de_perfiles|Manejo de perfiles]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizaciones_gestion|Personalizaciones en Gestión]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/cambiar_logo|Cambiar el logo de la Institución]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/requisito_proceso|Crear un requisito de tipo proceso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/instancias|Agregar una nueva Instancia de Examen]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_actividad|Agregar nuevo tipo de Actividad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_propuesta|Agregar nuevo tipo de Propuesta]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/constancias|Personalizar impresiones - Constancias y Certificados]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte|Personalizar un reporte]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte_alumnos|Personalizar Reporte de Alumnos - columnas opcionales]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/extender_tablas|Extender tablas]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/circuito_egreso|Editar Circuito de Egreso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/suplemento|Personalizar Suplemento del Título]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/bitacora_alumno|Personalizar Bitácora del Alumno]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/rest|Personalizar servicios REST]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscCursada|Criterios de ordenamiento de alumnos para el procesamiento de inscripciones a actividades por prioridad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscIngresantes|Criterios de ordenamiento de alumnos ingresantes para las inscripciones a actividades de 1er año]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_scripts_composer_gestion|Personalización de scripts de Composer]]

=== Personalizaciones en 3w ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_chulupi|Esquema de personalización del Framework Chulupí]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/creacion_operacion_3w|Ejemplo de la creación de una operación]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/operaciones_en_zonas|Operaciones dentro de las zonas]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_de_acceso|Personalización de acceso]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_scripts_composer|Personalización de scripts de Composer]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_parametros_configuracion|Personalización de parámetros de configuración]]


[[SIU-Guarani/Version3.23.0|< Volver]]

SIU-Guarani/preinscripcion3.23.0/personalizacion

2026-01-09T13:47:26Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
== Personalizaciones ==

Preinscripción fue pensado para ser ampliamente configurable y personalizable sin necesidad de recodificación. Para ello se dispone de variables de configuración en el archivo "config.php" que afectan distintos comportamientos del sistema, y operaciones en el panel de administración que permiten definir para los campos de formulario, su visibilidad, obligatoriedad y si se imprimen o no en el comprobante. Si esto no alcanza para cubrir las necesidades, o si se desean realizar cambios de estilo (logo, colores, etc) se debe personalizar.

=== Preparar el proyecto para implementar personalizaciones ===

Para preparar el proyecto para implementar personalizaciones, seguir los siguientes pasos:
#En la carpeta "src/pers/" crear un subdirectorio para contener todos los archivos de personalización. Típicamente se suele nombrar a esa nueva carpeta con el nombre del nodo (siglas de la institucion).
#En el archivo de configuración '"config.php"' de la carpeta "instalacion", verificar que la variable "produccion" esté en "false". Esto es necesario para poder visualizar los cambios que se efectúen antes de pasar a producción.
#En el mismo archivo, establecer la variable "usar_personalizaciones" en "true".
#En el mismo archivo, en la sección "Configuración de puntos de acceso", setear la variable "personalizacion", que por defecto viene en NULL, con el nombre de la carpeta creado en el paso 1 (ej: "personalizacion" => "mi_institucion").
#:'''IMPORTANTE''': realizar este paso para la configuración de los bloques de acceso en los cuales se quiera personalizar.

A partir de este punto, el proyecto está preparado para ser personalizado.

Para personalizar algo, se debe buscar el archivo que se desea modificar y copiar sólo ese archivo en la carpeta de personalizaciones creada en el paso 1, respetando la estructura de directorios relativa. El motor de personalizaciones elegirá siempre en primer lugar el archivo personalizado antes que el entregado por el SIU, de allí la importancia de copiar sólo lo que se quiere cambiar y nada más.

=== Personalización de ejemplo ===

Junto con la distribución, se entrega una personalización de ejemplo (denominada, justamente, "ejemplo"). En la misma, se puede ver cómo personalizar algunas características del sistema.

==== Etiquetas y mensajes ====

Todo mensaje o etiqueta que se ve en pantalla o en el comprobante PDF que genera el alumno al finalizar el proceso, está definido en el archivo "mensajes.es.php", de la carpeta "src/siu/mensajes/".

Para cada mensaje o etiqueta, hay definida una entrada del tipo "<id_etiqueta>" => "<Descripción>" en ese archivo. Por ejemplo: "nombre_sistema" => "SIU-Preinscripción". Toda etiqueta es referenciada en el sistema por su ID, y un mecanismo de traducción busca en ese archivo la descripción correspondiente.

Por defecto, los mensajes están definidos en español, en un registro de confianza (voseo).

Para personalizarlo, lo que se debe hacer es crear un archivo "mensajes.es.php" en la estructura de carpetas "src/pers/mi_institucion/mensajes". En ese nuevo archivo, '''reescribir sólo las entradas que se deseen personalizar'''. Las incluidas en el archivo personalizado serán utilizadas en lugar de las originales.

<source lang="php" enclose="div">
src
|_ siu
| |_ mensajes
| |_ mensajes.es.php
|
|_ pers
|_ mi_institucion
|_ mensajes
|_ mensajes.es.php
</source>
Además, si se desea que algunas etiquetas de los campos de formulario se vean diferentes en el comprobante PDF respecto a cómo se ven en pantalla, se deben agregar al final del archivo entradas respetando la siguiente convención:

<source lang="php" enclose="div">
'pdf_<nombre_campo_original>' => '<Nueva etiqueta>',
</source>

Ejemplo: si se desea que para la etiqueta 'nro_documento' se imprima 'Nro. documento' en lugar de 'Número de documento' (como está definida para la salida en pantalla), agregar una entrada:

<source lang="php" enclose="div">
'pdf_nro_documento' => 'Nro. documento',
</source>

==== Logo de página y favicon ====

Una necesidad común puede ser cambiar el logo de página. El entregado por defecto tiene el nombre "logo-transparente.png", y está configurado en la variable "logo_pagina" del "config.php". Para cambiarlo, basta con crear la siguiente estructura de carpetas, y copiar el nuevo logo:

<source lang="php" enclose="div">
src
|_ siu
| |_ www
| |_ img
| |_ logo-transparente.png
|
|_ pers
|_ mi_institucion
|_ www
|_ img
|_ logo-transparente.png
</source>

Si se desea renombrar el nombre del archivo, ajustarlo en la variable "logo_pagina" del archivo de configuración.

De la misma manera, en la personalización de ejemplo se muestra que para cambiar el favicon (ícono de página) basta con guardar un archivo "favicon.ico" en la misma carpeta del logo.

Se debe tener una consideración especial con respecto al logo que se muestra en el encabezado de página del comprobante PDF. Por limitaciones de la librería EZPDF, utilizada para la generación, sólo se permiten archivos en formato PNG y sin canal alfa. El nombre del archivo se define por medio de la variable "rep_encabezado_logo" del "config.php".

==== Estilos ====

Si se desean personalizar los estilos, se debe crear un archivo "preinscripcion.css" en la ruta "src/pers/mi_institucion/www/css/" y redefinir sólo las clases css que se deseen cambiar, independientemente del archivo en el que se encuentra el estilo original. En la personalización de ejemplo, se redefine el color de los títulos, los colores de fondo de la cabecera y de los agrupados, y se agrega el estilo cursiva para los labels obligatorios.

==== Manejo de datos propios ====

En "src/pers/ejemplo/modelo/manejador_datos.php" se dejó un ejemplo documentado de cómo proceder en caso de tener que recolectar datos extra a los manejados por el SIU.

Ahí mismo se deja una sugerencia de manejo de la tabla anexa, con las claves foráneas y triggers recomendados para operar según lo que se documenta.

Se deben redefinir dos métodos (el que setea los datos y el que los obtiene) según la documentación inline presente en ese archivo.

==== Otros casos ====

En la personalización de ejemplo se muestra además cómo personalizar:

*El comprobante, más allá de las configuraciones que ya vienen definidas en "config.php". Se entrega el archivo "src/pers/ejemplo/operaciones/_comun/generador_pdf.php", que extiende del generador base entregado por el SIU, y redefine el encabezado (elimina el código QR y amplía el espacio para la foto), no genera las secciones "CBC", "Avisos", "Fecha y firma" y "Credencial provisoria" (independientemente de lo establecido en "config.php") y se cambia el orden de la sección "Datos de estudios" para que se muestre luego de "Datos personales".
*La cabecera de página. Se exhibe el logo a la derecha, y se muestra también el nombre y apellido de la persona logueada. Ver: "src/pers/ejemplo/operaciones/_comun/templates/header.twig"
*El layout y el estilo de una sección de la operación de carga de datos (Idiomas). Se redefine el ancho de los combos de selección vía css, se cambia el color de fondo de ese agrupado y se define un margen. Además, se personaliza la definición de los campos del formulario, para cambiar la clase css del campo "alu_idioma_otro" (form::clase_css => "input-xxlarge"). Los archivos se pueden ver en: "src/pers/ejemplo/operaciones/censo/idiomas/"

La salida html del proyecto se realiza en base al motor de plantillas twig. Se puede encontrar documentación online en http://twig.sensiolabs.org/

==== Personalización de scripts de Composer ====

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''src/pers/Composer.php''':

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

namespace pers;

use Composer\Script\Event;

class Composer
{
public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}
}
</source>

[[SIU-Guarani/preinscripcion3.23.0/documentacion_tecnica|< Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion scripts composer gestion

2026-01-09T13:44:48Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de scripts de Composer ==

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''personalizacion/php/Composer.php''':

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

namespace PERS\Guarani\php;

use Composer\Script\Event;

class Composer
{

protected static $proyectoPath = __DIR__ . "/../..";

public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}

}
</source>

[[SIU-Guarani/version3.23.0/personalizacion|🔙 Volver]]

SIU-Guarani/version3.23.0/personalizacion

2026-01-09T13:43:51Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
== ¿Cómo personalizo el sistema? ==
=== Personalizaciones en Gestión ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/activar_personalizaciones|Activar personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/trabajo_diario|Trabajo diario con personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/procesos_personalizables|Procesos que se pueden personalizar]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/formas_de_menu|Distintas formas de ver el menú]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/manejo_de_perfiles|Manejo de perfiles]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizaciones_gestion|Personalizaciones en Gestión]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/cambiar_logo|Cambiar el logo de la Institución]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/requisito_proceso|Crear un requisito de tipo proceso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/instancias|Agregar una nueva Instancia de Examen]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_actividad|Agregar nuevo tipo de Actividad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_propuesta|Agregar nuevo tipo de Propuesta]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/constancias|Personalizar impresiones - Constancias y Certificados]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte|Personalizar un reporte]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte_alumnos|Personalizar Reporte de Alumnos - columnas opcionales]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/extender_tablas|Extender tablas]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/circuito_egreso|Editar Circuito de Egreso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/suplemento|Personalizar Suplemento del Título]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/bitacora_alumno|Personalizar Bitácora del Alumno]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/rest|Personalizar servicios REST]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscCursada|Criterios de ordenamiento de alumnos para el procesamiento de inscripciones a actividades por prioridad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscIngresantes|Criterios de ordenamiento de alumnos ingresantes para las inscripciones a actividades de 1er año]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_scripts_composer_gestion|Personalización de scripts de Composer]]

=== Personalizaciones en 3w ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_chulupi|Esquema de personalización del Framework Chulupí]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/creacion_operacion_3w|Ejemplo de la creación de una operación]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/operaciones_en_zonas|Operaciones dentro de las zonas]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_de_acceso|Personalización de acceso]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_scripts_composer|Personalización de scripts de Composer]]


[[SIU-Guarani/Version3.23.0|< Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion scripts composer

2026-01-09T13:23:42Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de scripts de Composer ==

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''src/pers/Composer.php''':

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

namespace pers;

use Composer\Script\Event;

class Composer
{
public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}
}
</source>

[[SIU-Guarani/version3.23.0/personalizacion|🔙 Volver]]

SIU-Guarani/Version3.23.0/personalizaciones/personalizacion scripts composer

2026-01-09T13:20:08Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Personalización de scripts de Composer ==

Se pueden agregar scripts personalizados que se ejecutarán luego de correr los comandos '''composer install''' ('''post-install-cmd''') o '''composer update''' ('''post-update-cmd''').

Se debe modificar en el archivo '''src/pers/Composer.php''':

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

namespace pers;

use Composer\Script\Event;

class Composer
{
public static function postInstallCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer install'.
}

public static function postUpdateCmd(Event $event)
{
// Ventana para ejecutar scripts personalizados luego de ejecutar 'composer update'.
}
}
</source>

SIU-Guarani/version3.23.0/personalizacion

2026-01-09T13:12:09Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
== ¿Cómo personalizo el sistema? ==
=== Personalizaciones en Gestión ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/activar_personalizaciones|Activar personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/trabajo_diario|Trabajo diario con personalizaciones]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/procesos_personalizables|Procesos que se pueden personalizar]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/formas_de_menu|Distintas formas de ver el menú]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/manejo_de_perfiles|Manejo de perfiles]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizaciones_gestion|Personalizaciones en Gestión]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/cambiar_logo|Cambiar el logo de la Institución]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/requisito_proceso|Crear un requisito de tipo proceso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/instancias|Agregar una nueva Instancia de Examen]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_actividad|Agregar nuevo tipo de Actividad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/tipo_propuesta|Agregar nuevo tipo de Propuesta]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/constancias|Personalizar impresiones - Constancias y Certificados]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte|Personalizar un reporte]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/reporte_alumnos|Personalizar Reporte de Alumnos - columnas opcionales]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/extender_tablas|Extender tablas]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/circuito_egreso|Editar Circuito de Egreso]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/suplemento|Personalizar Suplemento del Título]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/bitacora_alumno|Personalizar Bitácora del Alumno]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/rest|Personalizar servicios REST]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscCursada|Criterios de ordenamiento de alumnos para el procesamiento de inscripciones a actividades por prioridad]]
** [[SIU-Guarani/Version3.23.0/personalizaciones/CriteriosPrioridadInscIngresantes|Criterios de ordenamiento de alumnos ingresantes para las inscripciones a actividades de 1er año]]

=== Personalizaciones en 3w ===
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_chulupi|Esquema de personalización del Framework Chulupí]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/creacion_operacion_3w|Ejemplo de la creación de una operación]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/operaciones_en_zonas|Operaciones dentro de las zonas]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_de_acceso|Personalización de acceso]]
* [[SIU-Guarani/Version3.23.0/personalizaciones/personalizacion_scripts_composer|Personalización de scripts de Composer]]


[[SIU-Guarani/Version3.23.0|< Volver]]

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-09T13:00:07Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* [[SIU-Guarani/version3.23.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 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''

* Se cambia la forma de ejecutar '''Jasper''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/instalacion/gestion/linux | Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Desarrollo]] y [[SIU-Guarani/version3.23.0/instalacion/3w | Instalación de SIU-Guaraní 3w versión 3.23.x en entorno de Desarrollo o Producción]]:

<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>

</dd>

<div class="mw-collapsible-content">

== Interfaces con otros módulos SIU ==

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/bioma | BIOMA]].

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/arai-reportes | Araí-Reportes]].

== Interfaces con Sistemas externos ==

* Se adapta la conexión con [[SIU-Guarani/version3.23.0/interfaces/renaper | Renaper]].

== Gestión ==

* Se migró '''SIU TOBA Framework''' a la versión [https://github.com/SIU-Toba/framework/blob/v3.4.3/CHANGELOG.md v3.4.3].

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

</div></div>

SIU-Guarani/Version3.22.0/Novedades tecnicas preinscripcion

2026-01-08T20:16:42Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<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.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''15/10/2025'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* Se agrega el [[SIU-Guarani/preinscripcion3.22.0/sistema_recordatorios_automaticos | Sistema de recordatorios automáticos]].

* 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 '''url_preinscripcion''' para configurar la URL base de Preinscripción.

<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.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''06/03/2025'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* '''Se modifico el archivo para la conversión de la base de datos, desde esta versión el archivo se pasa a llamar conversion.sql y lleva todos los cambios desde la 3.22.0 a la última versión '''
<dd>Si tienen una base en la 3.22.0 o 3.22.1, solo se aplicarán los cambios que aún no se hayan aplicado.</dd>
<dd>En el caso de tener bases anteriores deberán usar los scritps como ejemplo 3.21.0 a 3.22.0 para llevar la base a 3.22.0 y luego ejecutar el archivo conversion.sql</dd>

* Se agregaron los campos de cobertura_salud_nombre, grupo_sanguinio, observaciones_salud, contacto_emergencia_nombre, contacto_emergencia_telefono y contacto_emergencia_relacion.

<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 preinscripcion

2026-01-08T20:16:32Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<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.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''15/10/2025'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* Se agrega el [[SIU-Guarani/preinscripcion3.22.0/sistema_recordatorios_automaticos | Sistema de recordatorios automáticos]].

* 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 '''url_preinscripcion''' para configurar la URL base de Preinscripción.

<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.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''06/03/2025'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* '''Se modifico el archivo para la conversión de la base de datos, desde esta versión el archivo se pasa a llamar conversion.sql y lleva todos los cambios desde la 3.22.0 a la última versión '''
<dd>Si tienen una base en la 3.22.0 o 3.22.1, solo se aplicarán los cambios que aún no se hayan aplicado.</dd>
<dd>En el caso de tener bases anteriores deberán usar los scritps como ejemplo 3.21.0 a 3.22.0 para llevar la base a 3.22.0 y luego ejecutar el archivo conversion.sql</dd>

* Se agregaron los campos de cobertura_salud_nombre, grupo_sanguinio, observaciones_salud, contacto_emergencia_nombre, contacto_emergencia_telefono y contacto_emergencia_relacion.

<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 preinscripcion

2026-01-08T20:13:02Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<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.3</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''15/10/2025'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* Se agrega el [[SIU-Guarani/preinscripcion3.22.0/sistema_recordatorios_automaticos | Sistema de recordatorios automáticos]].

<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.2</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''06/03/2025'''</p>
</div>
<p style="clear: both;"><b>Principales novedades Técnicas</b></p>

* '''Se modifico el archivo para la conversión de la base de datos, desde esta versión el archivo se pasa a llamar conversion.sql y lleva todos los cambios desde la 3.22.0 a la última versión '''
<dd>Si tienen una base en la 3.22.0 o 3.22.1, solo se aplicarán los cambios que aún no se hayan aplicado.</dd>
<dd>En el caso de tener bases anteriores deberán usar los scritps como ejemplo 3.21.0 a 3.22.0 para llevar la base a 3.22.0 y luego ejecutar el archivo conversion.sql</dd>

* Se agregaron los campos de cobertura_salud_nombre, grupo_sanguinio, observaciones_salud, contacto_emergencia_nombre, contacto_emergencia_telefono y contacto_emergencia_relacion.

<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/preinscripcion3.22.0/sistema recordatorios automaticos

2026-01-08T20:09:01Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Sistema de recordatorios automáticos ==

Se agrega el comando '''bin/preinscripcion notificar_recordatorios''', el cual se ejecuta mediante un '''CRON''' y notifica, vía email, a los aspirantes que aún no enviaron la preinscripción.

En el archivo '''instalacion/config.php''' se debe configurar la directiva '''url_preinscripcion''', además de contar con el '''SMTP''' correctamente configurado, para garantizar la ejecución del comando y el envío del recordatorio.

[[SIU-Guarani/preinscripcion3.22.0/documentacion_tecnica|< Volver]]

SIU-Guarani/preinscripcion3.22.0/documentacion tecnica

2026-01-08T20:08:30Z

Lleonardis:

__NOTOC__
== Documentación Técnica ==

=== Instalación desde cero ===

* [[SIU-Guarani/preinscripcion3.22.0/instalacion_desde_cero/requisitos|Requisitos]]
* [[SIU-Guarani/preinscripcion3.22.0/instalacion_desde_cero/apc|Consideraciones sobre la caché APC]]
* [[SIU-Guarani/preinscripcion3.22.0/instalacion_desde_cero/instalacion|Pasos para la instalación]]

=== [[SIU-Guarani/preinscripcion3.22.0/actualizacion|Actualizar desde versión 3.11.0]] ===

=== [[SIU-Guarani/preinscripcion3.22.0/crear_version_propia|Crear versión propia]] ===

=== [[SIU-Guarani/preinscripcion3.22.0/personalizacion|¿Cómo personalizo el sistema?]] ===

=== [[SIU-Guarani/preinscripcion3.22.0/sistema_recordatorios_automaticos|Sistema de Recordatorios Automáticos]] ===

[[SIU-Guarani/preinscripcion3.22.0|< Volver]]

SIU-Guarani/preinscripcion3.23.0/sistema recordatorios automaticos

2026-01-08T20:07:13Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

SIU-Guarani/preinscripcion3.23.0/sistema recordatorios automaticos

2026-01-08T20:02:25Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

== Sistema de recordatorios automáticos ==

Se agrega el comando '''bin/preinscripcion notificar_recordatorios''', el cual se ejecuta mediante un '''CRON''' y notifica a los aspirantes que aún no enviaron la preinscripción con un recordatorio.

En el archivo '''instalacion/config.php''' se debe configurar la directiva '''url_preinscripcion''' para que dicho comando se ejecute correctamente.

[[SIU-Guarani/preinscripcion3.23.0/documentacion_tecnica|< Volver]]

SIU-Guarani/preinscripcion3.23.0/documentacion tecnica

2026-01-08T19:52:08Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
== Documentación Técnica ==

=== Instalación desde cero ===

* [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/requisitos|Requisitos]]
* [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/apc|Consideraciones sobre la caché APC]]
* [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/instalacion|Pasos para la instalación]]

=== [[SIU-Guarani/preinscripcion3.23.0/actualizacion|Actualizar desde versión 3.11.0]] ===

=== [[SIU-Guarani/preinscripcion3.23.0/crear_version_propia|Crear versión propia]] ===

=== [[SIU-Guarani/preinscripcion3.23.0/personalizacion|¿Cómo personalizo el sistema?]] ===

=== [[SIU-Guarani/preinscripcion3.23.0/sistema_recordatorios_automaticos|Sistema de Recordatorios Automáticos]] ===

[[SIU-Guarani/preinscripcion3.23.0|< Volver]]

SIU-Guarani/Version3.23.0/Novedades tecnicas preinscripcion

2026-01-08T19:46:38Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

SIU-Guarani/Version3.23.0/Novedades tecnicas preinscripcion

2026-01-08T19:18:13Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T19:11:20Z

Lleonardis:

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* [[SIU-Guarani/version3.23.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 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''

* Se cambia la forma de ejecutar '''Jasper''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/instalacion/gestion/linux | Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Desarrollo]] y [[SIU-Guarani/version3.23.0/instalacion/3w | Instalación de SIU-Guaraní 3w versión 3.23.x en entorno de Desarrollo o Producción]]:

<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>

</dd>

<div class="mw-collapsible-content">

== Interfaces con otros módulos SIU ==

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/bioma | BIOMA]].

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/arai-reportes | Araí-Reportes]].

== Interfaces con Sistemas externos ==

* Se adapta la conexión con [[SIU-Guarani/version3.23.0/interfaces/renaper | Renaper]].

== Gestión ==

https://github.com/SIU-Toba/framework/blob/v3.3.20/CHANGELOG.md

* Se migró '''SIU TOBA Framework''' a la versión [https://github.com/SIU-Toba/framework/blob/v3.4.3/CHANGELOG.md v3.4.3].

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

</div></div>

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T18:57:51Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* [[SIU-Guarani/version3.23.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 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''

* Se cambia la forma de ejecutar '''Jasper''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/instalacion/gestion/linux | Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Desarrollo]] y [[SIU-Guarani/version3.23.0/instalacion/3w | Instalación de SIU-Guaraní 3w versión 3.23.x en entorno de Desarrollo o Producción]]:

<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>

</dd>

<div class="mw-collapsible-content">

== Interfaces con otros módulos SIU ==

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/bioma | BIOMA]].

* Se agrega conexión con [[SIU-Guarani/version3.23.0/interfaces/arai-reportes | Araí-Reportes]].

== Interfaces con Sistemas externos ==

* Se adapta la conexión con [[SIU-Guarani/version3.23.0/interfaces/renaper | Renaper]].

== Gestión ==

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

</div></div>

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T18:51:27Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T18:28:25Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* [[SIU-Guarani/version3.23.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 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''

* Se cambia la forma de ejecutar '''Jasper''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/instalacion/gestion/linux | Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Desarrollo]] y [[SIU-Guarani/version3.23.0/instalacion/3w | Instalación de SIU-Guaraní 3w versión 3.23.x en entorno de Desarrollo o Producción]]:

<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>

</dd>

<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.23.0/API_REST_GUARANI#Configuraci.C3.B3n_de_Usuarios_y_Perfil_Funcional | Ver documentación aquí]].</div>

== Gestión ==

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

</div></div>

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T18:04:35Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Ya no es necesario instalar '''yui-compressor''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/requisitos_previos/linux | Requisitos previos de Guaraní]] y [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/requisitos | Requisitos previos de Preinscripción]].

* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.23.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 8.1.x.'''
Importante:

[https://www.php.net/manual/es/migration80.php Migración de PHP 7.4.x a PHP 8.0.x]

[https://www.php.net/manual/es/migration81.php Migración de PHP 8.0.x a PHP 8.1.x]

* Se actualiza a la versión de '''PostgreSQL 14.20.x.'''

* Ya no es necesario instalar '''yui-compressor'''
</dd>

<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.23.0/API_REST_GUARANI#Configuraci.C3.B3n_de_Usuarios_y_Perfil_Funcional | Ver documentación aquí]].</div>

== Gestión ==

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

</div></div>

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T17:48:51Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0 Con versión 3.19.0]

<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content">

== Notas de versión ==

* Ya no es necesario instalar '''yui-compressor''', ver [[SIU-Guarani/version3.23.0/instalacion_desde_cero/requisitos_previos/linux | Requisitos previos de Guaraní]] y [[SIU-Guarani/preinscripcion3.23.0/instalacion_desde_cero/requisitos | Requisitos previos de Preinscripción]].

<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.23.0/API_REST_GUARANI#Configuraci.C3.B3n_de_Usuarios_y_Perfil_Funcional | Ver documentación aquí]].</div>

== Gestión ==

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

</div></div>

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T16:15:06Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.0/API_REST_GUARANI#Configuraci.C3.B3n_de_Usuarios_y_Perfil_Funcional | Ver documentación aquí]].</div>

== Gestión ==

* Se incorporó la opción '''--excluir-vinculados''' en el comando '''bin/guarani exportar_usuarios_arai'''.

== Autogestión ==

* Se migró '''SIU Chulupí Framework''' a la versión [https://gitlab.siu.edu.ar/chulupi/framework/-/blob/v2.7.0/CHANGELOG.md v2.7.0].

</div></div>

SIU-Guarani/Version3.23.0/Novedades tecnicas

2026-01-08T16:08:39Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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.23.0 | Volver]]</p>
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.23.0</strong></p>
<p style="margin: 0; padding: 0;">Fecha de publicación: '''12/01/2026'''</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/032300/html_v3.23.0.html Modelo 3.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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.23.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/interfaces/arai-reportes

2026-01-07T20:52:35Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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].

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

2026-01-07T20:48:44Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__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]

===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].

SIU-Guarani/version3.23.0/interfaces

2026-01-07T20:43:57Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

__NOTOC__
= Interfaces con otros módulos =

== Interfaces SIU-Guaraní ==

=== [[SIU-Guarani/Version3.23.0/API_REST_GUARANI|API-REST Guaraní]] ===

=== [https://documentacion.siu.edu.ar/apis/?spec=guarani_v1 Especificación de API] ===

=== [[SIU-Guarani/version3.23.0/interfaces/gestion-3w-rest|Interfaz SIU-Guaraní Gestión y 3w]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/app-3w-jwt|Interfaz SIU-Guaraní App y 3w]] ===

=== [[SIU-Guarani/Version3.23.0/interfaces/preinscripcion|Conexión con Preinscripción]] ===

=== [[SIU-Guarani/Version3.23.0/interfaces/saml|Configuración SAML para vincular SIU-Guaraní Gestión con 3w]] ===

=== [[SIU-Guarani/Version3.23.0/interfaces/3w|Interconexión entre SIU-Guaraní Gestión y 3w]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/configuracion-ldap|Configuración LDAP]] ===

== Módulos SIU ==

=== [[SIU-Guarani/Version3.23.0/interfaces/kolla|SIU-Kolla]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/sanaviron|SIU-Sanaviron/Quilmes]] ===

=== [[SIU-Guarani/Version3.23.0/interfaces/rest-hooks|Rest-Hooks]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/tehuelche|SIU-Tehuelche]] ===

=== [[SIU-Guarani/Version3.23.0/interfaces/sidcer|SICer]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/arai|SIU-Araí]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/araucano|SIU-Araucano]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/bioma|BIOMA]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/arai-reportes|Araí Reportes]] ===



== Sistemas externos ==

=== [[SIU-Guarani/version3.23.0/interfaces/interfaz-moodle|Moodle]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/renaper|Renaper]] ===

=== [[SIU-Guarani/version3.23.0/interfaces/boleto-estudiantil|Boleto Estudiantil]] ===

== Becas ==
<br>
La información académica de alumnos que solicitaron becas se puede obtener desde la operación <b>> Administracion > Becas > Generar datos para becas</b>
<br>

Para versiones anteriores, existen los siguientes scripts que se deben correr en la base de datos de Guarani:

=== [https://colab.siu.edu.ar/svn/guarani3/contrib/Salidas%20de%20informaci%C3%B3n/Becas%20Manuel%20Belgrano%20-%202022/ Becas Manuel Belgrano (Acceso con usuario de colab.siu.edu.ar)] ===

=== [https://colab.siu.edu.ar/svn/guarani3/contrib/Salidas%20de%20informaci%C3%B3n/Progresar%20-%20PNBU%20PNBB%20-%202023/ Becas Progresar (Acceso con usuario de colab.siu.edu.ar)] ===
<br>
El proceso se puede correr para obtener informaciòn del 1er Semestre o Anual.<br>

Para la verificacion anual de materias aprobadas/cursadas se considera el siguiente período (Año = Año a informar):<br>
* Becas BELGRANO: Del 01/01/<Año> al 31/12/<Año> <br>
* Becas PROGRESAR: Del 01/04/<Año> al 31/03/<Año + 1> (Idem Araucano)<br>
<br>

== PROMEDIO HISTORICO ==

=== [https://colab.siu.edu.ar/svn/guarani3/contrib/Salidas%20de%20informaci%C3%B3n/Promedio%20Historico/ Script para cálculo de Promedio Histórico (Acceso con usuario de colab.siu.edu.ar)] ===

El proceso recupera el promedio histórico de los ultimos 5 años; del 01/04/(año actual - 5) hasta el 31/03/año actual.<br>
Promedio de egresados (tìtulos de nivel final) donde la fecha de egreso esta dentro del período evaluado.<br><br>
Este script es válido para las diferentes versiones de Guarani 3.

<br><br><br>

[[SIU-Guarani/Version3.23.0|🔙 Volver]]

SIU-Guarani/version3.23.0/instalacion desde cero/instalacion/gestion/linux

2026-01-07T20:12:25Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>

= Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Desarrollo =

{| class="simple" border="1"
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.
|}
'''A lo largo de los pasos se deberá reemplazar:'''
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto.
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.
* '''<jasper nivel log>''': Nivel de los logs de Jasper.
* '''3.23.x''': por la versión que se va a instalar.

== Pasos para la instalación ==
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.23.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]]
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:
#:<source lang="bash" enclose="div">mkdir /usr/local/proyectos/guarani</source>
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como '''<path proyecto Guaraní>'''.
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
#:<source lang="bash" enclose="div">
svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.23.x <path proyecto Guaraní>
</source>
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:
#:<source lang="bash" enclose="div">
composer install
</source>
#:'''Nota''': Si ha modificado algún archivo de la carpeta vendor y obtiene algún mensaje como este:
#:<source lang="bash" enclose="div">
Updating siu-arai/documentos-cli (v1.0.2 => v1.0.3):
The package has modified files:
M tests/src/SIU/Queue/QueueTest.php
Discard changes [y,n,v,d,s,?]? y
</source>
#:Contestar y para descartar los cambios que se hayan realizado.
#Instalar el framework SIU-Toba, para ello, posicionados en '''<path proyecto Guaraní>/bin''' ejecutar:
#:<source lang="bash" enclose="div">
export TOBA_INSTANCIA=desarrollo
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>/instalacion
./toba instalacion instalar
</source>
#:y completar:
#:<source lang="bash" enclose="div">
Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3>
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por correo electrónico>
Se trata de una instalacion de producción? (Si o No) (s/n): n
Nombre de la instalación (ej: Andromeda): <ej: guarani3>
PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres>
PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres>
PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres>
PostgreSQL - Clave (ENTER para usar sin clave): <clave servidor Postgres>
PostgreSQL - Base de datos (ENTER utilizará toba_3_3): <nombre de la base, sugerencia: guarani3>
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)>
Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción>
</source>
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir:
#*<path proyecto Guaraní>/www
#*<path proyecto Guaraní>/temp
#*<path proyecto Guaraní>/instalacion
#*<path proyecto Guaraní>/vendor/siu-toba/framework/www
#*<path proyecto Guaraní>/vendor/siu-toba/framework/temp
#:Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es ''www-data'', debería ejecutarse:
#:<source lang="bash" enclose="div">
chown -R $(whoami):www-data www temp instalacion vendor/siu-toba/framework/www vendor/siu-toba/framework/temp
chmod 775 -R www temp instalacion vendor/siu-toba/framework/www vendor/siu-toba/framework/temp
</source>
#Crear un link simbólico a toba.conf, e indicarle Apache que recargue los archivos de configuración. En lugar de hacerlo como indica la consola de instalación, sugerimos:
#:<source lang="bash" enclose="div">
ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
a2ensite gestion.conf
service apache2 reload
</source>
#Agregar los parámetros de localización de '''fop''' al final del archivo de inicialización de la instalación Toba ('''<path proyecto Guaraní>/instalacion/instalacion.ini'''):
#:<source lang="ini" enclose="div">
[xslfo]
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.
#Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní)''') ejecutar:
#:<source lang="bash" enclose="div">
cp menu.ini.tmpl menu.ini
</source>
#:Completar el archivo [[SIU-Guarani/Version3.23.0/personalizaciones/formas_de_menu| menu.ini]]
#Para cargar el proyecto, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
#:<source lang="bash" enclose="div">
./guarani cargar -d <path proyecto Guaraní>
</source>
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder '''s'''.
#Reiniciar Apache:
#:<source lang="bash" enclose="div">
service apache2 restart
</source>
#Configurar la API REST
#:[[SIU-Guarani/version3.23.0/interfaces/api-guarani-perfil-funcional|API SIU-Guaraní - Perfil Funcional]]
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
#:<source lang="bash" enclose="div">./guarani instalar</source>
#:'''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.
#Para activar el esquema de auditoría, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
#:<source lang="bash" enclose="div">./guarani crear_auditoria -f guarani</source>
#Programar una tarea que levante la utilidad PHP-Java Bridge, necesaria para el motor de reportes Jasper Reports. El comando para activarlo es:
#:<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>
#:Por ejemplo, en un ambiente Debian, se puede editar como superusuario el archivo /etc/rc.local, y agregar la sentencia anterior.
#Para ejecutar el proyecto navegar hacia la URL definida en ''toba.conf'', por defecto:
#:<source lang="php" enclose="div">http://localhost/guarani/3.23</source>
#:El usuario-clave para el primer acceso es: '''toba''', '''toba'''. Se recomienda luego del primer acceso modificar la clave.
#Para editar el proyecto, navegar hacia la URL definida en ''toba.conf'', por defecto:
#:<source lang="php" enclose="div">http://localhost/toba_editor/3.3</source>
#:El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.

== Configuración de cron o tarea programada para el envío de emails ==
Un cron o tarea programada es un programa que permite ejecutar automáticamente comandos o scripts (grupos de comandos) a una hora o fecha específica. Es usado normalmente para comandos de tareas administrativas, como respaldos, pero puede ser usado para ejecutar cualquier cosa. Es un demonio que ejecuta programas agendados.
*:Con un sistema '''GNU/Linux''':
#En una consola ejecutar el comando:<source lang="php" enclose="div">crontab -e </source>
#Agregar la siguiente linea:<source lang="php" enclose="div">*/10 * * * * <path proyecto Guaraní>/bin/guarani enviar_emails_notificador</source>(ejecutará el comando cada 10 minutos) Para otros ejemplos consultar https://geekytheory.com/programar-tareas-en-linux-usando-crontab/
#Guardar y salir del editor
<br>
*:Con un sistema '''Windows''':
#Crear un archivo .bat (ej: C:\guarani_enviar_emails_bat.bat) con el siguiente contenido:<source lang="php" enclose="div">
@echo off
<path proyecto Guaraní>\bin\guarani enviar_emails_notificador
exit
</source>
#Ir a Inicio, buscar y ejecutar el programa "Programador de tareas".
#Ir a Acciones -> Crear tarea, en la solapa "General" poner un Nombre a la tarea (ej: guarani_cron_enviar_emails), una descripción (opcional) y tildar la opción "Oculta".
#En la solapa "Acciones" crear una nueva acción, donde dice "Programa o Script" seleccionar el path hasta el .bat (ej: C:\guarani_enviar_emails_bat.bat).
#En la solapa "Desencadenadores" crear un nuevo desencadenador, en inicio poner una hora posterior a la actual (ej: 10 minutos mas tarde) en Configuración avanzada poner Repetir cada 10 minutos repetir indefinidamente.
#Aceptar para crear la tarea.

(Para más detalles del '''envío de emails''' consulte la documentación del [[SIU-Guarani/Version3.23.0/notificador|notificador]])

[[SIU-Guarani/Version3.23.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]

SIU-Guarani/version3.23.0/instalacion desde cero/produccion/gestion/linux

2026-01-07T20:12:22Z

Lleonardis: https://gitlab.siu.edu.ar/guarani/soporte-interno/-/work_items/133

<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>

= Instalación desde cero de SIU-Guaraní Gestión 3.23 en entorno de Producción =

== Requisitos previos ==
#Haber liberado una [[SIU-Guarani/version3.23.0/crear_version_propia/gestion|versión propia]] de cuatro dígitos (se hayan o no desarrollado personalizaciones).
<br>
'''A lo largo de los pasos se deberá reemplazar:'''
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto.
* '''<siglas institución>''': por las siglas correspondientes al nodo de Colab de la Institución que realiza la instalación.
* '''<jasper nivel log>''': Nivel de los logs de Jasper
* '''3.23.x.y''': por la versión propia que se va a instalar.

== Pasos para la instalación ==
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.23.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]]
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:
#:<source lang="bash" enclose="div">sudo mkdir /usr/local/proyectos/guarani</source>
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como '''<path proyecto Guaraní>'''.
#Descargar el proyecto de SVN desde la URL correspondiente en Colab:
#:<source lang="bash" enclose="div">
sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.23.x.y <path proyecto Guaraní>
</source>
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:
#:<source lang="bash" enclose="div">
sudo composer install --prefer-dist --no-dev --optimize-autoloader
</source>
#Instalar el framework SIU-Toba, para ello, posicionados en '''<path proyecto Guaraní>/bin''' ejecutar:
#:<source lang="bash" enclose="div">
export TOBA_INSTANCIA=desarrollo
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>/instalacion
sudo ./toba instalacion instalar
</source>
#:y completar:
#:<source lang="bash" enclose="div">
Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3>
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por correo electrónico>
Se trata de una instalacion de producción? (Si o No) (s/n): n
Nombre de la instalación (ej: Andromeda): <ej: guarani3>
PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres>
PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres>
PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres>
PostgreSQL - Clave (ENTER para usar sin clave): <clave servidor Postgres>
PostgreSQL - Base de datos (ENTER utilizará toba_2_7): <nombre de la base, sugerencia: guarani3>
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)>
Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción>
</source>
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir:
#*<path proyecto Guaraní>/www
#*<path proyecto Guaraní>/temp
#*<path proyecto Guaraní>/instalacion
#*<path proyecto Guaraní>/metadatos_compilados (esta carpeta se crea al ejecutar ./guarani compilar en la configuración del entorno de Producción)
#*<path proyecto Guaraní>/vendor/siu-toba/framework/www
#*<path proyecto Guaraní>/vendor/siu-toba/framework/temp
#:Por ejemplo, en ambientes Debian, donde el usuario de Apache es ''www-data'', debería ejecutarse:
#:<source lang="bash" enclose="div">
chown -R www-data:www-data <path proyecto Guaraní>/www
chown -R www-data:www-data <path proyecto Guaraní>/temp
chown -R www-data:www-data <path proyecto Guaraní>/instalacion
chown -R www-data:www-data <path proyecto Guaraní>/metadatos_compilados
chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/www
chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/temp
</source>
#Crear un link simbólico a toba.conf, e indicarle Apache que recargue los archivos de configuración. En lugar de hacerlo como indica la consola de instalación, sugerimos:
#:<source lang="bash" enclose="div">
sudo ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
sudo a2ensite gestion.conf
sudo service apache2 reload
</source>
#Agregar los parámetros de localización de '''fop''' al final del archivo de inicialización de la instalación Toba ('''<path proyecto Guaraní>/instalacion/instalacion.ini'''):
#:<source lang="ini" enclose="div">
[xslfo]
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.
#Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní)''') ejecutar:
#:<source lang="bash" enclose="div">
sudo cp menu.ini.tmpl menu.ini
</source>
#:Completar el archivo [[SIU-Guarani/Version3.23.0/personalizaciones/formas_de_menu| menu.ini]]
#Para cargar el proyecto, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
#:<source lang="bash" enclose="div">
sudo ./guarani cargar -d <path proyecto Guaraní>
</source>
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder '''s'''.
#Reiniciar Apache:
#:<source lang="bash" enclose="div">
sudo service apache2 restart
</source>
#Configurar la API REST
#:[[SIU-Guarani/version3.23.0/interfaces/api-guarani-perfil-funcional|API SIU-Guaraní - Perfil Funcional]]
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
#:<source lang="bash" enclose="div">sudo ./guarani instalar</source>
#Activar el esquema de auditoría. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
#:<source lang="bash" enclose="div">sudo ./guarani crear_auditoria -f guarani</source>
#Programar una tarea que levante la utilidad PHP-Java Bridge, necesaria para el motor de reportes Jasper Reports. El comando para activarlo es:
#:<source lang="bash" enclose="div">
/usr/bin/java \
-cp "<path proyecto Guaraní>/vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/*" \
-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl \
-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl \
-Duser.language=es \
-Duser.country=AR \
-Djava.awt.headless=true php.java.bridge.Standalone SERVLET:8081 <jasper nivel log>
</source>
#:Por ejemplo, en un ambiente Debian, se puede editar como superusuario el archivo /etc/rc.local, y agregar la sentencia anterior.

== Configuraciones adicionales ==

=== Manejo de perfiles ===

En el archivo '''<path proyecto Guaraní>/instalacion/instalacion.ini''' establecer:
<source lang="ini" enclose="div">
es_produccion = 1
</source>

Para facilitar la actualización de versiones y evitar cometer errores en el pasaje desde desarrollo, los perfiles se definen en el entorno de producción. Ver [[SIU-Guarani/Version3.23.0/personalizaciones/manejo_de_perfiles | Manejo de perfiles]]
Para ello, en el archivo '''<path proyecto Guaraní>/instalacion/i__desarrollo/instancia.ini''', dentro de la sección destinada al proyecto indicada por "[guarani]") configurar:
<source lang="ini" enclose="div">
[guarani]
usar_perfiles_propios = 1
</source>
La combinación de estos dos flags permite que la exportación de perfiles se haga en la carpeta '''<path proyecto Guaraní>/instalacion/i__desarrollo/p__guarani/perfiles''', que tiene establecida la propiedad ''svn:ignore'', en lugar de la carpeta usual '''<path proyecto Guaraní>/metadatos/permisos'''. De esta manera, cuando se actualiza el sistema a una nueva versión, se mantienen los perfiles definidos localmente.

=== Compilar metadatos ===

Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
<source lang="bash" enclose="div">
sudo ./guarani compilar
</source>
Este comando crea la carpeta '''<path proyecto Guaraní>/metadatos_compilados''', a la que se le deben dar los permisos arriba detallados:
<source lang="bash" enclose="div">
chown -R www-data:www-data <path proyecto Guaraní>/metadatos_compilados
</source>
Esta carpeta no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice el servidor. Por dicha razón es que compilamos en el servidor de producción, donde no se realizan ''svn commits''.
Editar el archivo 'aplicacion.php' ('''<path proyecto Guaraní>/www/aplicacion.php''') y descomentar la siguiente línea:
<source lang="php" enclose="div">
define('apex_pa_metadatos_compilados', 1);
</source>

=== Nivel de log ===

Adicionalmente, en el mismo archivo 'aplicacion.php', se puede establecer el nivel de log máximo deseado:
<source lang="php" enclose="div">
define("apex_pa_log_archivo_nivel", 3); // 3: Error | 5: notice | 6: debug
</source>

=== Probar el acceso ===

Para probar el proyecto navegar hacia la URL definida en toba.conf, por defecto:
<source lang="php" enclose="div">http://localhost/guarani/3.23</source>
El usuario para el primer acceso es toba, y la contraseña toba. Dado que estamos en un ambiente de producción, se recomienda cambiar luego del primer acceso este password con la operación '''Administrar personas'''.

== Desinstalar proyectos de desarrollo ==

Dado que estamos en un ambiente de producción, recomendamos desinstalar los proyectos '''toba_editor''' y '''toba_referencia''', que son instalados por defecto junto con el framework. En una consola posicionada en el bin de toba (<path proyecto Guaraní>/lib/toba/bin), ejecutar:

<source lang="php" enclose="div">
toba proyecto eliminar -p toba_editor -i desarrollo
toba proyecto eliminar -p toba_referencia -i desarrollo

toba proyecto despublicar -p toba_editor -i desarrollo
toba proyecto despublicar -p toba_referencia -i desarrollo
</source>

Finalmente, reiniciar Apache.

<br>
[[SIU-Guarani/Version3.23.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]