Manual de Usuario COMPUCAJA.net Servicios WEB

Transcripción

1 Manual de Usuario COMPUCAJA.net Servicios WEB 1 / 30

2 Tabla de Contenido Tabla de Contenido 2 Configuración Servicios Web 3 Instalación de componentes 3 Servicio Web Clientes 14 Servicio Web Consulta de Existencia Cliente 19 Servicio Web Consulta de Existencia Servidor 23 Servicio Web Notas de Traspaso 27 2 / 30

3 Configuración Servicios Web La mayoría de las características de COMPUCAJA.net, se basan en servicios web que se configuran, según se requiera en el Servidor Central, en el Servidor de Sucursal o en ambos. 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, por lo general al servidor central de toda la organización. Esto es muy útil cuando se consulta en línea datos centralizados, por ejemplo; la consulta de clientes o la existencia de inventario de todos los almacenes. 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 3 / 30

4 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 de Aceptar. Automáticamente comenzará el proceso para habilitar el IIS en el equipo. 4 / 30

5 Una vez que finalice, presione el botón de Cerrar, y verifique que la carpeta wwwroot se encuentre insertada en la ruta: C:\inetpub 5 / 30

6 Uno de los prerrequisitos para el funcionamiento de los Servicios Web, es activar Framework 4 o superior, también con todas sus casillas, en la misma ruta de IIS. Presione el botón de Aceptar. A continuación deberá instalar los Servicios Web de COMPUCAJA. net, con el instalador de la versión del sistema, proporcionada por el personal de Soporte e Implantación. La instalación es similar a los demás módulos. 6 / 30

7 Presione el botón de Next. Del listado que se muestra a continuación, seleccione las opciones: Notas de Traspaso, Alta de Clientes (instalación exclusiva para el equipo que fungirá como Servidor Central), Consulta de Existencia Servidor y Consulta Existencia Cliente. Presione el botón de Next. 7 / 30

8 En la siguiente pantalla se mostrará la carpeta donde quedarán los archivos una vez que se instalen los Servicios Web, que es la misma que insertó IIS. Presionar el botón Next. El proceso estará listo y tardará algunos minutos; presione el botón Install. 8 / 30

9 Una vez que se finalice la instalación, presione el botón Finish. 9 / 30

10 Confirme en la ruta: C:\inetpub\wwwroot, se hayan instalado satisfactoriamente las carpetas correspondientes a los Servicios Web de COMPUCAJA.net Habilite desde el buscador de Windows los IIS, como se muestra en la siguiente imagen, y de clic con el mouse en la opción. 10 / 30

