Receipt Archiving

The following program description deals with:


Remarks on the Program Function

The MICROS Retail OSCAR POS application allows you to store the booking data/ receipt data as files. The files are stored in the ASCII format, by which they can also be controlled outside of MICROS Retail OSCAR POS.

In a second step, the files can be backed up/ recorded on CD by use of the function Receipt Backup -> CD. Please note that the operating system UNIX does not support a CD recording/backup function . Therefore, the descriptions of this subject are all related to WINDOWS NT only.

Note:

Go to Application -> Sales -> Receipt Archiving. The screen mask is divided into four parts:

  1. Selection Criteria
    By making entries in the selection fields and activating/deactivating status options in the screen section "Selection Criteria", you can define which data is to be displayed in the list window. Via the Search button(magnifying glass) you can display the files.
    The selection criteria apply to the list of already created files only and not to possible functions to be carried out (Create Receipt Log., Receipt Log on CD etc.). When you carry out functions and click on the button, selection windows will be displayed in which you make the selections necessary for the functions.
  2. List Window
    The created files are displayed here. You can select a particular file for processing by a mouse click.
  3. Functions to be carried out
    You are offered four functions to process the receipt logs.
  4. Statuses of the Files /Data Records
    Every created file has a status which is displayed when you select the file in the list window.

Remarks on the Input Fields

This paragraph will provide a short overview over the options available for updating these Basic Data.

Just like in almost any other program:


Selection Criteria

The selection criteria take a direct influence on the functions and/or the files you would like to view.

The MICROS Retail OSCAR POS application allows you to limit the files to be created. You can make this pre-selection by

Company [Selection Criterion]

Permitted input range: numeric, 1 - 9999

Enter the number of the company to the area of which the files to be backed up belong. If you do not know the number, you can also select the data record via the Search Function.

Branch [Selection Criterion]

Permitted input range: numeric, 1 - 9999

Enter the number of the branch to which the data to be backed up belong. If you do not know the number, you can also select the data record via the Search Function.

From Profit Center [Selection Criterion]

Permitted input range: numeric, 1 - 9999

You can restrict the data to be backed up to particular profit centers. If you wish to do so, enter the smallest number of the profit center to be considered.

To Profit Center [Selection Criterion]

Permitted input range: numeric, 1 - 9999

You can restrict the data to be backed up to particular profit centers. If you wish to do so, enter the highest number of the profit center to be considered.

From Terminal [Selection Criterion]

Permitted input range: numeric, 1 - 999999

You can restrict the data to be backed up to particular terminals. If you wish to do so, enter the smallest number of the terminal to be considered.

To Terminal [Selection Criterion]

Permitted input range: numeric, 1 - 999999

You can restrict the data to be backed up to particular terminals. If you wish to do so, enter the highest number of the terminal to be considered.

From Date [Selection Criterion]

Permitted input range: DDMMYYYY (day, month, year)

If you would like to view the data of a particular date only, enter the earliest date to be considered.

To Date [Selection Criterion]

Permitted input range: DDMMYYYY (day, month, year)

If you would like to view the data of a particular date only, enter the latest date to be considered.

Amended [Selection Criterion]

Activated: If the option is activated, the files with the status Amended are displayed (cp. the following note).
Deactivated: This option is not a selection criterion.

As already described in the program introduction, the files are stored in the ASCII format, i.e. they can be viewed and also manipulated via text programs or editors. Every modification of an ASCII file has the effect that the option "Amended" is activated.

Note on the functioning of the options:

Deleted [Selection Criterion]

Activated: The status Deleted is considered with the file selection.

By activating this option, you can restrict the files to be displayed to those that have been deleted either automatically (function: Receipt Log -> CD, button "Automatic Deletion") or manually (function: Receipt Log deleted) after the transfer to CD.

Note on the functioning of the options:

You can view receipt logs of deleted files if you have a backup on CD. Activate the option "Deleted" and click on the Search button (magnifying glass). Select the file to be viewed in the list window. Click on the button "View Receipt Log". In a window, the Name of the CD on which the data have been backed up will be displayed. Insert the CD in the CD-ROM drive and confirm via OK. The booking data of this file will appear on the screen.

