Diferencia entre revisiones de «SIU-Guarani/API-App»
(No se muestran 8 ediciones intermedias de 3 usuarios) | |||
Línea 1: | Línea 1: | ||
− | + | = API APP = | |
El vínculo entre la aplicación móvil SIU Guaraní y los datos de Gestión | El vínculo entre la aplicación móvil SIU Guaraní y los datos de Gestión | ||
− | === ¿Qué necesito? | + | == Pasos para solicitar e implementar la App para celulares == |
+ | |||
+ | 1) Descargar los archivos de la app del colab y realizar la instalación de un ambiente de prueba. El mismo debe ser público.<br> | ||
+ | 2) El responsable de Proyecto debe enviar un GDS solicitando una apk de prueba para hacer los testeos. En el GDS se deberán indicar las URL de la API-Rest y el ambiente de pruebas de Autogestión.<br> | ||
+ | 3) Les enviaremos una apk para que realicen las pruebas necesarias sobre la app.<br> | ||
+ | 4) Una vez concluida la fase de testeo deberán pasar la API-Rest a un servidor productivo y nos informan vía GDS que ya están listos para pasar a producción y los incorporaremos al catálogo de instituciones de la app. En el GDS deberán informar las URL de la API-App y del ambiente de Autogestión de Producción.<br> | ||
+ | |||
+ | == ¿Qué necesito? == | ||
* composer | * composer | ||
* php 5.6 o superior | * php 5.6 o superior | ||
+ | * Conexión a la base de datos de Gestión | ||
+ | ** Debe poder leer las siguientes tablas: acc_login_externos, mdp_personas, men_documentos, men_mensajes, men_destinatarios, rep_archivos, sga_alumnos, sga_asignaciones, sga_clases, sga_clases_tipos, sga_comisiones, sga_comisiones_bh, sga_edificaciones, sga_elementos, sga_espacios, sga_espacios_asignacion, sga_insc_cursada, sga_insc_examen, sga_llamados_mesa, sga_mesas_examen, sga_ubicaciones | ||
+ | ** Debe poder leer y modificar la tabla men_destinatarios | ||
− | + | == Instalación == | |
* Descargar el código fuente desde su nodo svn checkout | * Descargar el código fuente desde su nodo svn checkout | ||
− | <nowiki>http://colab.siu.edu.ar/svn/guarani3/nodos/</nowiki><siglas institución>/ | + | <nowiki>http://colab.siu.edu.ar/svn/guarani3/nodos/</nowiki><siglas institución>/api_app/trunk/1.0.x <path proyecto api-app> |
* Ejecutar: composer install | * Ejecutar: composer install | ||
+ | |||
+ | Puede elegir entre la configuración manual o mediante script | ||
+ | |||
+ | Manual | ||
* Copiar el archivo parametros_template.ini a parametros.ini | * Copiar el archivo parametros_template.ini a parametros.ini | ||
* Configurar el archivo parametros.ini | * Configurar el archivo parametros.ini | ||
* Copiar el archivo alias_api_template.conf a alias_api.conf | * Copiar el archivo alias_api_template.conf a alias_api.conf | ||
− | * Configurar alias_api.con con el alias y el path. Debe Respetar el mismo alias | + | * Configurar alias_api.con con el alias y el path. (Debe Respetar el mismo alias usado en parametros.ini) |
+ | |||
+ | Script (desde la versión 1.0.2) | ||
+ | * Dar permiso de ejecución al script, chmod +x configurar.sh | ||
+ | * Ejecutar el script configurar.sh y seguir las instrucciones | ||
+ | |||
+ | Pasos finales | ||
* Ejecutar: ln -s /alias_api.conf /etc/apache2/sites-enabled/.conf | * Ejecutar: ln -s /alias_api.conf /etc/apache2/sites-enabled/.conf | ||
* Reiniciar Apache | * Reiniciar Apache | ||
+ | |||
+ | ''(Según su sistema algunos comandos pueden requerir privilegios)'' | ||
+ | |||
+ | == Configurar Interfaz APP-Autogestión == | ||
+ | |||
+ | Para que los usuarios de la App de Guaraní puedan a través de ella ingresar al modulo 3W, se hace uso de la tecnología JWT. Para que esto sea posible se debe configurar lo siguiente: [[SIU-Guarani/version3.20.0/interfaces/app-3w-jwt | Interfaz APP-Autogestión]] |
Revisión actual del 11:48 21 ene 2022
Sumario
API APP
El vínculo entre la aplicación móvil SIU Guaraní y los datos de Gestión
Pasos para solicitar e implementar la App para celulares
1) Descargar los archivos de la app del colab y realizar la instalación de un ambiente de prueba. El mismo debe ser público.
2) El responsable de Proyecto debe enviar un GDS solicitando una apk de prueba para hacer los testeos. En el GDS se deberán indicar las URL de la API-Rest y el ambiente de pruebas de Autogestión.
3) Les enviaremos una apk para que realicen las pruebas necesarias sobre la app.
4) Una vez concluida la fase de testeo deberán pasar la API-Rest a un servidor productivo y nos informan vía GDS que ya están listos para pasar a producción y los incorporaremos al catálogo de instituciones de la app. En el GDS deberán informar las URL de la API-App y del ambiente de Autogestión de Producción.
¿Qué necesito?
- composer
- php 5.6 o superior
- Conexión a la base de datos de Gestión
- Debe poder leer las siguientes tablas: acc_login_externos, mdp_personas, men_documentos, men_mensajes, men_destinatarios, rep_archivos, sga_alumnos, sga_asignaciones, sga_clases, sga_clases_tipos, sga_comisiones, sga_comisiones_bh, sga_edificaciones, sga_elementos, sga_espacios, sga_espacios_asignacion, sga_insc_cursada, sga_insc_examen, sga_llamados_mesa, sga_mesas_examen, sga_ubicaciones
- Debe poder leer y modificar la tabla men_destinatarios
Instalación
- Descargar el código fuente desde su nodo svn checkout
http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/api_app/trunk/1.0.x <path proyecto api-app>
- Ejecutar: composer install
Puede elegir entre la configuración manual o mediante script
Manual
- Copiar el archivo parametros_template.ini a parametros.ini
- Configurar el archivo parametros.ini
- Copiar el archivo alias_api_template.conf a alias_api.conf
- Configurar alias_api.con con el alias y el path. (Debe Respetar el mismo alias usado en parametros.ini)
Script (desde la versión 1.0.2)
- Dar permiso de ejecución al script, chmod +x configurar.sh
- Ejecutar el script configurar.sh y seguir las instrucciones
Pasos finales
- Ejecutar: ln -s /alias_api.conf /etc/apache2/sites-enabled/.conf
- Reiniciar Apache
(Según su sistema algunos comandos pueden requerir privilegios)
Configurar Interfaz APP-Autogestión
Para que los usuarios de la App de Guaraní puedan a través de ella ingresar al modulo 3W, se hace uso de la tecnología JWT. Para que esto sea posible se debe configurar lo siguiente: Interfaz APP-Autogestión