11 Aparecerá la siguiente pantalla, donde deberá dar un doble clic sobre la opción sobre el nombre del equipo (para este ejemplo: ANALISIS4; se habilitará las opciones: Grupos de aplicaciones y Sitios. Presione sobre la opción Grupo de aplicaciones, y se mostrará el listado de las que se encuentran habilitadas, y en el caso de presionar sobre la carpeta de Sitios, podrá observar que se encuentra Default Web Site, con las aplicaciones de cada uno de los Servicios Web de COMPUCAJA.net. 11 / 30

12 El siguiente paso es validar si el Sistema Operativo del equipo es tipo de 64 bits (siguiente imagen), en caso de que así sea, deberá hacer lo siguiente: 12 / 30

13 Posicionarse en el último Grupo de aplicaciones del servidor, llamado DefaultAppPool, dar un clic derecho y seleccionar de la lista Configuración avanzada, aparecerá una ventana y en la primera opción Habilitar aplicaciones de 32 bits seleccionar el valor True; las siguientes imágenes muestran ésta parte del procedimiento. Presionar el botón de Aceptar. 13 / 30

14 Servicio Web Clientes Dentro de la carpeta de Sitios, como se comentó anteriormente, existe una aplicación llamada Default Web Site y dentro de ésta, las aplicaciones de los Servicios Web de COMPUCAJA.net. Seleccione la primera aplicación de la lista llamada: WSClientes, y en la siguiente sección llamada Administración, el ícono Editor de configuración (doble clic sobre ésta opción). La siguiente imagen muestra éste proceso. Al habilitar el Editor de configuración, posiciónese en el primer renglón (Colección) y al final del mismo, se habilitará un botón de Examinar, mismo que deberá activar con un clic. En la siguiente imagen se encuentra seleccionado con la flecha. 14 / 30

15 En la siguiente pantalla, dentro del listado de Elementos, en la parte superior, ubique el cursor en el renglón ConexiónServidor y se habilitarán dos renglones en la sección Propiedades en la parte inferior. En el renglón value se encuentra la información relacionada con los datos de conexión como IP del equipo, nombre de la Base de datos, usuario y contraseña, donde deberá actualizar los datos del equipo en el que se esté operando (datos locales siempre). Initial catalog se refiere al nombre de la Base de Datos local con la que se operará para dichos servicios. Nota importante: se sugiere al usuario defina las Bases de Datos con distintos nombres (Ejemplo: nombre de la Sucursal, BDServidorCentral, etc.), a manera de identificación y no genere confusiones. Al finalizar, cierre la ventana y verá como el renglón (Count = 13) aparece en negritas, eso significa que no han sido guardados los cambios; en la sección de Conexiones, seleccione otra aplicación de WS o carpeta dentro de Sitios para que el sistema le envíe la ventana con la interrogación si desea guardar los cambios; presione el botón Sí. 15 / 30

16 Al momento de instalar el Servicio Web, en la ruta: C:\inetpub\wwwroot\WSClientes, se crea un archivo con extensión.asmx con el nombre del servicio, en el caso de Clientes, su nombre es: Alta_clientes_y_TiVi.asmx 16 / 30

17 Para confirmar que los Servicios Web de Clientes estén instalados y configurados de manera correcta, deberá validarlos con cualquier navegador de Internet, con el siguiente enlace llamado URL (Localizador Uniforme de Recursos), que es una dirección que permite acceder a un archivo o recurso como páginas html, php, etc. La URL está compuesta por: la IP del equipo, el nombre de la carpeta del Servicio Web que instaló COMPUCAJA, y el nombre del archivo.asmx que se encuentra dentro de esa carpeta. Ejemplo: Configuración en Servidor Central: Para finalizar el proceso, en el archivo de Configuración de COMPUCAJA, tanto en la opción de Administrador como en Punto de Venta, deberá insertar la URL de manera local en el equipo que hará la función de Servidor Central. 17 / 30

18 Configuración en Sucursales: En cada una de las Estaciones, copiar ese mismo URL del Servidor para replicar y que las estaciones de las tiendas o sucursales puedan consultar los Servicios Web de Clientes, direccionados a esa IP. Presione el botón de Configurar, seleccione al pestaña Servicios Web, y deberá insertar la URL en la primera sección llamada Alta de Clientes como se muestra en la imagen siguiente. Presione el botón de Aceptar y los Servicios Web de Clientes quedarán listos para operar. 18 / 30

19 Servicio Web Consulta de Existencia Cliente Siga los pasos de las páginas 14 17, pero ahora la Aplicación con el nombre WSConsultaExistenciaC. La finalidad de este Servicio Web es consultar las existencias de las mercancías en las Sucursales, por eso la C, de Cliente en el nombre de la Aplicación. Es importante recordar que los datos del Editor de configuración, en la ventana de IIS, se capturan la información correspondiente a la Base de Datos local, y cada uno de los equipos (Servidor Central y Sucursales). Valide la URL en cualquier navegador de internet. Ejemplo: 19 / 30

20 Configuración en Servidor Central: En la ruta: Administrador Establecimiento Establecimientos, en la pestaña Parámetros, sección Consulta de Inventario, deberá insertar la URL local, así como el Almacén que se consultará y que corresponde a esa Estación. La siguiente imagen muestra la ruta mencionada. 20 / 30

21 Configuración en Sucursales: Habilite el archivo de Configuración de COMPUCAJA, y tanto para Administrador como para el Punto de Venta, en cada una de los Establecimientos que están configurados como Tiendas o Sucursales, deberá insertar la URL del Servidor Central, en la pestaña Servicios Web en la sección llamada Consulta de Existencias. 21 / 30

22 En la ruta: Administrador Establecimiento Establecimientos, en la pestaña Parámetros, sección Consulta de Inventario, deberá insertar la URL local, así como el Almacén que se consultará y que corresponde a esa Estación, como se muestra en la siguiente imagen, con el ejemplo de una Sucursal llamada Colima. 22 / 30

23 Servicio Web Consulta de Existencia Servidor Siga los pasos de las páginas 14 17, pero ahora la Aplicación con el nombre WSConsultaExistenciaS. La finalidad de este Servicio Web es consultar las existencias de las mercancías en el Servidor Central, por eso la S, de Servidor en el nombre de la Aplicación. 23 / 30

24 Es importante recordar que los datos del Editor de configuración, en la ventana de IIS, se capturan la información correspondiente a la Base de Datos local, y cada uno de los equipos (Servidor Central y Sucursales). Valide la URL en cualquier navegador de internet. Ejemplo: 24 / 30

25 Configuración en Servidor Central: En la ruta: Administrador Establecimiento Establecimientos, en la pestaña Parámetros, sección Consulta de Inventario, deberá insertar la URL local, así como el Almacén que se consultará y que corresponde a esa Estación. La siguiente imagen muestra la ruta mencionada. Configuración en Sucursales: Habilite el archivo de Configuración de COMPUCAJA, y tanto para Administrador como para el Punto de Venta, en cada una de los Establecimientos que están configurados como Tiendas o Sucursales, deberá insertar la URL del Servidor Central, en la pestaña Servicios Web en la sección llamada Consulta de Existencias. 25 / 30

26 En la ruta: Administrador Establecimiento Establecimientos, en la pestaña Parámetros, sección Consulta de Inventario, deberá insertar la URL local, así como el Almacén que se consultará y que corresponde a esa Estación, como se muestra en la siguiente imagen, con el ejemplo de una Sucursal llamada Guanajuato. 26 / 30

27 Servicio Web Notas de Traspaso Siga los pasos de las páginas 14 17, pero ahora la Aplicación con el nombre WSNotasTraspaso. La finalidad de este Servicio Web es realizar notas de entrada por traspaso y notas de salida por traspaso entre Establecimientos. 27 / 30

28 Los datos del Editor de configuración, en la ventana de IIS, se capturan la información correspondiente a la Base de Datos local, y cada uno de los equipos (Servidor Central y Sucursales). Valide la URL en cualquier navegador de internet. Ejemplo: 28 / 30

29 Configuración en Servidor Central: En la ruta: Administrador Establecimiento Establecimientos, en la pestaña Parámetros, sección Traspasos entre establecimientos, deberá insertar la URL local, y dependiendo de las cuestiones contables fiscales de la Organización: habilitar o no el parámetro Traspasos sólo con el mismo Registro Tributario. La siguiente imagen muestra la ruta mencionada. Configuración en Sucursales: En la ruta: Administrador Establecimiento Establecimientos, en la pestaña Parámetros, sección Traspasos entre establecimientos, deberá insertar la URL local, y dependiendo de las cuestiones contables fiscales de la Organización: habilitar o no el parámetro Traspasos sólo con el mismo Registro Tributario, como se muestra en la siguiente imagen, con el ejemplo de una Sucursal llamada Aguascalientes. 29 / 30

30 30 / 30