Not found [Selection Criterion]

Activated: The status Not found will be considered with the file selection.

Activate this option when you search for files that have been deleted manually from the directory "TransAsc".

Note on the functioning of the options:

Overruled [Selection Criterion]

Activated: Files for which the status "Selected" has been deactivated manually will be considered with the selection.
Deactivated: This option is not a selection criterion.

When a file is created, it automatically receives the status "Selected", i.e. it is ready to be transferred to CD. If you do not want this, you can deactivate the option "Selected". This will automatically activate the option "Overruled".

Note on the functioning of the options:

Transferred [Selection Criterion]

Activated: Files with the status Transferred will be considered with the selection.
Deactivated: This option is not a selection criterion.

Files that have been successfully backed up on CD receive the status "Transferred".

Note on the functioning of the options:


List Window

In this window, the created files are listed.

Company [in List Window]

Number of the company for which the file has been created.

Branch [in List Window]

Number of the branch for which the file has been created.

Terminal [in List Window]

Number of the terminal at which the booking transactions have been carried out.

Date [in List Window]

Day on which the booking transaction has been carried out.

Checksum [in List Window]

When the files are transferred to CD, checksums are generated by use of which the transfer is checked for errors. The checksum is calculated systematically and serves information purposes only.

CD Description [in List Window]

The name you have entered in the course of carrying out the function Receipt Log -> CD. If you have not entered any name, the MICROS Retail OSCAR POS application uses the transfer date as the file name.


Functions to be carried out

You are offered four functions to process the receipt logs.

Note:

Receipt Log -> Create [Button]

Apart from the backup of the "Receipt Log on CD", this is the most important function in the area of receipt archiving because the creation of the files with the receipt logs is required for the carrying-out of all other functions. Every created file receives the status Selected.

Note:

After you have clicked on the button, a selection window appears in which you can limit the data records to be created in files. You can e.g. define the company and the branch as well as the numbers of the terminals and the dates to be considered.

After you have started the function, the data records are displayed in a window. (They will only appear in the list window after you have clicked on the search button.)

One file will be created per company, branch, terminal and day. The file name is composed as follows:

The file will be stored in the directory work\TransAsc\. The directory is created automatically during the MICROS Retail OSCAR POS installation. If a different position or a different name is used, this can be changed in the file RecLogDef.fgl. The creation location can be changed in the file RecLogDef.fgl as well.

Receipt Log -> View [Button]

By use of this function, you can view the receipt log data in the created files. Select the file to be checked in the list window. Carrying out this function requires that the file has been created by use of the function "Create Receipt Log".

After you have clicked on the button, the file content is displayed. All transactions of a  terminal are listed in chronological order. The receipt archiving is therefore similar to the journal print. When you search for particular texts/ character sequences, you can enter them by use of the Search button and move quickly to the related passage in the receipt archiving. The archived data cannot be edited.

This function can also be carried out with files that have already been backed up on CD. Even files with the status "Deleted" can be viewed, as long as they are on the CD. A description can be found in the chapter Deleted.

Receipt Log -> CD [Button]

Attention!

By use of this function, the files with the booking data are backed up on CD. Accordingly, a CD recorder has to be connected. Please note that the files have to be created via the function "Create Receipt Log" before being backed-up on CD.

After you have clicked on the button, a selection window appears in which you can select the files to be backed-up by company, branch, profit center, terminal and date. If you make entries, only the booking data within the defined number range will be considered.

Two buttons/ options have to be described in more detail:

  1. "Total Size of Files"
    By a click on this button, the required memory space is determined. Please note that only those files will be considered that
    a) have been selected in the selection window and
    b) for which the status "Transferred" has been activated.
    Please note that there is no automatic update of this criterion.
  2. "Delete automatic"
    If you activate this option, the files will be deleted automatically after the successful file backup. If errors are detected after the recording process, the faulty files will not receive the status "Transferred", i.e. they will not be deleted.

