Documentation for POS Intellect 5.4. Documentation for other versions of Intellect is available too.

Previous page Control package  Interaction with POS server Next page

Sample view of xml_titles.txt file is shown in the figure.

The numbers in square brackets represent the numbers of functions that come in the FunctionNumber field of the package. Directly below the number the template is specified in brackets — a description of how the specified function will be displayed on the video image. The variables in angle brackets "<>" will be replaced with the corresponding values. If there is at least one such parameter in the string, and there is the data incoming from the POS terminal with this parameter missing, then the entire string will be ignored and will not be displayed on the screen.

It's possible to specify single functions (e.g. [1] or [2]) and combination of several functions if they have the same template (e.g. [1,2,5,10]).

Configuring of file sections and fields is follows:

  1. Parameters of fields formatting are specified in the [PARAM_TEXT_FORMAT] section.

    In example the ItemName parameter is displayed. Its maximal length is 25 symbols (spaces will be added automatically if length is less), left alignment, all symbols are displayed in capitals.
    Available alignment values: left, right, center.
    Available values of letters size: upper, lower.
  2. Numbers of sections corresponding to new receipt entry are specified in the [PROLOG] section. Function, number of which is specified in this field, automatically increases (per one) internal counter of receipts (transactions). Parameters corresponding to these functions should be column names of the POS_LOG_MASTER table.
  3. Function numbers corresponding to receipt body are specified in the [BODY] section. Parameters corresponding to these functions should be column names of the POS_LOG_DETAIL table. 
  4. Function numbers corresponding to receipt end are specified in the [EPILOG] section. Parameters corresponding to these functions should be column names of the POS_LOG_MASTER table.
  5. Function numbers which should not display on the screen in text view. But data of these functions are saving to POS base – if they are specified in [PROLOG],[BODY],[EPILOG] sections (see. PROLOG,BODY,EPILOG ).
  6. Parameters and output string are specified in the [PROLOG_EVENT_PARAM] section. The specified string is displayed if this parameter is in the received xml-package. This section is applied for systems without concrete determination of receipt entry.
  7. Matches of sending parameters and column names of pos database tables depending on function number are specified in the [TRANSFORM] section.

    In the above example, the item_total column will match to the received ItemPrice parameter if function number is not 5 or 6. If function number is 5 – the item_amount column, if function number if 6 – item_price column.
    It's possible to send the following string:

    instead of the string:

    In this case, description in the [TRANSFORM] field is not required.
  8. Matches of receiving function numbers (FunctionNumber) and their names are specified in the [FUNCTIONNAME] section. It's using for matching function numbers and their names in reports forming in accordance of operator search requests.
  9. When parameter specified in the [IGNORE_ZERO] section equals zero, the corresponding POS event will be ignored. For example, package is received from the POS, and the following text is specified in the xml_titles.txt file, than section with the specified event won't be added to the POS_LOG_DETAIL table.

    Package with zero IDCAmount parameter

    Fragment of the xml_titles.txt file specifying on requirement to ignore the package
    A system defines the way of adding parameter values to the database basing on functions specified in PROLOG,BODY,EPILOG sections. Parameters are adding only when function numbers in which the specified parameters are sending are added to one of three section (PROLOG,BODY,EPILOG).

Values are loading to the database as follows:

  1. Record is adding to the [POS_LOG_MASTER] table using the INSERT SQL operation when receiving function specified in the [PROLOG] section. Program automatically increases a [check_id] counter and stores it.
  2. Record is adding to the [POS_LOG_DETAIL] table using the INSERT SQL operation where the stored value of the [check_id] table is specified in the [id] field, when receiving function specified in the [BODY] section.
  3. Record is updating in the [POS_LOG_MASTER] table using the UPDATE SQL operation for the string where the [check_id] value corresponds to the stored value, when receiving function specified in the [EPILOG] section.
    So the [check_id] field is using within the program and should not be in use as name of sending parameter.
    Sequence order of sections can be optional. Single-line comments can be written using // symbols.
    For example, the package is received when adding a good to receipt:

    and the following description is corresponding to this package:

    In this case the following captions will be displayed: 

Record containing values of item_name, item_count, item_total fields and the FunctionNumber value will be added to the POS_LOG_DETAIL table of the pos database.

  • No labels