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 o subcomisiones. El título del formulario se forma de la siguiente manera: <Nombre actividad> (<Código actividad>) - Comision: <Nombre Comision>
La comisión se registra en el formulario: _gde_formulario.comision_
Si la comision tiene subcomisiones, entonces se genera un formulario por cada combinación de subcomisiones de diferente tipo de clase, y se registra la combinación de subomisiones en el campo _gde_formulario.subcomisiones_ (es un array de subcomisiones). A cada alumno de la comisión se le asociará el formulario correspondiente a las subcomisiones en las que esta inscripto.

Cada formulario contendra un solo item (gde_formulario_items -> gde_items.item). En cada idem se registra el año académico (gde_items.anio_academico), el período lectivo (gde_items.periodo_lectivo), la actividad (gde_items.elemento) y la comisión (gde_items.comision).
El título del item es el nombre de la actividad (gde_items.titulo).

Encuestas de Evaluación Docente

Encuesta relacionadas con la actividad docente en las cursadas de un período lectivo. Cada formulario de la habilitación representa una comisión o subcomisiones de cada comision. El formulario se genera igual que en la Evaluación Académica, pero la diferencia reside en los items/elementos que contiene cada formulario de la habilitación.

El formulario puede tener uno o mas items/elementos. Cada item del formulario representa un docente. (gde_formulario_items -> gde_items.item). En cada idem se registra el docente (gde_items.docente), el año académico (gde_items.anio_academico), el período lectivo (gde_items.periodo_lectivo), la actividad (gde_items.elemento) y la comisión (gde_items.comision).

En el caso de comisiones con subcomisiones, en cada formulario solo estarán en items los docentes de las subcomisiones registradas en el formulario (gde_formularios.subomisiones')

Encuestas de Evaluación Académica y Docente

Encuestas relacionadas con las cursada y actuación docente de las actividades en un período lectivo.
Cada formulario de la habilitación de la encuesta representa una *comisión* o *subcomsiones*.
El formulario se genera igual que en encuestas de actuación académica.

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 tendrá registrada la actividad (gde_items.elemento) y docentes (gde_items.docente)

Encuestas Genéricas

En este tipo de encuestas, cuando el encuestado es el alumno, se puede generar una encuesta por cada propuesta o una sola encuesta para los alumnos de las propuestas seleccionadas en el alcance. _Encuesta única_: En este caso se genera un único formulario. El título del formulario se corresponde con el nombre de la encuesta asociada a la habilitación. El formulario está formado por un item/elemento (gde_items)

_Una encuesta por propuesta_: Si se indicó que se genera una encuesta por propuesta, entonces se genera un formulario de encuesta por cada propuesta.
El titulo del formulario estará formado por el nombre de la propuesta. El formulario está formado por un item/elemento que identificará la propuesta (gde_items.propuesta)