Herramientas de usuario

Herramientas del sitio


aspectos-tecnicos:webapi:antarepocketserver

¡Esta es una revisión vieja del documento!


Instalación y Configuración de Antare Pocket Services

El ecosistema Antare, además de su aplicación principal de escritorio, consiste también en una aplicación que se ejecuta en dispositivos móviles Android llamada Antare Pocket, y otra, en desarrollo, que es albergada en navegadores web como Chrome. Asi como una interfaz API REST, la cual se prevee para futuros desarrollos y conexión con aplicaciones de terceros, tales como sitios de e-Commerce etc.

El objetivo de estas aplicaciones es extender las capacidades de Antare mas allá del entorno Windows a escenarios donde se requiere movilidad y acceso desde fuera de la red. Tales como tomas de pedido en el sitio, arqueos de inventario, fotografías de productos, etc.

Este artículo tiene como objetivo el adiestramiento al personal técnico o integrador en la instalación y configuración de estas aplicaciones en un servidor que ya tiene la aplicación de escritorio Antare previamente instalada y operativa.

Componentes de Antare Pocket Services

El siguiente diagrama proporciona una visualización de los componentes de Antare Pocket Services y su interacción con otros elementos:

Componentes del Lado Cliente

Antare Pocket

Antare Pocket es una aplicación actualmente desarrollada en Android destinada a escenarios que requieran movilidad, tales como el de un un mesero tomando una orden a los comensales, un almacenista que realiza tomas físicas de inventario, un vendedor itinerante que tome pedidos a sus clientes, un operador de delivery que tome órdenes, etc.

Se descarga desde Google Play Store y se actualiza automáticamente mediante esta misma plataforma.

Antare Pocket conecta con Antare Pocket Server previa autenticación y autorización proporcionada por Antare Identity Server, para realizar transacciones hacia la Base de Datos SQL Server de Antare bajo las reglas y contratos establecidos en la API REST que Antare Pocket Server expone.

Al descargar la aplicación desde Google Play Store, se tiene la opción de utilizarla accediendo a la base de datos de demostración previamente configurada en la nube.

Antare Web

Antare Web (nombre temporal), es una aplicación Web en desarrollo, que tiene como objetivo proporcionar al usuario al menos la mayoria de las funciones actualmente disponibles en la aplicación de escritorio Antare (Facturación, Inventario, Caja, etc).

Se accede abriendo la URL https://app.servidorantare.lan desde cualquier navegador moderno (Chrome, Edge, etc) y se adaptará a cualquier tamaño de pantalla.

Al igual que con Antare Pocket, Antare Web conecta con Antare Pocket Server previa autenticación y autorización proporcionada por Antare Identity Server, para realizar transacciones hacia la Base de Datos SQL Server de Antare bajo las reglas y contratos establecidos en la API REST que Antare Pocket Server expone.

Gestor de Usuarios Antare

Gestor de Usuarios Antare es una aplicación Web que permite gestionar cuentas de usuario para vincular con ellas los dispositivos con Antare Pocket y el acceso de usuarios a Antare Web

Esta aplicación Web se accede mediante la URL https://usuarios.servidorantare.lan, Los usuarios que se registran mediante esta aplicación se identifican unicamente a través de su dirección email.

De todos las cuentas de usuario que se registren bajo esta aplicación, solo se reconocen como usuarios de Antare a aquellos cuya dirección email figura en la ficha Seguridad / Cuentas de Usuarios que se accede desde la aplicación Antare de escritorio. Las demás cuentas de usuarios podrían ser entonces de visitantes de sitios Web, o bien clientes o proveedores.

Componentes del Lado del Servidor

Antare Identity Server

Antare Identity Server es una implementación de Identity Server enfocada a los requerimientos de Antare Pocket Services. Es una aplicación Web normalmente hospedada en la característica de Windows Microsoft Internet Information Services (IIS) que se encarga por una parte de autenticar y proporcionar credenciales de acceso a las aplicaciones Antare Pocket y Antare Web, y por otra parte, mantener un registro de cuentas de usuarios que forman parte de este ecosistema, identificados por su dirección email, registro accesible desde https://usuarios.servidorantare.lan

Al traer consigo todo lo que ofrece Identity Server, es posible configurar Antare Identity Server para delegar la autenticación de usuarios a servicios externos como Google OpenId, o Cuentas de Microsoft cuando se hospeda en VPS con dominios FQDN registrados.

Estando el usuario correctamente autenticado y con una dirección email que concide con su ficha en Antare, Antare Pocket Server tendrá siempre la información suficiente que le permita otorgarle acceso a los recursos que este usuario tiene derecho, según los permisos establecidos.

En resumen, todo lo que tiene que ver con identificar correctamente a cada usuario de la plataforma, (Nombre y Grupo o rango al que pertenece) para posteriormente saber a qué funciones de Antare tiene no tiene acceso, queda a cargo de Antare Identity Server

Antare Pocket Server

Antare Pocket Server es una aplicación Web que también se hospeda en una instancia de Microsoft Internet Information Services (IIS) y contiene toda la lógica de negocios que se va migrando progresivamente desde la aplicación de escritorio clásico Antare encapsulada en un núcleo, hacia el cual se conectan las aplicaciones cliente como Antare Pocket o Antare Web únicamente a través de la API que este expone.

Antare Pocket Server es el único componente de este ecosistema (aparte de la aplicación de escritorio Windows) con conexión directa a la Base de Datos SQL, dando a entender que toda transacción o modificación a ésta, normalmente se lleva a cabo a través de estos dos componentes, segun las reglas de negocio establecidas (Procesos de facturación, inventario, Caja, etc).

Antare Pocket Server también sirve a los navegadores que conectan a https://app.servidorantare.lan los correspondientes binarios y código html que forman parte de la aplicación Antare Web.

Proceso de Instalación

Una vez que se tenga instalada y configurada la aplicación de escritorio Antare accediendo a la correspondiente Base de Datos SQL debidamente inicializada (es decir, con la Empresa ya definida en la misma) en el servidor:

1. Se fija la IP del mismo, preferiblemente a una que esté fuera del Pool DHCP del router.

2. Se asegura de que el Firewall de Windows en el equipo tenga el perfil de Red Privada

3. Se ejecutan uno tras otro y en el siguiente orden los siguientes instaladores:

Instalar Antare Identity Server

El instalador de Antare Identity Server está disponible en este enlace permanente

Al ejecutar el instalador, ocurren los siguientes pasos en forma de asistente:

  1. Chequea la presencia de Internet Information Services (IIS) en el equipo. En caso de no detectarlo se interrumpe la instalación para guiar al usuario a activarlo.
  2. Detecta si la aplicación fue o no fué previamente instalada para ejecutar la instalación desde cero o actualizar los archivos existentes.
  3. Si la aplicación se instala desde cero, definir los parámetros del Servidor SQL instalado en el equipo para preparar una nueva base de datos llamada AntareIdentitySQL (u otro nombre que defina el usuario). Estos parámetros son validados por el instalador antes de continuar.

Instalación de componentes de Apoyo

Para el correcto funcionamiento de los Servicios de Antare Pocket en todos los equipos de la red del establecimiento, se precisa que en todos ellos se reconozca efectivamente los dominios locales https://app.servidorantare.lan o https://usuarios.servidorantare.lan y que estos traduzcan o apunten efectivamente a la dirección IP del servidor, donde Antare Pocket/Identity Server están esperando las conexiones entrantes.

Este propósito

aspectos-tecnicos/webapi/antarepocketserver.1789440985.txt.gz · Última modificación: por antarex