Food List

Contents ShowHide

The Food List screen is used to display a list of food distribution items on a benefit. The list includes each food distribution item issued to the participant, the number of items currently issued, the number of items currently redeemed, and the number of items currently remaining.

Food List screen

Screen Access

Display the Benefit Details screen for a participant > Click the Display Food List button.

Interface Initialization

Upon initial display of the screen, the following occurs:

The title bar text is set to "Food List".

The Food Items data grid will contain an entry for each food item that printed on the food instrument.

The first row in the data grid is initially selected as the default.

The Close button is visible and enabled as the default.

Screen Elements

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

The screen is active.

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

Food Items group box and data grid

View the information in the Food Items data grid.

The title text of the group box is set to "Food Items".

This data grid contains an entry for each food distribution item that is included on the selected benefit for the participant. The data in the data grid is read-only.

The data grid consists of the following control(s):

Description column

This column displays the description of each food distribution item displayed within the data grid. Each food distribution item displayed is included on the benefit.

The title of the column is set to "Description". The information displayed within the column is read-only.

The value is populated from the Description column of the FoodDistributionItem database table.

The column header and data are left aligned.

Issued column

This column displays the number of units of the food distribution item initially issued to the participant for each record displayed within the data grid.

The title of the column is set to "Issued". The information displayed within the column is read-only.

The column header and data are left aligned.

The column header and data are right aligned.

Redeemed column

This column displays the number of units of the food distribution item redeemed by the participant for each record displayed within the data grid.

The title of the column is set to "Redeemed". The information displayed within the column is read-only.

The column header and data are left aligned.

The value is calculated by summing the value in the RedeemedQuantity column of the FoodInstrumentItemRedeemed database table for each redemption.

The column header and data are right aligned.

Remaining column

This column displays the number of units of the food distribution item remaining for each record displayed within the data grid.

The title of the column is set to "Remaining". The information displayed within the column is read-only.

The value is calculated by subtracting the Redeemed value from the Issued value (i.e., the number of remaining food distribution items is equal to FoodInstrumentItem.ItemQuantity minus the sum of all FoodInstrumentItemRedeemed.RedeemedQuantity values recorded for the item).

The column header and data are right aligned.

When a food distribution item's Remaining value is equal to zero, the background color of the row is red and the foreground color is white to give a visual indication that no more of the item remains to be redeemed.

Close button

Click the Close button to close the screen.

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

The Benefit Details 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	Control Type	Table. Column	Notes
Food Items	data grid	·	·
Description	data grid column	FoodDistributionItem. Description	·
Issued	data grid column	FoodDistributionItem. ItemQuantity	·
Redeemed	data grid column	FoodInstrumentItemRedeemed. RedeemedQuantity	·
Remaining	data grid column	FoodDistributionItem. ItemQuantity minus (-) FoodInstrumentItemRedeemed. RedeemedQuantity	The number of remaining food distribution items is equal to FoodInstrumentItem. ItemQuantity minus the sum of all FoodInstrumentItemRedeemed. RedeemedQuantity values recorded for the item.

~ Denotes a required control (if applicable). The process that checks for required controls does not occur on screens displayed in read-only or Details mode.

+ Denotes data written to the database when screen processing occurs (if applicable). The process that writes data to the database does not occur on screens displayed in read-only or Details mode.

Software Version: 2.40.00