Diferencia entre revisiones de «SIU-Guarani/version3.21.0/interfaces/boleto-estudiantil»

De SIU
Saltar a: navegación, buscar
m
m
Línea 1: Línea 1:
 
__NOTOC__
 
__NOTOC__
 
= Boleto Estudiantil =
 
= Boleto Estudiantil =
 +
 +
== En SIU-Guaraní Autogestión ==
 +
 +
Antes que nada debe contactarse con el '''Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires''' solicitándoles las credenciales de acceso a los servicios de transporte. Para ello deben enviar un mail a ​contactouniversidades.minfra@gmail.com indicando la institución.<br />
 +
Una vez realizado el contacto recibirán la '''''URL del Servicio''''', '''''Usuario''''', '''''Contraseña''''' y el '''''código Institución Boleto''''' (Student Departament).
  
 
== En SIU-Guaraní Autogestión ==
 
== En SIU-Guaraní Autogestión ==
Línea 13: Línea 18:
 
En la operación '''» Administración » Modificar Parámetros del Sistema''' se debe configurar el parámetro '''usa_boleto_estudiantil''' con el valor ''Se utiliza boleto estudiantil''.
 
En la operación '''» Administración » Modificar Parámetros del Sistema''' se debe configurar el parámetro '''usa_boleto_estudiantil''' con el valor ''Se utiliza boleto estudiantil''.
  
1) Solicitar al administrador de '''SICer''' usuario, contraseña y URLs para utilizar el servicio REST. Luego crear y configurar el archivo '''<path proyecto Gestión>/instalacion/i__<instancia>/p__guarani/rest/sidcer/cliente.ini'''
 
<source lang="php" enclose="div">
 
;cliente.ini
 
[conexion]
 
to = "<url_sidcer>/rest/"
 
auth_tipo = basic o digest
 
auth_usuario = <usuario>
 
auth_password = <password>
 
</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
 
* <url_sidcer>: por la URL donde se encuentra SICer
 
* <usuario>: Usuario otorgado por el administrador de SICer
 
* <password>: Password otorgado por el administrador de SICer
 
  
=== En SIU-Guaraní 3w ===
+
2) Configurar el archivo '''instalacion/servicios_web_config.php''' (si no existe hacer una copia desde el archivo '''instalacion/servicios_web_config_template.php''' ubicado en el mismo directorio)
1) Solicitar al administrador de '''SICer''' usuario, contraseña y URLs para utilizar el servicio REST.  
 
  
2) 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)
 
 
<source lang="php" enclose="div">
 
<source lang="php" enclose="div">
 
...
 
...
'consumidos' => array(
+
'consumidos' => [
  
'sidcer' => array(
+
'boleto_estudiantil' => [
'tipo' => 'rest',
+
'tipo' => 'rest',
'parametros' => array( //usa cliente Guzzle, son opciones en formato guzzle
+
'parametros' => [
'base_uri' => "<url_sidcer>/rest/",
+
'base_uri' => "https://boletoeducativo.gba.gob.ar/ws/",
'auth' => array('<usuario>', '<password>', <tipo-auth>), //user, password, segun guzzle
+
'auth' => ['SIU3ftu', 'prueba2022', 'basic'],
)
+
'auth_ua' => 'SIUG3'
),
+
]
 +
],
  
)
+
]
 
...
 
...
</source>
 
Se debe reemplazar:
 
* <path proyecto 3w>: por el path donde se encuentra instalado el proyecto SIU-Guaraní 3w
 
* <url_sidcer>: por la URL donde se encuentra SICer
 
* <usuario>: Usuario otorgado por el administrador de SICer
 
* <password>: Password otorgado por el administrador de SICer
 
