Product

The Product screen is used to define a product and view or modify information on an existing product.

The screen can be displayed in Add mode, Edit mode, or Details mode. In Details mode, the information displayed on the screen is read-only and cannot be updated.

Add Product screen

Edit Product screen

Product screen

Screen Access

To add a product:

Display the Products screen > Click the Add button.

To edit a product:

Display the Products screen > Select a product in the Products data grid > Click the Edit button.

To view the details of a product:

Display the Products screen >, Select a product in the Products data grid >Click the Details button.

Interface Initialization

Upon initial display of the screen, the following occurs:

In Add mode:

The title bar text is set to "Add Product".

The Product ID text box is disabled and blank.

The Commodity drop-down list box is enabled and blank.

The Product Name text box is enabled and blank.

The Unit of Measure drop-down list box is enabled and blank.

The UPC text box is enabled and blank.

The OK button is visible and enabled as the default.

The Cancel button is visible and enabled as the default.

In Edit mode:

The title bar text is set to "Edit Product".

The Product ID text box is disabled and displays the system-generated ID number for the current product.

All other data controls are visible, enabled, and display the previously-saved values.

The OK button is visible and enabled as the default.

The Cancel button is visible and enabled as the default.

In Details mode:

The title bar text is set to "Product".
All data controls are disabled, read-only, and display the previously saved values.

The Close button is visible and enabled as the default.

Screen Elements

Unless otherwise stated below, all controls on the Product screen are visible and enabled when:

The screen is displayed in Add mode.

The screen is displayed in Edit mode.

Unless otherwise stated below, all controls on the Product screen are visible and disabled when:

The screen is displayed in Details mode.

If one or more special conditions exist that affect a control on the Product screen, the condition(s) are documented for that specific control below.

Product ID Code text box

Enter the unique product ID generated by the system in the Product ID Code text box.

The control is enabled when:

The control is always disabled.

Information in this control is read-only and cannot be changed. The value label displays in the inverse color of the screen.

Commodity drop-down list box

Select the commodity of the product in the Commodity drop-down list box.

It will be filled with all the commodities in the COMMODITY table sorted in ascending order.

Product Name text box

Enter the name of the product in the Product Name text box.

It defaults to blank. The text box allows the entry of alphabetic, numeric, and special characters. Special characters are limited to the following: pound (#), ampersand (&), hyphen (-), comma (,), period (.), forward slash (/), and apostrophe (').

Unit of Measure drop-down list box

Select the unit by which the product is measured in the Unit of Measure drop-down list box.

It will be filled with all the units of measure in the UNITOFMEASURE table sorted in ascending order.

NOTE: Rebate is per individual item not per multiples pack, such as a four-pack. The maximum price per food item is per individual item. The system needs an individual item to calculate the rebate. Multiple packs will not be supported at this time.

UPC text box

Enter the product's universal product code in the UPC text box.

The control will only accept entry of numeric digits and dashes.

OK button

Click the OK button to process the screen.

It is the default button for the screen, unless otherwise noted.

The control is visible and enabled when:

The screen is displayed in Add mode.

The screen is displayed in Edit mode.

It does not have a mnemonic. Its keyboard shortcut is the Enter key.

The Products screen displays when the button is clicked.

Cancel button

Click the Cancel button to close the screen without processing or saving data.

The control is visible and enabled when:

The screen is displayed in Add mode.

The screen is displayed in Edit mode.

It does not have a mnemonic. Its keyboard shortcut is the Esc (escape) key.

The Products screen displays when the button is clicked.

Close button

Click the Close button to close the screen.

The control is visible and enabled when:

The screen is displayed in Details mode.

It does not have a mnemonic. Its keyboard shortcut is the Esc (escape) key.

The Products screen displays when the button is clicked.

Processing

If data can be validated and saved on the screen, the following processes occur when the screen is processed:

A process to check for required controls as identified in the Data Map below is performed.
A process to check for valid entries as identified individually for each applicable control in Screen Elements above is performed.
A process to check for edits and cross edits as identified for each applicable control in Screen Elements above is performed.
If any checks or processes fail, a standard error message displays.

If no data can be validated and saved on the screen:

No cross edits are performed.
All values are considered legitimate.
No data is written to the database.

Data Map

The Data Map defines the values saved for all controls on the screen. If available, any additional notes or comments are displayed in the Notes column.

Control Label	Required	Table	Column	Notes
Product ID	·	·	·	·
Commodity	X	·	·	·
Product Name	X	·	·	·
Unit of Measure	X	·	·	·
UPC	·	·	·	·

Software Version: 2.40.00