...
The system includes the following mandatory applications:
- Card Server server — CARDSERV — the main application of the system, manages the database, and provides interaction with PDS clients
- Card editor — PCARDS — an application for managing system references and obtaining basic reporting
...
| Code Block |
|---|
Backup = - the path to the directory for saving automatic backup of CARD.UDB database. If not specified, the backup files will be saved in the same directory as the working database Automatic backup is performed once a day, the execution time cannot be edited and is regulated by the server according to internal rules. BackupCount = 2 - the number of automatic backup files. After reaching the specified value, the files are automatically overwritten WeekStart = 7 - a parameter indicating the day of the beginning of the week. Used for cards with weekly limits, can take the following values: 1 - Mon 2 - Tue, 3 - Wed, ... 7 - Sun Bonus = - if you specify the DISCOUNT value, the number (identifier) of the card's bonus will be equal to the number (identifier) of its discount. SeeFind belowthe for details onof this parameter option.below MinRest = - if you specify an amount in this settingparameter, then the balance of money on the card will be considered zero if it is less than this amount. IgnoreStopDate = No - if = YES, then the expiration date is unlimited. Log = 2 - Log file level. 0 - rare events. 1 - query facts. 2 - details of some requests [LinkDLL] - link library support parameters section 1 = RNetBios - support for a communication channel through the NetBios protocol 2 = RNBOpen - support for a special communication channel via the NetBios protocol, used only for the R-Keeperr_keeper v6 POScash system 3 = RTcp - communication channel support via TCP/IP protocol |
...
| Info |
|---|
Communication modules are loaded and initialized in the same order as specified in the [LinkDLL] section |
...
| Info |
|---|
It is recommended |
...
to specify only the necessary link libraries |
...
in the [LinkDLL] section. After starting the server, it takes some time |
...
— about 5-20 seconds |
...
— to initialize all |
...
the communication modules |
Following are the individual parameter sections for each link library:
| Code Block |
|---|
[RNetBios] ; parameter section for NETBIOS communication module |
...
Server = PCSERV ; unique |
...
within the local network |
...
case-sensitive network NETBIOS name of the |
...
card server [RNBOpen] ; parameter section for RNBOPEN communication module |
...
Server = ASERV ; unique |
...
within the local network |
...
case-sensitive network NETBIOS name of the card server, used ONLY to connect |
...
the r_keeper v6 cash system [RTcp] ; parameter section for RTCP communication module |
...
Port = - TCP/IP port for incoming connections, any unique free/open network port for communication with the map server through it. Usually between 3000 and 5000. |
...
[RLocal] ; parameter section for RLOCAL communication module |
...
Port = 0 - port for local connections, you can specify |
...
any number |
...
Communication Modules Usage Features
- When connecting communication modules using the NetBios protocol
...
- — RNBOPEN.DLL and NETBIOS.DLL
...
- , keep in mind that the modules will be loaded on all numbers of NetBIOS adapters found in Windows OS
...
- . This leads to some delays when starting the
...
- card server. If the
...
- card server is configured to simultaneously support various communication modules, it is recommended to specify modules with NetBIOS support in the [LinkDLL] section at the end of the list
- When installing the
...
- card server on a 64-bit OS, communication modules with NetBIOS support will not work correctly
...
- . So, the NETBIOS module can be replaced with RTCP and/or RLOCAL modules
...
- . There is no replacement for the RNBOPEN module, but
...
- since the cash
...
- desk version 6.102, it is possible to configure an alternative connection via the TCP protocol /IP, using the RTCP communication module.
Thus, when installing the map card server on a 64-bit version of Windows, it is advisable recommended to use only two communication modules: RTCP ( for all remote connections, including the cash register desk and cash server) , and RLOCAL (for for all local connections)
Starting the map server
.
Card Server Launch
Running CARDSERV.EXE is possible can be launched both as an application and as a service (service).
No third-party components, including BDE, are required to run the map card server. Also, as well as no security key and/or license is required to run the map server.
The launch mode is determined by the key:
- /DESKTOP
...
- — to start the server as an application
- /INSTALL
...
- — to install the server as a service
...
- /UNINSTALL
...
- — to remove the installed server
...
- service
...
Several servers with different settings and databases can be running simultaneously on one computer.
After launch, an icon of a working map card server should appear in the system tray, by . By double-clicking on it you can open the server graphical interface of the server and check the status of the work:
- Database tab
...
- — general information
...
- Connects
...
- tab
...
- — list of connected clients
...
- Protocols
...
- tab — list of
...
- link libraries with parameters and status. If the server is running as an application, a
...
- Shutdown popup menu will be available
...
- on this tab
When installing the map card server in on Windows 7 (or later and higher) and running it as a service, the icon will not be displayed in the system tray.
...
Bonus=DISCOUNT Parameter
For a clearer understanding of the parameter, the description here is moved to a separate sectiona detailed description of this parameter.
In the PDS system for bonuses, there are no levels are not supported depending on the expenses of the cardholder, while . But such functionality is available for discounts ( compound discounts) - using . Using the Bonus=DISCOUNT parameter allows you to enable enabling the mechanism for supporting compound bonuses.
Scheme Sequence of workWork:in
- In the
...
- r_keeper 6 Editor module or in the
...
- r/-keeper 7 manager station, the bonuses necessary for the levels formation
...
- are created
...
- In the
...
- r_keeper 6 Editor module or in the r/-keeper 7 manager
...
- station, virtual or real
...
- — depending on the situation
...
- — discounts are created with codes
...
- corresponding exactly
...
- to bonus codes created in the previous step
...
- In the
...
- card editor, compound discounts are created according to the rules by which future compound bonuses should work
...
- . Specially created discounts
...
- should be used as discounts for each compound discount
...
- Compound discounts are assigned for
...
- cards in the
...
- card editor
Usage featuresFeatures:the
- The card server will always return both the discount code and the bonus code, which will be the same when using the Bonus=DISCOUNT parameter
...
- . Thus the flexibility of managing discounts is lost
...
- It is impossible to disable the use of discounts
...
- for the card
...
- — if the discount is not needed, you need to make it zero
Minimum
...
Server Configuration Example
In case of the minimum configuration (— when only support for the RTCP communication module ), is supported — CARDSERV.INI looks like this:
| Code Block |
|---|
[DB] |
...
File=card.udb |
...
DayBound = 4:00 |
...
backup= |
...
IgnoreStopDate = No |
...
BackupCount = 2 |
...
weekstart = 7 |
...
log = 2 |
...
[LinkDLL] |
...
1=RTcp |
...
[RTcp] |
...
port=3456 |
An example of the contents of the \CARDSERV directory contents after installation:
| Code Block |
|---|
CARDSERV.EXE - card server executable file |
...
CARDSERV.INI - map server configuration file |
...
CARD.UDB - card server database |
...
RTCP.DLL - communication module using TCP protocol |
Server configuration example Configuration Example for connecting Connecting on different Different TCP/IP portsPorts
In some cases, you may need to connect to the map card server on several different port numbers.
Because in the parameters of As far as it is possible to specify only one port value in the Rtcp.dll library , you can specify only one port value, we parameters, we use a " workaround " solution - we copy : copying the Rtcp.dll library in the required number under different names, for example Rtcp1.dll, Rtcp2.dll and configure accordingly. way configuring CARDSERV.IN accordingly:
| Code Block |
|---|
.... |
...
[LinkDLL] |
...
1=RTcp1 |
...
2=RTcp2 |
...
3=RTcp3 |
...
[RTcp1] |
...
Port = 1111 |
...
[RTcp2] |
...
port=2222 |
...
[RTcp3] |
...
port=3333 |
...
| Note |
|---|
The [LinkDLL] section must follow the sequential numbering of the link libraries |
Map editor
Appointment of the map editor
Card Editor
The card editor (, or PCARDS) , is the main user module in the PDS software and is designed to create and manage the database of cards (accounts). The module also provides basic reporting on the PDS system.
- Default login: ucs. If
...
- doesn't work, try 1
- Default password: ucs. If
...
- doesn't work, try 1
...
Card Editor Installation
The installation of the map card editor can be performed installed on the same PC where the map card server is located, or on any other PC within the connection with the map card server.
Novex Guardant II protection license key II hardware token is required to run the map card editor.
The previously downloaded archive contains a map the card editor. To run it, open the PCARDS.EXE applicationSetting up the map editor
Card Editor Settings
The map card editor configuration is stored in the file is RKEEPER.INI file.Note:
| Info |
|---|
Parameter values in the RKEEPER.INI file are case insensitive, except for parameters that specify NETBIOS names. |
Configuration file example:
| Code Block |
|---|
[Common] - main section |
...
Alias1 = d:\RK6\DB - path to |
...
reference tables of RK6 manager database |
...
Alias2 = d:\RK6\DB - path to the RK6 storage database (ARK6.UDB) |
...
EditFRF = YES - enable/disable the Fast |
...
Report print forms Language=.RUS - localization. The default language is RUS/ENG |
...
[PCards] - section of the |
...
card editor CSLinkDLL = RTcp - specifies the card editor's link |
...
library for communication with the card server. The library is specified without the extension
CSLinkGate = 1 - DLL client number. Add this number to the DLL parameters
DBF = ANSI - encoding in DBF files when exporting data from CARD.UDB. — ANSI or OEM
SaveLogin=YES - to save the username in the login window of the program
Login=ucs - default user
Birthday=0 - mode of building a report on birthdays. 0 — the specified year is taken into account. 1 — the specified year is not taken into account
ShowExport=1 - to show Export item in invoices — 1 or not — 0
Font = Antica - here you can specify the font to use
Guardant = $232D7F11 - here you can specify a key with a license, preceded by a $ sign. If there is - h at the end of the number, then this character usually is not specified |
| Info |
|---|
The token |
...
ID is determined by the diagnostic utility included in the Guardant driver |
...
, located in Control Panel |
...
> Guardant Drivers |
...
| Info |
|---|
...
In each section |
...
, several groups of parameters with different values can be defined for link libraries. The parameter group is defined by a number that is indicated after the parameter name and can take a value from 1 to 16. For example, Server1 is the 1st group, Server2 is the 2nd group, and so on. |
| Code Block |
|---|
[RTcp] ; section of settings of the selected communication module |
...
Client1 = Person_Cards ; any string that is unique among the server's TCP clients |
...
Server1 = 127.0.0.1 ; Server IP address - can be found by running ipconfig /all on the server from the command |
...
line Port1 = 3456 ; the port number specified on the CARDSERV server in CARDSERV.INI. |
An example of configuring the Map Editor card editor connection to the Map Server card server via NETBIOS:
| Code Block |
|---|
............ |
...
[PCards] |
...
CSLinkDLL = RNetbios ; used communication module |
...
CSLinkGate = 1 |
...
[RNetbios] |
...
Server1 = PCSERV ; NETBIOS name of the card server
Client1 = PCARDS_CLIENT ; The NETBIOS name of the client, must be unique in the network
Adapter1 = 0 ; if not specified, will take the first existing one. |
Cards Import from Text File
...
In the PCards application, it is possible to perform port of import the list of maps from cards from a text file (CSV) of the specified CSV format.
The import operation is available in the To perform the import, go to File > Accounts, right-click menu in the invoice display mode (File ⇒ Accounts):
Rice. The operation of importing maps from a text file
in a blank space and select Import cards...
The Text file requirements — CSV format compliance:Text File Requirements - CSV Compliance
- ANSI file encoding
...
...
- Every single line corresponds to one card
...
- Each line has multiple fields separated by commas
...
- If a comma is required in the content of the field, the field must be enclosed in double quotes
...
- , for example, "
...
- Baker street,
...
- 221b"
...
...
- If quotation marks are required in the contents of the field, then all these quotation marks must be doubled and the entire field must be enclosed in quotation marks. For example, the name of
...
- LLC "Romashka" should be indicated as "LLC" "Romashka"""
How the import procedure works:if
- If the server doesn't have any information on the card
...
- yet
...
- , a new account is created for it
...
- If there is already an account with such a card, its properties are changed
Description of the fields for each file entryline:1.
- Card number
...
- The validity period of the card is the date in the CURRENT WINDOWS FORMAT. If the OS is Russian, then the format should be: DD.MM.YYYY, for example: 08/12/2020.
...
- Discount number - a number from 0 to 99 (optional field)
...
- Bonus number - a number from 0 to 99 (optional field)
...
- Birthday - date in CURRENT WINDOWS FORMAT (optional field)
...
- Name of the cardholder - There should be no quotes!
...
- Card type (optional field, default 0):
- 0 - manual replenishment without limiting payments
- 1 - automatic replenishment without payment limits
- 2 - automatic replenishment with payment limit for one day
- 3 - automatic replenishment with payment limit for a week
- 4 - automatic replenishment with payment limit for a month
- 5 - manual top-up with payment limit for one day
- 6 - manual top-up with payment limit for a week
- 7 - manual top-up with payment limit per month
- 8. Payment limit amount (optional field)
- 9. Phone number one (optional field)
- 10. Phone number two (optional field)
- 11. E-mail (optional field)
- 12. Name of the subdivision. (optional field). This field is case sensitive and should not contain quotation marks. The division must exist.
- If the name is not specified or the specified division is not found, a new account is created in the current one, and if the account already exists, its division is not changed
- If the account already exists and is located in another division, it is transferred to the specified division, if it exists
- 13. Type of discount restriction (optional field, default 0):
- 0 - no restrictions
- 2 - discount limit for one day
- 3 - weekly discount limit
- 4 - monthly discount limit
- 14. Discount limit amount (optional field)
- 15. Name of the discount level. Used if field 3 (discount number) is empty (optional field)
- 16. Credit amount for cards with manual replenishment (optional field)
- 17. Flag "Withdraw card": 0-remove, 1-set, empty - do not change (optional field)
- 18. Address (optional field)
- 19. Date of issue of the card - date in the CURRENT WINDOWS FORMAT (optional field, from version 3.27.02)
An example of the contents of a text file for importing maps:
1023,31.12.2007,5,10,02.02.2002, Ivanov Ivan Ivanovich
1024.01.01.2008,2,1.05.11.1980, A.B.Sidorov,1
1027,12.03.2007,2,,,Aleksey Tolstoy,4,5000,222-22-22,,tolstoy@test.su,Test
August 2, 17, 2020, March 5, 1970, V.Ya. Biryukov,,,, biryukov@mail.ru, My division
...