Exception Messages
The Exception Messages button opens a screen to view the default exception messages and to add, edit, and/or delete custom messages when an exception is generated.
Exception messages are generated when a user needs to take further action in order to continue with the action they were attempting. The message gives more information on what is required of the user. For example, an exception message is generated when a user tries to log into the system without entering the correct user name and password. The default message is "User does not exist in the system". If another message is entered in the User Defined Message field, that message is displayed instead. The message can be updated to read, "User name or password is incorrect. Please re-enter the information".
The following fields are available when adding or viewing a record: |
Classification
Indicates the classification category of this exception record, such as Standard, Customer, User Defined or Replicated.
Code
A short, alphanumeric code used to identify this exception message.
Executable
Match an exception by which executable or assembly the exception occurred within.
Location
The page name where within the executable the exception occurred, such as EmployeeCalandarEdit or OrganizationUnitSearch.
System Message
The standard message supplied by Time and Attendance and Staffing and Scheduling, if it exists, which can be overridden by the User Defined Message.
Note
Hover the cursor over this field to view the tooltip with the complete message.
Type
Type of exception, such as NullReferenceException, ArgumentOutOfRangeException, or SerializationException.
User Defined Message
The message that should be displayed when the exception occurs, which can also include information on how to handle the exception. This message is displayed instead of the standard System Message.
Note
Hover the cursor over this field to view the tooltip with the complete message.
Action Buttons
The following Action buttons may be available in the left pane, depending on the page that is open:
Click on the Add button to open a screen to configure a new record.
Complete the following steps to add a new record:
-
Click on the Add button in the left pane. The corresponding New Record screen is displayed.
-
Enter data in applicable fields. The fields with an asterisk are required and must be completed before the record can be saved.
-
Fields that require specific values display Field Look Up Values in the right pane. If there is no right pane, the List Selector icon is displayed to the right of a field to open a listing of valid values.
-
Fields that require specific standard response values (for example, Yes/No) display a Drop-Down Menu arrow to open a list of valid options.
-
Fields that require date values display a calendar in the Field Look Up Values in the right pane. If there is no right pane, the Date Selector icon is displayed to open a calendar to select a date. Date values can also be typed in.
-
-
If there are Indicator and/or Parameter tabs, these must be configured as well. Default values are displayed for all indicator settings (and selected parameter settings), but may be changed for this record. For more information on indicator and parameter settings, see
and . See also the Rules and Parameters Specification documentation. -
Depending on the screen being set up, there may also be additional Section buttons in the left pane. Click on the buttons to open and configure those additional screens.
-
When all screens have been completed, click on the Save button to save the new record values.
Note
For more information and screen prints, see Adding a New Record.
The Advanced button loads the expanded search criteria mode with additional fields for locating a record. When the Basic search mode is loaded, the button shows as Advanced. When the Advanced search mode is loaded, the button shows as Basic.
Note
The user can set whether the Basic or Advanced search mode is automatically loaded for each screen. This setting is found under
. The Advanced/Basic buttons only display on screens with Advanced search capabilities.The Audits button in the left pane opens a screen to view changes to records in the open page. The audit trail displays information on additions, edits and deletions, including the date and time the change was made, the type of change (inserted, updated, deleted), the description of the change, the name of the person making the change, and the original and new values.
The audit records can be grouped and sorted by one of the following options: application, audit date, audit description, classification, or who modified. To change the sort, click the drop down arrow near the Group By field in the Audit List Actions to open the record, then select the grouping from the list.
Group by Application
Groups the audit records by the application where the changes were made.
Group by Audit Date
Groups all the audits by the date when changes were made.
Group by Audit Description
Groups the audit report by the description of the edits that were made.
Group by Classification
Groups the audit records by whether the record was inserted, updated, or deleted.
Group by Who Modified
Groups the audit records by the user who made the updates.
The Delete or Delete Selected button is used to remove one or more records from a screen.
Complete the following steps:
-
If there are multiple records, click on the selection box to the left of each record that is to be deleted.
Note
If this is a single record, there are no check boxes to select. Skip to step 3.
A check mark is displayed in each selected box.
-
Click on the Delete Selected button for multiple records or the Delete button for a single record.
-
The system does a validation check to make sure the record is not linked to any other records. If it is, a warning message is generated and the record cannot be deleted.
-
If there are no children records, the record is deleted.
Note
For more information, see Deleting a Record.
The Replace button opens a screen to update one or more field values for all the records selected in the search. This feature can be used to update multiple records with the same field information.
-
Using the Search page, search for all the records to be updated. Multiple searches can be conducted to build a results list.
-
Select the box to the left of each record to be updated.
-
Click on the Replace button in the left pane.
A screen is displayed with all the fields as read only.
-
Select the box to the left of each field to be updated. The field is then enabled.
-
Enter the new information in the field.
-
Complete all tabs to be updated, including the Indicators and Parameters tabs, if applicable.
-
To reset all the values back to the previously saved values, click on the Reset button in the left pane.
Note
Once the records have been saved, the values cannot be set back to the previous value using the Reset button. They can be changed by using the Replace feature.
-
Click on the Save button to save the changes.
-
All selected records are now updated, with the new information replacing the old information in the selected fields.
Note
The system does not allow the user to use this feature to replace "key" identification fields. A Duplicate Key error message is generated. For example, because the "key" identification field for a Holiday record is the Code, the system does not allow a user to replace multiple holiday records with the same Code. The Code for each Holiday record must be unique.
Note
For more information and screen prints, see the section in Record Management under Replacing Record Values.
For certain types of screens, existing records cannot be edited. However, an existing record can be Replicated, which means a User Defined duplicate record with all the attributes of the original is created. This replicated copy can be edited and assigned.
An example of this can be found on
. An existing LaborView record can be copied and modified.To replicate an existing record, complete the following steps:
-
Using the Search criteria for the related screen, search for and open the record to be replicated.
-
Click the Replicate button in the left pane. A copy of the original assignment code is created, with all the settings of the original.
-
Enter a new Code to differentiate the replicated record from the original.
-
The Description and other fields can be updated.
-
Update any of the indicators, parameters, and/or other settings on any of the screens of the replicated record.
-
Click on the Save button to save the changes to the new record.