Embed Size (px)
Citation preview
1 / 26
Manual de Usuario
NOVACAJA – Servicios WEB
2 / 26
Tabla de Contenido
Configuración Servicios Web 3
Instalación de componentes 3
Servicio Web Notas de Traspaso 13
Servicio Web Consulta de Existencia Cliente 19
Servicio Web Consulta de Existencia Servidor 23
3 / 26
Configuración Servicios Web
La mayoría de las características de NOVACAJA, 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
4 / 26
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.
5 / 26
Una vez que finalice, presione el botón Cerrar, y verifique que la carpeta wwwroot se encuentre insertada en la ruta: C:\inetpub
6 / 26
Uno de los prerrequisitos para el funcionamiento de los Servicios Web, es activar Framework 4.5 o superior, también con todas sus casillas, en la misma ruta de IIS. Presione el botón Aceptar.
A continuación, deberá instalar los Servicios Web de NOVACAJA, 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.
7 / 26
Presione el botón Siguiente.
Del listado que se muestra a continuación, es recomendable habilitar todas las opciones, ya que se crea por default cada una de esas carpetas en la ruta: C:\inetpub\wwwroot, y así insertadas: se cuenta con la ventaja de que ya están listas solo para su configuración. Presione el botón Siguiente.
8 / 26
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 Siguiente.
El proceso estará listo y tardará algunos minutos; presione el botón Install.
9 / 26
Una vez que se finalice la instalación, presione el botón Finalizar.
Confirme en la ruta: C:\inetpub\wwwroot, se hayan instalado satisfactoriamente las carpetas correspondientes a los Servicios Web de NOVACAJA
10 / 26
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 ratón en la opción.
11 / 26
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 NOVACAJA.
12 / 26
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:
Regresando a la pantalla de IIS, posicionarse en el último (o penú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 Aceptar.
13 / 26
Servicio Web Notas de Traspaso
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 NOVACAJA. Seleccione la aplicación de la lista llamada: WSNotasTraspaso, 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.
14 / 26
Al habilitar el Editor de configuración, posiciónese en el primer renglón (Colección) y al final del mismo, se habilitará el botón Examinar (…), mismo que deberá activar con un clic.
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.
15 / 26
16 / 26
Al finalizar, cierre la ventana y verá como el renglón (Count = 11) 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í.
Al momento de instalar el Servicio Web, en la ruta: C:\inetpub\wwwroot\WSNotasTraspaso, se crea un archivo con extensión .asmx con el nombre del servicio, para este caso, su nombre es: CCNotasESService.asmx
17 / 26
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ó NOVACAJA, y el nombre del archivo .asmx que se encuentra dentro de esa carpeta. Ejemplo: http://192.168.0.14/WSNotasTraspaso/CCNotasESService.asmx
18 / 26
Nota: 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.
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.
19 / 26
Servicio Web Consulta de Existencia Cliente
Siga los pasos de las páginas 13 – 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).
20 / 26
Valide la URL en cualquier navegador de internet.
Ejemplo:
http://192.168.0.14/WSConsultaExistenciaC/ConsultaExistenciaDisponibleCliente.asmx
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.
21 / 26
Configuración en Sucursales:
Habilite el archivo de Configuración de NOVACAJA, 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.
22 / 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 Colima.
23 / 26
Servicio Web Consulta de Existencia Servidor
Siga los pasos de las páginas 13 – 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.
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).
24 / 26
Valide la URL en cualquier navegador de internet.
Ejemplo:
http://192.168.0.14/WSConsultaExistenciaS/ConsultaExistenciaDisponibleServidor.asmx
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.
25 / 26
Configuración en Sucursales:
Habilite el archivo de Configuración de NOVACAJA, 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.
26 / 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.
