Diferencia entre revisiones de «SIU-Guarani/version3.14.0/interfaces/gestion-3w-rest»

De SIU
Saltar a: navegación, buscar
 
(No se muestran 4 ediciones intermedias de otro usuario)
Línea 23: Línea 23:
  
 
Para más información, consultar en la explicación de [https://toba.siu.edu.ar/trac/toba/wiki/Referencia/Rest REST de Toba]
 
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í Gestión===
 
−
Crear y configurar el archivo <tt><path proyecto Gestión>/lib/toba/instalacion/i__<instancia>/p__guarani/rest/kolla/cliente.ini</tt>
 
−
<source lang="php" enclose="div">
 
−
;cliente.ini
 
−
[conexion]
 
−
to = "http://urlkolla/rest/"
 
−
auth_tipo = basic
 
−
auth_usuario = ue_guarani
 
−
auth_password = sP6lgHwQopaqepOzgIWw
 
−
</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
 
  
 
===En SIU-Guaraní 3w===
 
===En SIU-Guaraní 3w===
−
Configurar la URL de SIU-Kolla en el archivo <tt><path proyecto 3w>/instalacion/config.php</tt>
 
−
<source lang="php" enclose="div">
 
−
...
 
−
'url_kolla' => 'http://urlkolla/',
 
−
...
 
−
</source>
 
  
−
También configurar el archivo <tt><path proyecto 3w>/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)
+
Configurar el archivo <tt><path proyecto 3w>/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">
 
<source lang="php" enclose="div">
 
...
 
...
 
'consumidos' => array(
 
'consumidos' => array(
  
−
'kolla' => array(
+
'gestion' => array(
 
'tipo' => 'rest',
 
'tipo' => 'rest',
 
'parametros' => array( //usa cliente Guzzle, son opciones en formato guzzle
 
'parametros' => array( //usa cliente Guzzle, son opciones en formato guzzle
−
'base_url' => "http://urlkolla/rest/",
+
'base_url' => "http://<GuaraniGestion>/rest/",
 
'defaults' => array (
 
'defaults' => array (
 
'auth' => array('ue_guarani', 'sP6lgHwQopaqepOzgIWw'), //user, password, segun guzzle
 
'auth' => array('ue_guarani', 'sP6lgHwQopaqepOzgIWw'), //user, password, segun guzzle
Línea 67: Línea 47:
 
Se debe reemplazar:
 
Se debe reemplazar:
 
* <path proyecto 3w>: por el path donde se encuentra instalado el proyecto SIU-Guaraní 3w
 
* <path proyecto 3w>: por el path donde se encuentra instalado el proyecto SIU-Guaraní 3w
−
 
+
* <url proyecto Gestión>: por la url donde se encuentra instalado el proyecto SIU-Guaraní Gestión
−
===Vinculación por Unidades de Gestión===
 
−
 
 
−
A partir de la versión 3.14.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:
 
−
 
 
−
{| class="wikitable"
 
−
|-
 
−
! 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:
 
−
 
 
−
# Definir las Unidades de Gestión en SIU-Kolla con la operación '''Configuración » Unidades de Gestión'''. [[Archivo:GUA_encuestas_ug_001.png]]
 
−
# 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. [[Archivo:GUA_encuestas_ug_002.png]]
 
−
# 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í. [[Archivo:GUA_encuestas_ug_003.png]]
 
−
# 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'''.
 

Revisión actual del 00:54 31 may 2019

Interfaz SIU-Guaraní Gestión y 3w

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

En SIU-Guaraní Gestión

  1. Crear un usuario de REST, ej: ue_guarani.
    Editar el archivo <path proyecto Gestión>/instalacion/i__<instancia>/p__guarani/rest/servidor.ini
    ;servidor.ini
    autenticacion = basic
    y <path proyecto Gestión>/instalacion/i__<instancia>/p__guarani/rest/servidor_usuarios.ini
    ;servidor_usuarios.ini
    [ue_guarani]
    password = sP6lgHwQopaqepOzgIWw ;cambiar!
    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

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

En SIU-Guaraní 3w

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(

        'gestion' => array(
                'tipo' => 'rest',
                'parametros' => array( //usa cliente Guzzle, son opciones en formato guzzle
                        'base_url' => "http://<GuaraniGestion>/rest/",
                        'defaults' => array (
                                'auth' => array('ue_guarani', 'sP6lgHwQopaqepOzgIWw'), //user, password, segun guzzle
                                'verify' => false //no verificar cert ssl
                        )
                )
        ),

)
...

Se debe reemplazar:

  • <path proyecto 3w>: por el path donde se encuentra instalado el proyecto SIU-Guaraní 3w
  • <url proyecto Gestión>: por la url donde se encuentra instalado el proyecto SIU-Guaraní Gestión
Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.14.0/interfaces/gestion-3w-rest&oldid=55111»