SIU-Guarani/version3.21.0/interfaces/kolla

Interfaz SIU-Guaraní - SIU-Kolla

Advertencia: Los servicios web REST no utilizan certificados. Es altamente recomendable utilizar una conexión https.

Ambos SIU-Guaraní y SIU-Kolla deben estar bajo el mismo protocolo, si uno esta en HTTPS, el otro también debe utilizar el mismo protocolo. Esto es para evitar un potencial error de Cross-Domain.

En SIU-Kolla

1. Crear un sistema externo en el backend de SIU-Kolla. El sistema adiciona el prefijo 'ue_', si introduce guarani, el nombre de usuario será 'ue_guarani' por ejemplo.
2. Crear un usuario de REST con el nombre ue_guarani.

   Editar el archivo <path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor.ini

   ;servidor.ini
   autenticacion = basic o digest

   y <path proyecto Kolla>/instalacion/i__<instancia>/p__kolla/rest/servidor_usuarios.ini

   ;servidor_usuarios.ini
   [ue_guarani]
   password = sP6lgHwQopaqepOzgIWw ;cambiar!

   Se debe reemplazar:

   • <path proyecto Kolla>: por el path donde se encuentra instalado el proyecto SIU-Kolla
   • <instancia>: por el nombre de la instancia

Para más información, consultar en la explicación de REST de Toba

En SIU-Guaraní Gestión

Crear y configurar el archivo <path proyecto Gestión>/instalacion/i__<instancia>/p__guarani/rest/kolla/cliente.ini

;cliente.ini
[conexion]
to = "http://urlkolla/rest/"
auth_tipo = basic o digest
auth_usuario = ue_guarani
auth_password = sP6lgHwQopaqepOzgIWw

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

Configurar la API REST

• API SIU-Guaraní - Perfil Funcional

En SIU-Guaraní 3w

Configurar la URL de SIU-Kolla en el archivo <path proyecto 3w>/instalacion/config.php

...
'url_kolla' => 'http://urlkolla/',
...

También configurar el archivo <path proyecto 3w>/instalacion/servicios_web_config.php (si no existe hacer una copia desde el archivo servicios_web_config_template.php ubicado en el mismo directorio)

...
'consumidos' => array(

        'kolla' => array(
                'tipo' => 'rest',
                'parametros' => array( //usa cliente Guzzle, son opciones en formato guzzle
                        'base_uri' => "http://urlkolla/rest/",
                        'auth' => array('ue_guarani', 'sP6lgHwQopaqepOzgIWw', <tipo-auth>), //user, password, según guzzle
                )
        ),

)
...

Se debe reemplazar:

• <path proyecto 3w>: por el path donde se encuentra instalado el proyecto SIU-Guaraní 3w
• <tipo-auth>: basic o digest. Ver documentación de Guzzle.

Vinculación por Unidades de Gestión

A partir de la versión 3.17.0 se incorporan funcionalidades para administrar las encuestas de SIU-Kolla por Unidad de Gestión. Los servicios web del Sistema de Gestión de Encuestas del SIU están preparados para recibir como parámetro la Unidad de Gestión (UG) con la que se quiere operar. Hasta las versiones 3.11.x, se estaba trabajando con la UG "1" en esos pedidos.

A tales efectos, se incorporan dos parámetros:

Parámetro	Descripción	Valores posibles	Default
enc_utiliza_ug_kolla	Define si se usan Unidades de Gestión de Guaraní en la vinculación de encuestas con Kolla.	No: No se utilizan las Unidades de Gestión de Guarani para la vinculación con Kolla. La vinculación de encuestas con Kolla es única para toda la institución. Sí: Se utilizan las Unidades de Gestión de Guarani para la vinculación de encuestas con Kolla.	No (se respeta la disposición anterior, donde la conexión con Kolla era a nivel Institución).
enc_kolla_unidad_gestion	Define la unidad de gestión de Kolla para la vinculación de encuestas entre Guarani y Kolla.	Cadena de caracteres.	"1" (parámetro que se estaba pasando a Kolla anteriormente como Unidad de Gestión).

Los mismos pueden configurar los siguientes escenarios:

• Cuando el parámetro enc_utiliza_ug_kolla se define en "No", el sistema seguirá operando como en las versiones anteriores. Al momento de realizar los pedidos a los servicios web de SIU-Kolla, se pasará como UG lo definido en el parámetro enc_kolla_unidad_gestion, que por defecto es "1".

• Cuando el parámetro enc_utiliza_ug_kolla se establece en "Sí", se debe realizar la siguiente configuración:

1. Definir las Unidades de Gestión en SIU-Kolla con la operación Configuración » Unidades de Gestión.
2. Definir las preguntas, respuestas, encuestas en SIU-Kolla, asociadas a las UGs correspondientes
3. En la operación de SIU-Guarani Unidades de Gestión » Unidades de Gestión » Unidades de Gestión, vincular la UG de Guaraní con la UG de Kolla correspondiente.
4. En la operación Encuestas » Vincular Encuestas SIU-Kolla, al agregar una nueva encuesta se deberá seleccionar previamente la Unidad de Gestión. Si el usuario logueado tiene restricciones de perfil de datos, sólo podrá ver las Unidades de Gestión sobre las que tiene dominio. Cabe aclarar que en el combo se listarán solamente las UGs de Guaraní que tengan una vinculación con una UG de Kolla (paso 3), y el parámetro que se pasará al servicio web de Kolla será esa definición, y no el ID interno de UG en Guaraní.
5. A partir de este punto, el circuito continúa como antes. Se definen las encuestas y sus alcances, y habilitan las mismas, con la operación de guaraní Encuestas » Definir Encuestas.

Correspondencia Guarani-Kolla

Tabla-campo Guarani	Tabla-campo Kolla
gde_habilitaciones.habilitacion	sge_formulario_habilitado.formulario_habilitado_externo
gde_formularios.formulario	sge_formulario_habilitado.formulario_habilitado_externo sge_concepto.concepto_externo
gde_items.item	sge_elementos.elemento_externo

Encuestas de Evaluación Académica

Encuestas relacionadas con las cursada de las actividades en un período lectivo.
Cada formulario de la habilitación de la encuesta representa una *comisión*, la que esta asociada a una actividad.
La comisión se registra en el formulario: _gde_formulario.comision_
Cada formulario contendra un solo item (gde_formulario_items -> gde_items.item), donde este tendra registrada la actividad (gde_items.elemento)

Encuestas de Evaluación Docente

Cada formulario de la habilitación representa una comisión o una subcomision. Esta comision/subcomision al igual que la encuesta de actuación académica esta definida a través del concepto asociado al formulario (gde_formularios).
La comisión se registra en el formulario: gde_formulario.comision
El formulario puede tener uno o mas elementos. Cada elemento/item del formulario representa un docente. (gde_formulario_items -> gde_items.item). Donde en la tabla gde_items estará registrado el docente en gde_items.docente.

Encuestas de Evaluación Académica y Docente

Encuestas relacionadas con las cursada de las actividades y la actuación docente en un período lectivo.
Cada formulario de la habilitación de la encuesta representa una *comisión*, la que esta asociada a una actividad.
La comisión se registra en el formulario: gde_formulario.comision

Cada formulario contendrá un elemento/item que representa a la *actividad* y 1 o mas items que representa a cada *docente* de la comisión según la definición del alcance de la encuesta (todos los docentes / docentes según rol) (gde_formulario_items -> gde_items.item), donde este tendra registrada la actividad (gde_items.elemento) y docentes (gde_items.docente)