As soon as you have started the transfer, the program checks if the memory space on the CD is sufficient.

  1. If there is not enough space on the CD, a message appears:
    "Too many data for the CD – select less"
    The window will then be closed, you will return to MICROS Retail OSCAR POS.
  2. If the application finds out that there is enough space on the CD, you will be asked to enter a name for the CD. If you do not enter a name, the date will be used.

Afterwards, the program "WinOnCD" by use of which the transfer is carried out is started.

Notes on WinOnCD:

After the writing process, the program "WinOnCD" is closed. The application automatically returns to MICROS Retail OSCAR POS.

In the next step, the transfer is checked for errors. For this purpose, the application makes the attempt to read the backed-up files from CD by use of a checksum and by checking the file length. If errors are detected, the file name is included in a list displayed on the screen and recorded in a file "RecLogError" in the directory work. For this(these) file(s), the function has to be carried out again. Files transferred with errors are not deleted despite the possibly activated option "Delete automatic".

For files that have been transferred correctly, the status "transferred" is activated. At the same time, these files receive the checksum, the file length and the CD name as entries in the list window.

Receipt Log -> Delete [Button]

There are two MICROS Retail OSCAR POS functions to delete created files:

As already described in "Receipt Log -> CD", you can decide prior to the file transfer to have the files deleted automatically after the transfer. All files that have been transferred correctly will then be deleted.

The second possible way to delete files is to delete the files via the button "Delete Receipt Log". The requirement is the same: The files to be deleted have to have the status "Transferred". The files can only receive this status after the transfer to CD has been carried out successfully.

After you have clicked on the button, a window informs you that all selected files, i.e. those listed in the list window, are deleted. Answer the question "Are you sure" by clicking on OK. The deleted files receive the status "Deleted".

You can view the content of deleted files. A description can be found in the chapter Deleted.

If files are deleted on the operating system level, they receive the status Not found.


Statuses of the Data Records

Every data record (= every file) receives a status that is indicated by the activated option. The status is displayed when you select the data record in the list window.

Amended [Status]

Activated: The file has been modified.
Deactivated: The file has not been modified, yet.

As already described in the program introduction, the files are stored in the ASCII format, i.e. they can be viewed and also modified by use of text editors. Every modification of an ASCII file has the effect that the option "Amended" is activated. At the same time, the option Selected is deactivated. The activated option "Amended" cannot be deactivated. "Amended" files can be backed up on CD.


Deleted [Status]

Activated: The file has been deleted.
Deactivated: The file has not been deleted.

Files that have been deleted after the transfer to CD, either by use of the function "Delete automatic" (Receipt Log -> CD) or the function Delete Receipt Log, receive the status "Deleted".

The option is not activated if the file has been deleted

You can view receipt logs of deleted files as long as they are on CD. Activate the option Deleted and click on the Search button (magnifying glass). Select the file to be viewed in the list window. Click on the button "View Receipt Log". In a window, the name of the CD on which the files are backed-up is displayed. Insert the CD in the CD-ROM drive and confirm via OK. The booking data of this file appears on the screen.


Transferred [Status]

Activated: The file has been modified.
Deactivated: The file has not been modified, yet.

As already described in the program introduction, the fields are stored in the ASCII format, i.e. they can be viewed and also modified by use of text program editors. Every modification of an ASCII file has the effect that the option Amended is activated.


Not found [Status]

Activated: The file has not been found.
Deactivated: The file has been found.

If you have deleted an ASCII file in the directory "TransAsc" manually (physically), it receives the status "Not found".

Note:


Selected [Status]

Activated: The file has been created and is currently selected in the list window.
Deactivated: The file is not selected.

As soon as a file has been created but neither backed-up on CD nor modified, it receives the status "Selected". This status is a pre-condition for the file transfer to CD. The option is automatically deactivated when a file has been manipulated and receives the status Amended.

You can also deactivate this option manually, e.g. to prevent the file from being backed up on CD. At the same time, the option Overruled is activated.


Index


MICROS Retail Deutschland GmbH
Salzufer 8
D-10587 Berlin
Germany