Available Roles

Contents Show

The Available Roles screen is used to assign roles while adding or editing a user. It can be used to add a new role, edit an existing role, or view the details of an existing role.

Available Roles screen

Screen Access

Screen Access

Interface Initialization

Upon initial display of the screen, the following occurs:

  • The title bar text is set to "Available Roles for {Location}", where {Location} is the location of the staff assignment.

  • Informational Text is visible on the screen. The informational text displayed is read-only and cannot be changed.

  • The Role(s) list box is enabled and displays all roles that are not already associated to the current staffing assignment location. The first item in the list box is initially selected.

  • The Details button is visible and disabled.

  • The Add button is visible and enabled.

  • The Edit button is visible and disabled.

  • The OK button is visible and enabled as the default.

  • The Cancel button is visible and enabled as the default.

  • If the user's permission (feature/access level) indicates that they can only view the information, the screen disables all controls except the OK and Cancel buttons.

Screen Elements

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

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

Informational Text value label

  View the informational text on the screen in the Informational Text value label. Informational text provides information about the current process being performed on the screen.

The informational text is displayed as follows:

"Select one or more items in the list. When you are finished selecting press the OK button."

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

Role(s) list box

  View items in the Role(s) list box.

Select one or more roles to assign for the new staffing assignment in this list box. The list box contains all roles that are not currently assigned for the staff member at the location currently selected in the Location drop-down list box on the Staffing Assignment screen. The list box is populated from the Description Column of the ROLE table, and sorted alphabetically by name. Multiple selections are allowed.

Details button

  Click the Details button to view the details of the record currently selected in the data grid.

The control is enabled when:

It has a mnemonic of "T".

The Role Profile screen displays in Details mode when the button is clicked.

Add button

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

It has a mnemonic of "A".

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

Upon returning to this screen after completion of the required controls and clicking the OK button on the Role Profile screen, the Role(s) list box is refreshed.

Adding the selected role(s) updates the specified staffing assignment and subsequently dismisses the screen.

Edit button

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

The control is enabled when:

It has a mnemonic of "E".

The Role Profile screen displays in Edit mode when the button is clicked.

Upon returning to this screen after completion of the required controls and clicking the OK button on the Role Profile screen, the Role(s) list box is refreshed.

OK button

  Click the OK button to process the screen.

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

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

The Staffing Assignment screen displays when the button is clicked.

Cancel button

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

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

The Staffing Assignment 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:

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

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

~+Role(s)

list box

Role.RoleName

ยท

~ 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.

|

Management Console