SIU-Guarani/version3.20.0/interfaces/kolla

De SIU
Saltar a: navegación, buscar

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

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. GUA encuestas ug 001.png
  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. GUA encuestas ug 002.png
  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í. GUA encuestas ug 003.png
  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.