Setup Parameter

Overview

The Setup Parameter menu displays all parameters used to configure various aspects of the system. This feature allows you to manage parameters such as Cost Type, Department, and other settings used throughout the application.

Page Navigation

The Setup Parameter page is located within the Project Setup menu.

Parameter List Display

The parameter list page shows a table with the following columns:

• Name - Parameter name
• Category - Parameter category (Employee, Attendance, System)
• Data Type - Parameter data type (String, Number, Boolean, Date, JSON)
• Default Value - Default parameter value (if any)
• Description - Parameter description
• Status - Parameter status (Active/Inactive)
• Actions - Action buttons (Edit, Deactivate, Delete)

Parameter Data

Here is an example of registered parameter data:

Total Data: 1–3 of 3

Search Feature

A search column is available to easily find parameters by name.

How to use:

1. Click on the search column
2. Type the keyword you want to search for (based on parameter name)
3. Search results will appear automatically

Data Filters

Several filter options are available to narrow down the data display.

Category Filter

Category Options:

• All Categories
• Employee
• Attendance
• System

Data Type Filter

Data Type Options:

• All Types
• String
• Number
• Boolean
• Date
• JSON

Status Filter

Status Options:

• All Status
• Active
• Inactive

Adding a New Parameter

To add a new parameter, click the New Parameter button or the plus (+) icon. You will be directed to the parameter form page.

New Parameter Form

The parameter form page displays a form for entering new parameter data.

Form Components:

Data Type Details

Free Text:

• Text input without restrictions
• Suitable for parameters with free text values

String:

• Text with specific length
• Can be validated with min/max length

Number:

• Numeric value
• Can be validated with min/max value

Boolean:

• True/false value
• Suitable for yes/no parameters

Date:

• Date value
• Format: DD/MM/YYYY

JSON:

• Structured data in JSON format
• For complex parameters

How to Fill the Form:

1. Parameter Name
   • Enter a unique parameter name
   • Example: Cost Type, Department, HRD
2. Data Type
   • Select the appropriate data type
   • Example: select for Cost Type, string for Department
3. Default Value (Optional)
   • Enter a default value if needed
   • Example: - for no default
4. Description (Optional)
   • Enter a description to explain the parameter's function
   • Example: Cost type for employees
5. Validation Rules (Optional)
   • Enter validation rules
   • Example: min:1, max:255 for minimum text length of 1 and maximum of 255 characters
6. Active
   • Check if the parameter is active
   • Active parameters will be available for use
7. Required
   • Check if the parameter is required
   • Required parameters must have a value when used
8. Click Save to save the parameter
9. Click Cancel to cancel

Parameter Actions

On each parameter row, action buttons are available to manage the data.

Edit

To edit parameter data:

1. Click the Edit icon on the parameter row you want to edit
2. The edit form will open with pre-filled data
3. Modify the necessary information
4. Click Save to save the changes
5. Click Cancel to cancel

Deactivate

To deactivate a parameter:

1. Click the Deactivate icon on the parameter row you want to deactivate
2. Confirm the deactivation in the dialog that appears
3. The parameter status will change to Inactive
4. Inactive parameters will not appear in selection options

Delete

To delete a parameter:

1. Click the Delete icon on the parameter row you want to delete
2. Confirm the deletion in the dialog that appears
3. The parameter data will be permanently deleted

Parameter Status

Parameters have two statuses:

How to change status:

• Active → Inactive: Use the Deactivate action
• Inactive → Active: Edit the parameter and check the Active checkbox

Additional Information

At the bottom of the page, information about data count and display settings is available:

• Rows per page: 10
• Total data: 1–3 of 3
• This setting controls how many parameters are displayed per page

Usage Tips

1. Use descriptive names - Give parameters clear and understandable names.
2. Group with categories - Use appropriate categories (Employee, Attendance, System) to facilitate searching.
3. Utilize descriptions - Add descriptions to explain the function and usage of parameters.
4. Use appropriate validation - Apply validation rules according to the data type to ensure valid data entry.
5. Deactivate, don't delete - If a parameter is no longer used, it's better to deactivate it rather than delete it to maintain historical data integrity.
6. Watch for dependencies - Before changing or deleting a parameter, ensure no other features depend on it.

Example Parameter Usage

Troubleshooting

Cannot add a new parameter

• Ensure Parameter Name is filled
• Check if the parameter name is already in use
• Ensure Data Type is selected

Parameter not appearing in search

• Refresh the browser page
• Ensure search keywords are correct
• Try using category filters to narrow the search

Failed to save form

• Check the validation rules format
• Ensure there are no problematic special characters
• Try with a different parameter name

Cannot delete a parameter

• Ensure the parameter is not used by other data
• Deactivate the parameter first
• Contact an administrator if still having issues

Parameter not appearing in selection options

• Check the parameter status (must be Active)
• Ensure the category matches where the parameter is used
• Refresh the application page

Next Steps

• List Project
• Work Location
• Work Schedule
• Calendar
• Employee Management