* <tipo-auth>: '''basic''' o '''digest'''. [http://docs.guzzlephp.org/en/stable/request-options.html#auth Ver documentación de Guzzle].
 
 
== Para que SICer consuma los Web Services de SIU-Guaraní ==
 
 
 
Configurar la API REST como se especifica en el siguiente [[SIU-Guarani/version3.21.0/interfaces/api-guarani-perfil-funcional |link]].
 
 
En '''<path proyecto Gestión>/instalacion/i__desarrollo/p__guarani/rest/servidor_usuarios.ini''' agregar el/los usuario/s de API REST para SICer, por ejemplo:
 
<source lang="php" enclose="div">
 
[sicer1]
 
password = 123456789*-a
 
 
[sicer2]
 
password = 123456789*-a
 
</source>
 
 
Luego en '''<path proyecto Gestión>/php/rest/recursos_usuarios.php''' configurar el usuario de SICer, por ejemplo:
 
<source lang="php" enclose="div">
 
$usuarios_sidcer = ['sicer1', 'sicer2'];
 
</source>
 
 
Esto hace que el/los usuario/s dentro de '''$usuarios_sidcer''' estén habilitados a utilizar los recursos necesarios para la comunicación de SICer con SIU-Guaraní.
 
 
Si ya disponía de una comunicación con SICer, se deberá informar al SIU las nuevas URLs, usuario y password para la comunicación con SICer. Las URLs a informar quedarían de la siguiente forma:
 
 
<source lang="php" enclose="div">
 
<url_gestion>/rest/v1/
 
 
</source>
 
</source>
  
[https://foro.comunidad.siu.edu.ar/index.php?board=85.0 Aquí] pueden realizar consultas sobre la interfaz con Sicer
+
Se debe reemplazar:<br />
 +
<path proyecto 3w>: por el path donde se encuentra instalado el proyecto SIU-Guaraní 3w<br />
 +
'''''<url_sidcer>:''''' por la URL donde se encuentra SICer<br />
 +
'''''<usuario>:''''' Usuario otorgado por el administrador de SICer<br />
 +
'''''<password>:''''' Password otorgado por el administrador de SICer<br />
 +
'''''<tipo-auth>:''''' '''basic''' o '''digest'''. [http://docs.guzzlephp.org/en/stable/request-options.html#auth Ver documentación de Guzzle].<br />

Revisión del 10:02 5 dic 2022

Boleto Estudiantil

En SIU-Guaraní Autogestión

Antes que nada debe contactarse con el Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires solicitándoles las credenciales de acceso a los servicios de transporte. Para ello deben enviar un mail a ​contactouniversidades.minfra@gmail.com indicando la institución.
Una vez realizado el contacto recibirán la URL del Servicio, Usuario, Contraseña y el código Institución Boleto (Student Departament).

En SIU-Guaraní Autogestión

A partir de la versión 3.21.0 se incorpora la operación de Beneficio de Boleto Estudiantil en SIU-Guaraní Autogestión (previamente se tenia que instalar como una personalización).


Pasos para la activación y configuración

1) Activar el parámetro usa_boleto_estudiantil

En la operación » Administración » Modificar Parámetros del Sistema se debe configurar el parámetro usa_boleto_estudiantil con el valor Se utiliza boleto estudiantil.


2) Configurar el archivo instalacion/servicios_web_config.php (si no existe hacer una copia desde el archivo instalacion/servicios_web_config_template.php ubicado en el mismo directorio)

...
'consumidos' => [

                'boleto_estudiantil' => [
                        'tipo' => 'rest',
                        'parametros' => [
                                'base_uri' => "https://boletoeducativo.gba.gob.ar/ws/",
                                'auth' => ['SIU3ftu', 'prueba2022', 'basic'],
                                'auth_ua' => 'SIUG3'
                        ]
                ],

]
...

Se debe reemplazar:
<path proyecto 3w>: por el path donde se encuentra instalado el proyecto SIU-Guaraní 3w
<url_sidcer>: por la URL donde se encuentra SICer
<usuario>: Usuario otorgado por el administrador de SICer
<password>: Password otorgado por el administrador de SICer
<tipo-auth>: basic o digest. Ver documentación de Guzzle.