Location List

Contents ShowHide

The Location List screen is used to manage locations. Locations added to the Location List data grid can have inventory items consigned to them.

Location List screen

Screen Access

Display the Participant Folder screen > On the Activities menu, point to Manage Inventory, and then select Location List.

Interface Initialization

Upon initial display of the screen, the following occurs:

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

The Add button is visible and enabled.

The Close button is visible and enabled as the default.

If records are listed in the data grid:

The Location List data grid will contain all locations defined to the system (INVENTORYLOCATION table).

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

The Edit button is visible and enabled.

The Delete button is visible and enabled.

If records are not listed in the data grid:

The Edit button is visible and disabled.

The Delete button is visible and disabled.

Screen Elements

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

The screen is active.

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

Location List data grid

View the information in the Location List data grid.

Click a location record in this data grid to perform additional functions. This data grid displays all available locations.

An entry will be added to the data grid for each location in the INVENTORYLOCATION table. The entries in the data grid will be displayed in ascending order by the name column. The values on the data grid are read-only. The user may select a single entry in the data grid.

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

Name column

This column displays the name for each record displayed within the data grid.

The title of the column is set to "Name". The information displayed within the column is read-only. The column header and the data within the column are left aligned.

Add button

Click the Add button to add a record to the data grid.

It has a mnemonic of "A".

The Location screen displays in Add mode when the button is clicked.

Upon returning to the screen, the system refreshes the data grid accordingly.

Edit button

Click the Edit button to edit the record currently selected in the data grid.

The control is enabled when:

A record is selected in the data grid.

It has a mnemonic of "E".

The Location screen will be displayed in Edit mode when the location is not a clinic. It will be displayed in Details mode when the location is a clinic.

Delete button

Click the Delete button to delete the record currently selected in the data grid.

The control is enabled when:

A record is selected in the data grid.

It has a mnemonic of "D".

When the button is clicked, a standard confirmation message (C0004) displays. The options of Yes and No are available. When Yes is clicked, the system deletes the record from the database. The contents on the Location List screen are refreshed. When No is clicked, the system returns to the Location List screen (the current screen) without deleting the selected record.

If the selected record is associated with at least one other record in the system or is in use, the system displays a standard error message (E0007). Click the OK button to return to the Location List screen (the current screen).

The following permissions are checked: InventoryManagement.FullControl.

If the user clicks Yes, the system will perform the edit to make sure no products are associated with the location. Upon successful completion of the edit, the system will delete the selected location from the system and return the user to the Location List screen. The data grid will be refreshed.

If the user clicks No, the system will dismiss the standard confirmation message without deleting and return the user to the Location List screen.

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 Participant Folder 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
·	·	·	·	·
·	·	·	·	·
·	·	·	·	·
·	·	·	·	·
·	·	·	·	·

Software Version: 2.40.00