Diferencia entre revisiones de «SIU-Guarani/API-App»

De SIU
Saltar a: navegación, buscar
(Instalación)
 
(No se muestran 7 ediciones intermedias de 3 usuarios)
Línea 1: Línea 1:
=== API APP ===
+
= 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 ===
+
== 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>/api-app/trunk/1.0.x <path proyecto api-app>
+
<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
  
Línea 31: Línea 41:
  
 
''(Según su sistema algunos comandos pueden requerir privilegios)''
 
''(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

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