SIU-Guarani/version3.19.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
- 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.
- 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
[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
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 (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:
- Definir las Unidades de Gestión en SIU-Kolla con la operación Configuración » Unidades de Gestión.
- Definir las preguntas, respuestas, encuestas en SIU-Kolla, asociadas a las UGs correspondientes
- 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.
- 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í.
- 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.
