1. General information

New ASP-based web-reports technology is simple and functional. We recommend to use Google Chrome or another Blink web-browser engine based browser.

This system works ONLY with RK 7.5.2.Х and up versions. To RK6 see this manual  http://support.ucs.ru/en/node/7262

You must install Microsoft .NET Framework 3.5 and up ftp://ftpint.ucs.ru/r-keeper/WebMonitor_v4/Inst/dotnetfx35.exe to use web-reports technology!

 

2. Install

1. Get ftp://ftpint.ucs.ru/r-keeper/WebMonitor_v4/ lastest distributive from our FTP server.

2. Edit   ...\WebMonitor\site\WebMonitor\Web.config file:

a. "Platform" - is RK7;

b. "DemoMode" - is False;

c. "Language" - tag of your language - Default in our case (more detalies - see http://support.ucs.ru/en/node/7160#header-3).

3. Add Web-Monitor licence in Manager staion:

 

4. Add XML interface (XML interface for windows) to Cash-server. Add Port(1) and CryptKey(2). In Service - Interfaces create new Xml interface and choose yours XML interface for windows.

5. Reboot all Cash-servers with new XML interface.

6. Edit cash server(s) xml-interface(s) IP-address(es) and port(s) in ..\WebMonitor\site\WebMonitor\App_Data\servers.xml

<?xml version="1.0" encoding="utf-8" ?> 
<servers>
  <server name="Server 1" address="127.0.0.1:5585" cryptKey="17771"/>
  <server name="Server 2" address="192.168.59.123:2233" cryptKey="17772"/>
  <server name="Server 3" address="198.163.59.123:2237" cryptKey="17773"/>
</servers>

7. All users and passwords are writing in ..\WebMonitor\site\WebMonitor\App_Data\monclnts.xml

By default this is 3 build-in users in Web Monitoring system:

ID = 1 Psw = 1 (user with cash reports rights)
ID = 2 Psw = 2 (user with cash reports rights)
ID = 100 Psw = 100 (user with cash reports and OLAP-reports rights ONLY RK6!!!)
<?xml version="1.0" standalone="yes"?>
<USERS>
            <USER UN="100" PWD="100" CODE="4184" SHIFR="17">
            <REPIDs>
      <!--
      1 - Balance
      2 - Orders amounts
      3 - Waiters amounts
      4 - Sales Report
      5 - Product mix
      6 - Common
      7 - By cashiers
      8 - By waiters
      9 - By stations
      10 - By groups stations
      11 - Service-Print
      12 - Orders
      13 - Receipt
      14 - Cash date
      15 - Period of the day
      16 - System balance report
      17 - Send message
      18 - Hall plans -->
      <REPID ID="1"/>
      <REPID ID="2"/>
      <REPID ID="3"/>
      <REPID ID="4"/>
      <REPID ID="5"/>
      <REPID ID="6"/>
      <REPID ID="7"/>
      <REPID ID="8"/>
      <REPID ID="9"/>
      <REPID ID="10"/>
      <REPID ID="11"/>
      <REPID ID="12"/>
      <REPID ID="13"/>
      <REPID ID="14"/>
      <REPID ID="15"/>
      <REPID ID="16"/>
      <REPID ID="17"/>
      <REPID ID="18"/>     
                </REPIDs>
            </USER>
            <USER UN="2" PWD="2" />
            <USER UN="3" PWD="3" />
 <USER UN="4" PWD="4">
                        <REPIDs>
      <REPID ID="6"/>
      <REPID ID="7"/>
                        </REPIDs>
            </USER>
</USERS>

So in this example:

 <USER UN="4" PWD="4">       - user login and pass
                        <REPIDs>
      <REPID ID="6"/>        - 6 is Common group 
      <REPID ID="7"/>        - 7 is "By cashiers" report
                        </REPIDs>

In this example user with "200" account can access only "By cashiers" report because in Common group (REPID ID="6") we setup only this report.

WARNING!!! If it is no </REPIDs> section in user accounts section like  <USER UN="2" PWD="2" /> - user can access ALL reports!!!

  <USER UN="2" PWD="2"/>

  <USER UN="3" PWD="3"/>

Setup as application

 

8. Start web-server - start.bat. To stop - type "Return". Don`t close it! (How to install it like windows-service - look in 8.1)

Setup as service

8.1 To setup web-server as service:

a. Set Mono.WebServer.XSP.exe.config file parameters:

<?xml version="1.0"?>
<configuration>
<appSettings>
<!-- xsp server parameters (as a command line). See readme for details -->
add key="ServerParameters" value="--address 0.0.0.0 --port 8082 --root D:/ --applications /:./Ucs/rk7/WebMonitor/site/WebMonitor"/>
<!-- Paths for asp.net assemblies for all managed sites. Paths are separated by a semicolons. This folders must be writable. -->
</appSettings>
<startup><supportedRuntime version="v2.0.50727"/></startup></configuration>

b. Run cmd.exe and enter:

<InstallUtil path>\InstallUtil.exe <xsp server path>\Mono.WebServer.XSP.exe

You can also create a shortcut and add "Mono.WebServer.XSP.exe" text to "target" field.

 

c. Enter login and password to this window. Attention! User name and login of your PC! Format: "Name of PC"\"Username" (to see it - use "hostname" command in cmd.exe)

 

d. Run XSP Server service.

 

To delete this service: stop it and enter in cmd.exe:

<InstallUtil path>\InstallUtil.exe <xsp server path>\Mono.WebServer.XSP.exe -U

Or add "Mono.WebServer.XSP.exe -U" to shortcut.

Setup as IIS-service

 

8.2 Its also avilable to use IIS-based (Internet Information Services) web-server. About IIS-sevises using you can read this http://technet.microsoft.com/en-us/library/hh831475.aspx and this http://technet.microsoft.com/en-us/library/cc732854.aspx

To use IIS web site you should install .NetFramework 4 and register Asp.Net in IIS. To register Asp.Net use this commands:

cd C:\Windows\Microsoft.NET\Framework\v4.0.30319

aspnet_regiis.exe –i

a. Add Internet Information Services to your system.

b. Add Web-Monitoring folder to IIS

c. Setup Web Site Properties

 

9. To open Web-reports type IP-address and port (by default port is 8083).

10. Choose server you need and log with login and password from monclnts.xml:

12. All logs are avilable in:

..\WebMonitor\site\WebMonitor\WebMonitor.log

..\WebMonitor\site\WebMonitor\XmlInterface.log
 

3.Translation

 

To translate web-reports interface just add your language tag ("ROM"etc.) to ..\WebMonitor\site\WebMonitor\App_Data\language.xml, copy default and translate this strings to your language.