Configuración Servicios Web #
Cuando el sistema, en alguna estación de Administración o de Punto de Venta requiere realizar una operación o consulta que implique que los datos se tomen de una base de datos principal, la consulta directamente a través de un Servicio Web.
Prerrequisitos #
Un componente de la configuración de este Servicio Web, es la instalación del ASP.NET Core 7.0 Runtime, considerada una actualización del NetFramework, misma que puede descargar en el siguiente enlace:
Una vez descargado, ejecute con doble clic para que inicie la instalación.
En la primera pantalla que muestra el instalador, habilite el parámetro que acepta los términos y condiciones de la licencia; para que se active el botón Install, y después presione.
Mostrará una pantalla de Windows, para que el usuario confirme si permite que se hagan los cambios en el equipo. Presione el botón Sí.
Iniciará la instalación.
Presione el botón Close, la actualización quedará lista.
Instalación de componentes #
En primera instancia, el equipo deberá tener instalado el IIS (Internet Information Services), este servicio convierte a una PC en un servidor web para Internet. Valide si se encuentra instalada en el equipo la carpeta wwwroot en la ruta: C:\inetpub; en caso de que no se encuentre, siga los siguientes pasos:
En la ruta: Panel de control\Programas\Programas y características, presione la opción que se encuentra al lado superior izquierdo de la pantalla: Activar o desactivar las características de Windows
A continuación, se habilitará la siguiente ventana, en la cual deberá activar la casilla de Internet Information Services, así como todas las carpetas contenidas y que dependen de él, como se muestra en la siguiente imagen. Después presione el botón Aceptar.
Automáticamente comenzará el proceso para habilitar el IIS en el equipo.
Una vez que finalice, presione el botón Cerrar, y verifique que la carpeta wwwroot se encuentre insertada en la ruta: C:\inetpub
También uno de los requisitos para el funcionamiento de los Servicios Web, es activar Framework 4 o superior, con todas sus casillas, en la misma ruta de IIS. Presione el botón Aceptar.
Dentro de la carpeta de la versión del sistema, existe una, a su vez, que se llama PDVMovilApi, misma que deberá insertar en la ruta: C:\inetpub\wwwroot, como se muestra en las imágenes siguientes:
Habilite desde el buscador de Windows los IIS (Administrador de Internet Information Services), como se muestra en la siguiente imagen, y de clic con el mouse en la opción.
Nota: es importante recordar que, para estos procesos de configuración, se deben de tener los permisos de Administrador de Windows.
Aparecerá la siguiente pantalla, donde deberá dar un doble clic sobre la opción sobre el nombre del equipo (para este ejemplo: DESKTOP-BM8EFHI); se habilitará las opciones: Grupos de aplicaciones y Sitios.
Deberá posicionarse en la opción Sitios (que se encuentra en la parte superior izquierda), como se muestra a continuación y con un clic derecho, seleccione Agregar sitio web
Capture PDVMovil en el campo: Nombre del sitio, después presione el botón Seleccionar para configurar el Grupo de aplicaciones al que va a pertenecer. De la lista desplegable que se muestre, seleccione la opción .NET v4.5 Classic y posteriormente, el botón Aceptar.
En la sección de Ruta de acceso física, seleccione donde se encuentra la carpeta proporcionada por Soporte (C:\inetpub\wwwroot\). Presione el botón Aceptar. Las siguientes imágenes muestran los pasos mencionados.
Por default, en el campo de Puerto, viene especificado el 80, se sugiere elegir otro para el uso de este servicio web. Para este ejemplo, se recomienda el 8090.
El resto de la información de la pantalla, queda igual. Presione el botón Aceptar.
A continuación, deberá habilitar en la opción Grupos de aplicaciones con doble clic. Seleccione de la lista que se activa, la que fue seleccionada en los pasos anteriores (.NET v4.5 Classic), y con un clic derecho, seleccione: Configuración avanzada
En la primera sección de la ventana que muestra, cambie False por la palabra True, por medio de la lista desplegable que se mostrará en ese mismo campo al extremo superior derecho de ésa misma pantalla.
En esa misma sección de Grupo de aplicaciones, con un clic derecho del mouse, habilite y seleccione la opción “Agregar grupo de aplicaciones”. Se habilitará una ventana donde deberá capturar el nombre de la aplicación, que deberá llevar el mismo nombre que el sitio web que se acaba de crear. Para éste ejemplo: PDVMovil, como se puede visualizar en la imagen siguiente, en Sitios.
Capture el mismo nombre y presione el botón Aceptar, no es necesario generar algún cambio en los demás campos.
Una vez creado, con un clic derecho, seleccione la opción Configuración avanzada:
Y en la pantalla que se habilite, en el primer campo, también seleccione True (como fue explicado anteriormente), presione el botón Aceptar.
Reinicié el servicio en la sección de Acciones, que se encuentra en la parte derecha de la pantalla. Presione en primera instancia Detener y después, una vez habilitado: Iniciar.
Posiciónese en PDVMovil en el Menú Sitios; y en la sección de la página principal, se encuentra dentro de las opciones IIS, el ícono de Módulos (señalado en la imagen siguiente); ingrese al mismo con doble clic:
En el listado se encuentra un módulo llamado WebDAVModule, elimínelo por cualquiera de éstas dos opciones: seleccione y con clic derecho presione Quitar, o bien, en Acciones (lado superior derecho de ésa misma pantalla).
Se mostrará el siguiente mensaje de aviso, presione el botón Sí, y reinicié el servicio.
Con éste paso, queda finalizado el proceso relacionado con el Administrador de Internet Information Services (IIS).
Nota: es recomendable reiniciar el equipo.
A continuación, en la ruta: C:\inetpub\wwwroot\PDVMovilApi, habilite el archivo JSON appsettings:
En el renglón “sqlConnection”, capture en los respectivos campos, la siguiente información:
- Data Source: la ip del equipo
- Initial Catalog: el nombre de la base de datos a la que se conectará el servicio
- User ID: nombre del usuario con el que ingresa al motor de la base de datos (Microsoft SQL)
- Password: contraseña del usuario
El resto de la información del archivo, quedará igual. Guarde los cambios del archivo.
Para finalizar, valide la URL en el navegador de internet, que deberá estar compuesta por: la dirección IP del equipo, seguido de dos puntos (:); el puerto que se configuró para esos servicios, seguido de diagonal (/), siglas api, seguido de diagonal (/), y pdvmoviles.
Para que se muestre información, el Servicio Web deberá estar relacionado por lo menos con un dispositivo; en caso contrario, enviará un sitio sin información, solo con “corchetes”.
A continuación, se muestra un ejemplo:
http://192.168.100.15:8090/api/pdvmoviles