The Form Settings tab on the Form Profile form is used to enable and disable certain form-level and global settings in the application. For example, you can change the default number of Rows per page that display on a form. You can also specify whether to allow direct entry of hours on the timecard. The settings will apply to users who have been assigned the selected Form Profile.
To open this form, select a Form Profile Name from the Form Profile form.
To display the GLOBAL_LEVEL settings, click the name of the Form Profile and then click the Form Settings tab.
To display FORM_LEVEL settings, click the name of the form and then click the Form Settings tab.
See Also:
List of Form Settings and Setting Values
Form Settings Field Descriptions
Controls whether Arrival and Departure events will appear in the Daily timecard.
Change the Setting Value to 1 if you want to show the Arrival and Departure events in the Daily timecard.
Change the Setting Value to 0 if you want to hide the Arrival and Departure events in the Daily timecard.
Applicable Forms
You can modify this setting for the Daily tabs in the supervisor and employee timecards:
Daily tab of the Self Service Time Card (time_card_detail_employee_ext)
Daily tab of the Current Situation and Time Card Review forms (time_card_detail_supervisor_ext)
When you modify this setting in one supervisor timecard tab, the same setting change will be made to the other supervisor timecard tab. For example, if you modify this setting in the Daily tab of Current Situation, the same setting change will be made for the Daily tab of Time Card Review.
Applicable Forms: Charge Element, Order
Indicates whether Data Access Rights will be enabled for the form.
You can use a person’s Facility Data Access Rights to control which charge elements and orders they are able to view and modify in the Charge Element and Order forms. Data Access Rights (also called “DAR”) refers to the data that a user can access in the application. This access is controlled by a Security Data Role, which is defined in the Security Data form.
To restrict which charge elements and orders a person can view in the form, you must:
Enable Data Access Rights for the form (set dar_enabled to “1”).
Include the FACILITY item in the person’s Security Data Role.
Define which charge items are valid for a given facility in the charge_element_group table.
See Restrict Access to Charge Elements or Restrict Access to Orders for more information.
By default, dar_enabled is set to “0” (disabled). To enable this setting, set it to “1”.
Indicates whether a user can add or modify hours by typing them directly into the grid of the timecard.
The default value is 1 (direct entry is allowed).
Enter 0 to prevent users from entering hours directly in the timecard.
If direct entry is not allowed, the user will have to use the Add Elapsed or Add Punch options to enter transactions in the timecard. To modify a transaction, the user will have to right-click the hour amount and choose Modify from the pop-up menu.
Note: Direct entry cannot be used to add or modify hours for employees whose Time Entry Type is PUNCHED.
Applicable Forms:
You can enable or disable direct_entry for the following tabs in the supervisor and employee timecards:
Daily tab of the Self Service Time Card (time_card_detail)
Weekly tab of the Self Service Time Card (time_card_summary_weekly)
Period tab of the Self Service Time Card (time_card_summary)
Daily tab of the Current Situation and Time Card Review forms (time_card_detail_supervisor)
Weekly tab of the Current Situation and Time Card Review forms (time_card_summary_weekly_supervisor)
Period tab of the Current Situation and Time Card Review forms (time_card_summary_supervisor)
Applicable Forms: Global setting for all forms with a Filter button
For forms that have a Filter button , this setting indicates whether the filter area will be visible when the form opens.
Enter 0 if you do not want the filter area to be visible when the form opens. Users will have to click the Filter button to display the filter area.
Enter 1 if you want the filter area to be visible when the form opens.
If Save View State is enabled for the Form Profile, it will take precedence over the expand_filter_panel setting. The filter area will be automatically expanded or hidden based on the last-viewed state of the form.
Applicable Forms: KPI Dashboard, Terminal Monitor
If the Auto Refresh button is enabled on the form, the form will automatically refresh the screen after the number of seconds specified in this setting.
You can set the form_refresh_time at the FORM_LEVEL for individual forms with an Auto Refresh button (KPI Dashboard and Terminal Monitor). You can also set the form_refresh_time at the GLOBAL_LEVEL to apply to all forms with an Auto Refresh button. The FORM_LEVEL setting will override the GLOBAL_LEVEL setting.
The default value is 180 seconds. You can change this value to the number of seconds you want between screen refreshes.
Number of seconds that info messages will display in the Mobile Client or Mobile Web Application before closing automatically.
Info messages are used to let the user know when additional information is needed during an event posting. In the image below, the info message appears when you click Save while posting an event and there are additional prompts to fill in.
The info_message_timeout is the number of seconds after which this message pop-up will close automatically. You can always close the message by clicking the OK button.
If you set the info_message_timeout to zero (0), then info messages will not display.
You must enter a value of 0 or greater for this setting. The default value is 1 (second).
Applicable Forms
This setting is available for the Event Prompts form in the Mobile Client and Mobile Web Application (mobile_event_posting_ext). You can change this setting in the following forms:
Favorites – Event Prompts
My Time Card – Daily View – Event Prompts
Recently Used – Event Prompts
Time Card Review – Summary View – Daily View – Event Prompts
If you change the info_message_timeout setting in one of these forms, the same setting will be used in the other forms.
Applicable Forms: Global setting for all quick link forms
The maximum number of records that will appear in a quick link form.
Defines the maximum number of characters that can display in the following forms:
In Transaction Data tab of the Interface In Queue form
View Error Log button in the Interface In Queue form (Transaction Data field of the Error Log pop-up form)
View Error Log button in the In XML Queue Detail tab of the In XML Queue form (Transaction Data field of the Error Log pop-up form)
View Error Log button in the Out XML Queue form
Transaction Data tab of the Error Log form
Error View button in the Service Monitor form (Transaction Data tab of the Error View pop-up)
The default value is 1000000 (1 million) characters, which is approximately 1MB of data.
If you attempt to display a record that has more characters than this setting, an error will appear. The form will only display the number of characters specified in the setting.
In the Interface In Queue form, you can download the entire record regardless of how many characters appear in the In Transaction Data tab. See Download Data button for more information.
This setting determines the maximum number of events that will appear in the Recently Used menu of the Mobile Client and the Mobile Web Application.
Applicable Forms
Mobile Client, Recently Used menu
Mobile Web Application, Recently Used menu
Defines the maximum number of records that will appear in the forms listed below. Can be set individually for each form.
If the number of records exceeds this amount, no records will appear in the form, and a message will appear that you need to refine your search criteria.
The number_of_records setting can also be defined at the GLOBAL_LEVEL (see below) for other forms.
The FORM_LEVEL setting will override the GLOBAL_LEVEL setting for number_of_records.
Note: Currently this setting only affects forms that have an info button in the top right corner. If a form does not have an info button, you can use the rows_per_page setting to control the number of records you can view on each page of a form.
Applicable Forms
Error View pop-up from Service Monitor
In XML Queue
In XML Queue Dtl
Interface In Queue
Labor Review
Lock by Person (tab in the Payroll Lock form)
Person Lock Details (Details button in Lock by Pay Policy tab/Payroll Lock form)
Service Audit pop-up from Service Monitor
Transaction Status
Defines the maximum number of records that will appear in a form. If the number of records exceeds this amount, no records will appear in the form, and a message will appear that you need to refine your search criteria.
Note: Currently this setting only affects forms that have an info button in the top right corner. If a form does not have an info button, you can use the rows_per_page setting to control the number of records you can view on each page of a form.
The number_of_records setting can also be defined at the FORM_LEVEL (see above). The FORM_LEVEL setting will override the GLOBAL_LEVEL setting for number_of_records in these forms.
Note that the maximum number of records that will appear in the Supervisor Review (Current Situation, Time Card Review) forms and the Broadcast Message form is determined by the max_supervisor_records Application Setting.
Applicable Forms
Applies to all forms that have an info button in the top right corner.
number_of_records_schedule_edit
Maximum number of records that can be selected and modified using the Edit Schedule button in the Current Situation form. The default value is 100.
Applicable Forms
Applicable Forms: Attendance Reward
This setting determines the maximum number of persons whose records can appear in the Attendance Reward form.
This setting limits the number of persons whose records will appear in the Attendance Reward form, but it does not control the number of records that appear in the form. Each person can have multiple records for a given date range. All the records for each person will appear in the form.
This setting adds a print button to a kiosk event on a client terminal. Kiosk events are view-only events such as Accruals View, Messages View, Open Jobs View, and Time Card View. See Print Kiosk Events from Client Terminals for more information.
To show the Print button, set this value to 1.
To hide the Print button, set this value to 0.
Applicable Forms
To modify this setting, go to Terminal Forms on the left side of the Form Profile form and select one of the events. Then click the Form Settings tab.
You can use the return_to_favorite_menu Form Setting to control how the Back button works after you select an event favorite to post in the Mobile Client or Mobile Web Application.
If return_to_favorite_menu is set to 1 (enabled), you will return to the Favorites form.
If return_to_favorite_menu is set to 0 (disabled), you will return to the Daily View of My Time Card.
Applicable Forms
Mobile Client, Favorites form
Mobile Web Application, Favorites form
This setting determines whether you will return to the Recently Used form or the Daily View of the My Time Card form when you select Back, Cancel, or Save after selecting a Recently Used event in the Mobile Client or Mobile Web Application.
When the Setting Value is 1 (enabled), you will return to the Recently Used form when you select Back, Cancel, or Save after selecting a Recently Used event in the Mobile Client or Mobile Web Application.
When the Setting Value is 0 (disabled), you will return to the Daily View of the My Time Card form when you select Back, Cancel, or Save after selecting a Recently Used event in the Mobile Client or Mobile Web Application.
Applicable Forms
Mobile Client, Recently Used menu
Mobile Web Application, Recently Used menu
Applicable Forms: Global setting for all forms that can display multiple pages of records.
Determines the default number of records you can view on each page of a form.
The default value is 20. You can change this value to a number between 1 and 50.
If Save View State is enabled for the Form Profile, it will take precedence over the rows_per_page setting. The number of rows per page that appear on the form will depend on the last-viewed state of the form.
Note: Currently this setting only affects forms that have pages of records. These forms do not have an info button in the top right corner. If a form does not have an info button, you can use the number_of_records setting to control the number of records you can view in the form.
Controls whether the end times of Meals and Breaks will appear in the Schedule Edit form. This form is used to modify a person's schedule from the timecard using the Edit Schedule button in the Current Situation form.
You need to modify this setting in the Form Profile that is assigned to the supervisor who is editing the employee schedules in Current Situation.
The default value for this setting is 0 (disabled), indicating that meals and breaks will only show the start time (Meal Start, Break Start) in the Schedule Edit form. You can view the end time of the meal/break in the Person Schedule form.
If only the Meal/Break Start is visible, and you modify the Meal/Break Start, the end time of the meal or break will adjust so the meal/break has the same duration. For example, a Meal is from 12 PM to 1 PM and only the Meal Start field is visible. If you change the Meal Start to 12:30 PM, the end time of the meal will change to 1:30 PM.
If you also want to show and edit the end times of meals and breaks in the Schedule Edit form, you need to change the show_event_end_timestamp setting to 1.
If both the start and end times of the meals and breaks are showing, and you want to remove the Meal or Break from the schedule, you need to delete the date from both the start and end fields.
Applicable Forms
Schedule Edit form - available from the Edit Schedule button in the Current Situation form
Indicates whether the Grand Total row will appear in the Period or Weekly Timecard in the Client Terminal and Web Time Clock. The Grand Total row appears at the bottom of the timecard and shows the total for each duration column (total hours, classified hours, auxiliary durations, etc.).
Set this value to 1 to show the Grand Total row.
Set this value to 0 to hide the Grand Total row.
To modify this setting, go to Terminal Forms > Weekly Timecard and Terminal Forms > Period Timecard on the left side of the Form Profile form. Then click the Form Settings tab.
Applicable Forms
Period Timecard in Client Terminal (time_card_period_view)
Weekly Timecard in Client Terminal (time_card_weekly_view)
Number of seconds that the message indicating an event posted successfully will appear in the Mobile Client or Mobile Web Application before closing automatically.
The success_message_timeout is the number of seconds after which this message pop-up will close automatically. You can always close the message by clicking the OK button.
You must enter a value of 0.1 or greater for this setting. The default value is 1 (second).
Applicable Forms
This setting is available for the Event Prompts form in the Mobile Client and Mobile Web Application (mobile_event_posting_ext). You can change this setting in the following forms:
Favorites – Event Prompts
My Time Card – Daily View – Event Prompts
Recently Used – Event Prompts
Time Card Review – Summary View – Daily View – Event Prompts
If you change the success_message_timeout setting in one of these forms, the same setting will be used in the other forms.
Indicates whether hour classifications will appear along with the hour amounts in the Weekly and Period tabs of the timecard.
Enter 0 to display the hour classifications.
Enter 1 to hide the hour classifications.
summary_hide_class = 0 (default setting)
summary_hide_class = 1
Applicable Forms
You can modify this setting for the following tabs in the supervisor and employee timecards:
Weekly tab of the Self Service Time Card (time_card_summary_weekly)
Period tab of the Self Service Time Card (time_card_summary)
Weekly tab of the Current Situation and Time Card Review forms (time_card_summary_weekly_supervisor)
Period tab of the Current Situation and Time Card Review forms (time_card_summary_supervisor)
When you modify this setting for one of the supervisor timecard tabs, the same setting change will be made to both supervisor timecard tabs. For example, if you change this setting in the Period tab of Current Situation, the same setting change will be made for the Period tab of Time Card Review.
Indicates whether the Eligible Time and Ineligible Time rows will appear in the Weekly and Period tabs of the timecard. These rows show the number of hours that are eligible or ineligible for EWT and Comp Time.
Enter 0 to display the Eligible Time and Ineligible Time rows.
Enter 1 to hide the Eligible Time and Ineligible Time rows.
Applicable Forms
You can modify this setting for the Weekly and Period tabs in the supervisor and employee timecards:
Weekly tab of the Self Service Time Card (time_card_summary_weekly_employee_ext)
Period tab of the Self Service Time Card (time_card_summary_employee_ext)
Weekly tab of the Current Situation, Time Card Review, and Authorized Hours forms (time_card_summary_weekly_supervisor_ext)
Period tab of the Current Situation, Time Card Review, and Authorized Hours forms (time_card_summary_supervisor_ext)
When you modify this setting for one of the supervisor timecard tabs, the same setting change will be made to both supervisor timecard tabs. For example, if you change this setting in the Period tab of Current Situation, the same setting change will be made for the Period tab of Time Card Review.
Indicates whether Auxiliary Duration 1, Auxiliary Duration 2, etc. rows will appear in the Weekly and Period tabs of the timecard.
Auxiliary Hours allow employees to earn more hours than they actually work. For example, a second-shift employee may work 6.5 hours and be paid for 8 hours.
When Auxiliary Hours are calculated, they are stored in a particular Auxiliary Duration column in the trans_action_duration table (Auxiliary 1 Duration, Auxiliary 2 Duration, Auxiliary 3 Duration, Auxiliary 4 Duration, or Auxiliary 5 Duration). The Auxiliary Duration column is determined by the rule that is used to calculate the Auxiliary Hours.
Each summary_show_auxiliary setting corresponds to an Auxiliary Duration column. For example, the summary_show_auxiliary1 setting will show or hide the Auxiliary Duration 1 row in the timecard.
Set this value to 1 to show the Auxiliary Duration column.
Set this value to 0 to hide the Auxiliary Duration column.
Applicable Forms
You can modify this setting for the Weekly and Period tabs in the supervisor and employee timecards:
Weekly tab of the Self Service Time Card (time_card_summary_weekly_employee_ext)
Period tab of the Self Service Time Card (time_card_summary_employee_ext)
Weekly tab of the Current Situation, Time Card Review, and Authorized Hours forms (time_card_summary_weekly_supervisor_ext)
Period tab of the Current Situation, Time Card Review, and Authorized Hours forms (time_card_summary_supervisor_ext)
When you modify this setting for one of the supervisor timecard tabs, the same setting change will be made to both supervisor timecard tabs. For example, if you change this setting in the Period tab of Current Situation, the same setting change will be made for the Period tab of Time Card Review.
summary_show_mid_period_split_day
This setting controls how split days in 9-80 schedules will appear in the timecard of the web application, Mobile Client, or Mobile Web Application.
Set summary_show_mid_period_split_day to 1 to enable it.
Set summary_show_mid_period_split_day to 0 to disable it.
In the web application, this setting controls how a mid-period split day in a 9-80 schedule will display in the Period tab of the timecard. When you enable this setting, a mid-period split day will display in two columns in the Period tab of the timecard – one column for the First Half and one column for the Second Half. This option makes it easier to enter hours directly in the grid of the timecard for a particular half of a split day.
In the example below, a two-week pay period starts on Saturday, has a split Friday (12/15), and ends on the following Friday. When summary_show_mid_period_split_day is enabled (set to 1), the split Friday displays in two columns (First Half and Second Half).
This option makes it easier to enter hours directly in the grid of the web timecard for a particular half of a split day.
If summary_show_mid_period_split_day is disabled (set to 0), the split day will display in a single column.
This setting does not affect the Weekly or Daily tab views of the web timecard.
Mobile Client / Mobile Web Application
In the Mobile Client and the Mobile Web Application, this setting controls how a mid-period split day in a 9-80 schedule will display in the Summary View of the Time Card Review or My Time Card forms.
When summary_show_mid_period_split_day is enabled (set to 1), the First and Second Half of the split day will appear as separate rows.
If summary_show_mid_period_split_day is disabled (set to 0), the split day will display as a single row.
Applicable Forms
In the web application, you can modify this setting for the following tabs in the supervisor and employee timecards:
Period tab of the Self Service Time Card (time_card_summary)
Period tab of the Current Situation and Time Card Review forms (time_card_summary_supervisor)
If you change this setting in the Period tab of Current Situation, the same setting change will be made for the Period tab of Time Card Review. Likewise, if you change this setting for Time Card Review, the same setting change will be made for Current Situation.
In the Mobile Client/Mobile Web Application, you can modify this setting for the following forms:
Summary View of My Time Card (mobile_time_card_summary_employee)
Summary view of Time Card Review (mobile_time_card_summary_supervisor)
Indicates whether the hours of multiple transactions should summarize into a single cell in the Weekly and Period tabs of the timecard.
Enter 0 if you do not want to display transaction summaries in the timecard:
Enter 1 if you do want to display transaction summaries in the timecard:
Applicable Forms
You can modify this setting for the following tabs in the supervisor and employee timecards:
Weekly tab of the Self Service Time Card (time_card_summary_weekly)
Period tab of the Self Service Time Card (time_card_summary)
Weekly tab of the Current Situation and Time Card Review forms (time_card_summary_weekly_supervisor)
Period tab of the Current Situation and Time Card Review forms (time_card_summary_supervisor)
When you modify this setting for one of the supervisor timecard tabs, the same setting change will be made to both supervisor timecard tabs. For example, if you change this setting in the Period tab of Current Situation, the same setting change will be made for the Period tab of Time Card Review.
This setting controls the size of the text fields and combo boxes (combination text field and drop-down) in the Event Prompts pop-up form that displays when adding or modifying an event in the timecard.
The default setting is 20. If your event prompt fields need to accommodate longer values (such as long project numbers), you can increase this setting to a value between 1 and 100.
text_field_size = 20
text_field_size = 40
Applicable Forms
Event Prompts pop-up form in Period, Weekly, and Daily tabs of timecard (Self Service and Supervisor Review)
When you modify this setting for one of the timecard tabs, the same setting change will be made to all the timecard tabs, both Self Service and Supervisor Review. For example, if you change this setting in the Period View tab of Current Situation, the same setting change will be made for all the tabs in the Self Service and Time Card Review tabs.
Form Profile Name
Name of the form profile for which these settings apply.
Form Profile Name
Name of the Form Profile for which this setting applies.
Form Name
Name of the form for which the setting applies. Will be blank for global settings.
Setting Category
Indicates whether the setting affects a specific form (FORM_LEVEL) or multiple forms (GLOBAL_LEVEL).
Setting Type, Description
Identifies the setting itself. See List of Form Settings and Setting Values for more information on the setting types and values.
Setting Value
Value for the setting type. See List of Form Settings and Setting Values for more information on the setting types and values.
Update Date, Updated By
These fields display when the record was created or updated, and the person who created or updated the record.
Note: You cannot modify the Form Settings for the DEFAULT Form Profile. You can only modify the Form Settings for a custom Form Profile.
Click Main Menu > Configuration > Form Configuration > Form Profile.
Click the Filter button to display the Form Profile Name field.
Select a custom Form Profile Name.
You can also click the button next to the Form Profile Name field and select Lookup from the pop-up menu. Select a record from the Form Profile pop-up form and click OK.
To display all the available settings for this Form Profile, go to the left side of the main form and click the top level folder (it displays the name of the Form Profile). Then click the Form Settings tab.
To display the settings for a specific form, select the form from the left side of the main form. Then click the Form Settings tab.
Select the setting you want to change and click Modify.
Change the Setting Value as necessary and click Save.