Puesta en marcha
Activación de dispositivos
Para trabajar, la app necesita dos datos que el usuario no conoce y que no deben teclearse a mano: la base de datos de su empresa y la cuenta de aplicación con la que se conecta a la Data API de FileMaker. Los dos viajan en la clave de activación, un texto cifrado que genera FileMaker y que el usuario recibe por correo cuando se le invita a la app desde s360 escritorio. Se introduce una sola vez en cada dispositivo: después, la app la recuerda.
Antes de activar un dispositivo#
Para que una persona pueda entrar en la app tienen que estar hechas tres cosas en s360 escritorio, por este orden:
- Un usuario creado en Configuración › Usuarios.
- Ese usuario asociado a una persona en Gestión › Personas.
- Un perfil asignado a la persona. La app no deja entrar a un usuario sin perfil: avisa con «No puede acceder. El usuario no tiene asignado un perfil.» y vuelve al formulario.
La invitación, que es la que envía el correo con la clave, se hace desde Configuración › App Config. La pantalla está descrita en Gestión de app móvil, en el manual de s360 escritorio.
Qué contiene la clave#
Una vez descifrada, la clave lleva el código de empresa y la cuenta de aplicación de la Data API. La app construye con ellos la base PRO-01-<código de empresa>, elige el servidor según el código (ver Arquitectura) y guarda la configuración en el almacenamiento seguro del dispositivo, que en Android es el Keystore y en iOS el llavero.
La clave no lleva el usuario ni la contraseña de la persona: con la misma clave se activan todos los dispositivos de una empresa, y cada persona entra después con sus propias credenciales.
Cuándo la pide la app#
La app no tiene una pantalla de activación propia. El diálogo «Activación de cuenta» aparece cuando un inicio de sesión falla por un motivo que la app no reconoce como otro conocido. En un dispositivo nuevo, eso pasa en el primer intento: la app todavía no tiene cuenta de aplicación, FileMaker rechaza la conexión y la app pide la clave.
No piden la clave, en cambio, los fallos que la app sabe distinguir:
| Situación | Lo que ve el usuario |
|---|---|
| Usuario o contraseña incorrectos | «Error de inicio de sesión. Usuario o contraseña no válido.» |
| El usuario no tiene persona asignada | «Error de inicio de sesión. El usuario no tiene persona asignada.» |
| Sin conexión, nombre del servidor sin resolver, tiempo de espera agotado o una conexión que se corta a medias | Intenta el acceso sin conexión y, si no puede, «No hay conexión a internet. Conéctate para iniciar sesión.» |
| El servidor responde con un error 502, 503 o 504 | «El servidor no está disponible en este momento (error N)…», sin pedir nada |
| El servidor responde con un error 500 | «Error 500. Póngase en contacto con soporte.» |
Cualquier otro fallo acaba en el diálogo de activación. Eso incluye un código de empresa mal escrito, porque la base no existe y FileMaker rechaza la conexión igual que con un dispositivo sin activar. Antes de enviar una clave nueva a quien dice que la app se la pide, conviene comprobar el código de empresa que ha tecleado.
Qué pasa al introducirla#
La app descifra la clave, toma de ella el código de empresa, que sustituye al del formulario, y pide un token a la Data API con la cuenta de aplicación:
| Mensaje | Qué significa |
|---|---|
| «¡Cuenta activada! Ya puede iniciar sesión» | La clave es válida y FileMaker ha aceptado la cuenta. El usuario ya puede pulsar «Iniciar sesión» |
| «Error al activar la cuenta» | La clave se ha podido leer, pero FileMaker no ha dado un token: el servidor no responde o la cuenta de la clave ya no es válida |
| «Clave errónea» | La clave no se ha podido descifrar. Lo habitual es que se haya copiado incompleta o con espacios de más |
Una activación fallida sustituye a la configuración anterior
La app guarda la configuración de la clave aunque FileMaker rechace la cuenta. Si en un dispositivo que ya funcionaba se introduce una clave de otra empresa o una clave antigua, el dispositivo se queda con esa configuración y deja de entrar hasta que se introduzca una clave buena.
Cuándo hay que volver a activar#
La configuración se conserva al actualizar la app y al cerrar sesión. Hay que introducir la clave otra vez cuando:
- Se borran los datos de la app desde los ajustes del sistema, o se reinstala en Android. Con ello se pierden también los cambios que estuvieran pendientes de enviar. En iOS, el sistema puede conservar la configuración del llavero aunque se desinstale la app, pero los cambios pendientes se pierden igual.
- Cambia la contraseña de la cuenta de aplicación de la Data API en FileMaker. Todos los dispositivos de la empresa dejan de poder conectarse en cuanto caduca su sesión, y piden la clave en el siguiente inicio de sesión. Hace falta enviarles una clave nueva.
- Se cambia el código de empresa en el formulario y la cuenta de aplicación guardada no sirve para la base de la nueva empresa. La app pide entonces la clave de esa empresa.
El contrato de licencia en el primer inicio de sesión#
Si la marca ACTIVAR_ACEPTACION del usuario no está a 0, después de validar las credenciales la app muestra la aceptación del contrato de licencia de uso de software. El usuario tiene que descargar el PDF del contrato antes de poder aceptarlo, y al aceptarlo la app pone ACTIVAR_ACEPTACION a 0 en API_USUARIOS. No guarda la fecha ni la versión del contrato aceptado. Si no consigue guardar la marca, devuelve al usuario al formulario con «Error al iniciar sesión», aunque las credenciales fueran buenas.
Hasta que no se acepta el contrato, el dispositivo no queda habilitado para el acceso sin conexión.
Recuperar la contraseña#
«Recuperar contraseña», en la pantalla de inicio de sesión, llama al guion resetpwd de TABLA_USUARIOS con el usuario escrito en el formulario. Si la llamada llega a FileMaker, la app muestra «Se ha enviado un correo para la recuperación de su contraseña», sin mirar lo que haya contestado el guion: el mensaje sale también si el usuario no existe. Si la llamada no llega, normalmente porque el dispositivo no está activado, la app pide la clave de activación y vuelve a intentarlo con ella.
Solicitar una cuenta#
«¿No tienes cuenta aún? ¡Solicítala!» abre un formulario con nombre, empresa, correo y teléfono, y prepara con esos datos un correo a Esofitec en la aplicación de correo del dispositivo. No crea nada en FileMaker. La app muestra «Correo electrónico enviado con éxito» en cuanto abre el correo, aunque el usuario no llegue a enviarlo.