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

De SIU
Saltar a: navegación, buscar
(Página creada con «__NOTOC__ = Boleto Estudiantil = === En SIU-Guaraní Autogestión === 1) Solicitar al administrador de '''SICer''' usuario, contraseña y URLs para utilizar el servicio RE...»)
 
m
 
(No se muestran 17 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
−
__NOTOC__
 
 
= Boleto Estudiantil =
 
= Boleto Estudiantil =
  
−
=== En SIU-Guaraní Autogestión ===
+
== Obtención de credenciales ==
−
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">
+
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 [mailto:contactouniversidades@transporte.gba.gob.ar contactouniversidades@transporte.gba.gob.ar] indicando la institución.<br />
−
;cliente.ini
+
Una vez realizado el contacto recibirán la '''''URL del Servicio''''', '''''Usuario''''', '''''Contraseña''''' y el '''''código Institución''''' (Student Departament).
−
[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 ===
+
== En SIU-Guaraní Autogestión ==
−
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)
+
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).
−
<source lang="php" enclose="div">
 
−
...
 
−
'consumidos' => array(
 
  
−
'sidcer' => array(
+
=== Pasos para la activación y configuración ===
−
'tipo' => 'rest',
 
−
'parametros' => array( //usa cliente Guzzle, son opciones en formato guzzle
 
−
'base_uri' => "<url_sidcer>/rest/",
 
−
'auth' => array('<usuario>', '<password>', <tipo-auth>), //user, password, segun guzzle
 
−
)
 
−
),
 
  
−
)
+
1) Quitar la personalización de '''Boleto Estudiantil''' eliminando la carpeta '''src/pers/boleto_estudiantil''' y modificando la directiva ''personalizacion'' dentro del archivo '''instalacion/config.php'''.
−
...
 
−
</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í ==
+
2) Activar el parámetro '''usa_boleto_estudiantil'''
  
 +
En la operación '''» Administración » Modificar Parámetros del Sistema''' de '''SIU-Guaraní Gestión''' se debe configurar el parámetro '''usa_boleto_estudiantil''' con el valor ''Se utiliza boleto estudiantil''.
  
−
Configurar la API REST como se especifica en el siguiente [[SIU-Guarani/version3.21.0/interfaces/api-guarani-perfil-funcional |link]].
+
3) 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)
  
−
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">
 
<source lang="php" enclose="div">
−
[sicer1]
+
...
−
password = 123456789*-a
+
'consumidos' => [
 +
 
 +
'boleto_estudiantil' => [
 +
'tipo' => 'rest',
 +
'parametros' => [
 +
'base_uri' => "<URL-SUBE>",
 +
'auth' => ["<USUARIO>", "<PASSWORD>", "basic"],
 +
'auth_ua' => "<STUDENT-DEPARTMENT>",
 +
'verify' => false
 +
]
 +
],
  
−
[sicer2]
+
]
−
password = 123456789*-a
+
...
 
</source>
 
</source>
  
−
Luego en '''<path proyecto Gestión>/php/rest/recursos_usuarios.php''' configurar el usuario de SICer, por ejemplo:
+
Se debe reemplazar:<br />
−
<source lang="php" enclose="div">
+
'''''<URL-SUBE>:''''' URL donde se encuentra el Web Service de '''SUBE''', https://boletoeducativo.gba.gob.ar/ws/ para producción o https://test.boletoestudiantil.gba.gob.ar/ws/ para pruebas.<br />
−
$usuarios_sidcer = ['sicer1', 'sicer2'];
+
'''''<USUARIO>:''''' Usuario otorgado por el '''Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires'''.<br />
−
</source>
+
'''''<PASSWORD>:''''' Password otorgada por el '''Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires'''.<br />
 +
'''''<STUDENT-DEPARTMENT>:''''' Código Institución otorgado por '''Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires''' (Student Departament).<br />
  
−
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í.
+
4) Luego en '''SIU-Guaraní Autogestión''' con el perfil '''alumno''' se puede ingresar a la operación desde el menú '''»Trámites Trámites » Boleto estudiantil'''.
  
−
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:
+
== En SIU-Guaraní Gestión ==
  
−
<source lang="php" enclose="div">
+
Para los Web Services de '''Boleto Estudiantil''' seguir utilizando [https://colab.siu.edu.ar/trac/guarani3/wiki/contrib/boleto_estudiantil los pasos de instalación de COLAB].
−
<url_gestion>/rest/v1/
 
−
</source>
 
  
−
[https://foro.comunidad.siu.edu.ar/index.php?board=85.0 Aquí] pueden realizar consultas sobre la interfaz con Sicer
+
[[SIU-Guarani/version3.21.0/interfaces|🔙 Volver]]

Revisión actual del 15:52 15 abr 2024

Boleto Estudiantil

Obtención de credenciales

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@transporte.gba.gob.ar indicando la institución.
Una vez realizado el contacto recibirán la URL del Servicio, Usuario, Contraseña y el código Institución (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) Quitar la personalización de Boleto Estudiantil eliminando la carpeta src/pers/boleto_estudiantil y modificando la directiva personalizacion dentro del archivo instalacion/config.php.

2) Activar el parámetro usa_boleto_estudiantil

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

3) 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' => "<URL-SUBE>",
                                'auth' => ["<USUARIO>", "<PASSWORD>", "basic"],
                                'auth_ua' => "<STUDENT-DEPARTMENT>",
                                'verify' => false
                        ]
                ],

]
...

Se debe reemplazar:
<URL-SUBE>: URL donde se encuentra el Web Service de SUBE, https://boletoeducativo.gba.gob.ar/ws/ para producción o https://test.boletoestudiantil.gba.gob.ar/ws/ para pruebas.
<USUARIO>: Usuario otorgado por el Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires.
<PASSWORD>: Password otorgada por el Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires.
<STUDENT-DEPARTMENT>: Código Institución otorgado por Ministerio de Infraestructura y Servicios Públicos de la Provincia de Buenos Aires (Student Departament).

4) Luego en SIU-Guaraní Autogestión con el perfil alumno se puede ingresar a la operación desde el menú »Trámites Trámites » Boleto estudiantil.

En SIU-Guaraní Gestión

Para los Web Services de Boleto Estudiantil seguir utilizando los pasos de instalación de COLAB.

🔙 Volver

Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.21.0/interfaces/boleto-estudiantil&oldid=98621»