Skip to main content

Employee

caution

This documentation is incomplete.

You can use the employee screen to enter and maintain your employees' personal information, addresses, jobs, roles, payroll, compensation, and work assignment details. The employee screen can be configured to various employee-related information. The default screen shows the below tabs.

  1. Header - basic employee information such as First Name, Last Name, Email, Phone, etc
  2. Education - education details of the employee
  3. Experience - experience details of the employee
info

Employee ids need to be assigned to users to access employee-related documents such as Leave Application, Payslip, etc.

Employee

To create/view/update an employee, navigate to the "employee " screen from your dashboard/favorite.

Enter the employee details or any other criteria in the search form and click on the search button to view an existing employee.

If you don't enter any search criteria, the system will show you all the employees. If your organization has configured to make any field mandatory for search, then you have to enter those fields to search employees.
The application will fetch all the server data and take you to the search result screen. The search result screen looks a bit different on desktop and mobile devices.

If you click on the create new button, the system will open a simple step form to create a new employee. You can click on the detail right bottom to view all the fields available for the object.

To view the search result in a table format, click on the table icon in the bottom left corner.

To view specific employee details, click on the menu of that record, and click on view/fetch & view.

You can also click on the expand icon against any item on the search result screen to view the employee header details, name, description, revision number, etc.

The system will fetch all the selected document detail line data. The document details are shown either right on the search result screen or on a separate screen, depending on the device size.

First Name: Enter the first name of the employee. First name is a mandatory field.

Last Name: Enter the last name of the employee. Last name is a mandatory field.

Person Type: Enter the employee type : 'employee', 'ex_employee', 'applicant', 'contract'.

Scroll left, right, up, and down to view all the details. The document line and details are shown in a separate tab. The default configuration shows fields in various functional groups, such as

  • Finance
  • Entity
  • Reference
  • Data
  • Control
  • Etc

You can configure the application to show which fields should be shown under which group. You can also create new groups as per your business requirements.

Employee Name: It's a read-only field. The system shows "firstName lastName" as the employee name.

Email: Enter the employee's email address. The address can be the same or different from the Email on the user. The system sends notifications using Email on the user object.

The reference groups show various ids for reference only. You don't need to enter any information in this section. When you save an employee for the first time, the system will auto-populate the newly created header id and line ids.

All Fields
SequenceNameLabelInputTypeField Group
10vvHrJobNameHr Job NamedefferedSelectCONTROL
10vvHrJobCodeHr Job CodedefferedSelectCONTROL
20vvHrCompensationNameHr Compensation NamedefferedSelectDEFAULT
30vvHrCompensationRevisionNumberHr Compensation Revision NumberdefferedSelectDATA
40vvHrGradeHr GradedefferedSelectCONTROL
50vvHrGradeRankHr Grade RankdefferedSelectCONTROL
60vvHrPositionNameHr Position NamedefferedSelectCONTROL
70vvPayrollNamePayroll NamedefferedSelectCONTROL
80vvPayrollCodePayroll CodedefferedSelectCONTROL
90vvEntitlementNameEntitlement NamedefferedSelectDEFAULT
100vvEmpLeaveEntitlementHeaderIdEmp Leave Entitlement Header IdInputType.textREFERENCE
110vvEmpCompensationHeaderIdEmp Compensation Header IdInputType.textREFERENCE
120vvEmployeeNameEmployee NamedefferedSelectENTITY
130hrEmployeeIdHr Employee IdInputType.textREFERENCE
140identificationNumberIdentification NumberInputType.textFieldDATA
150startDateStart DateInputType.dateDATE
160identificationTypeIdentification TypeInputType.textFieldCONTROL
170citizenNumberCitizen NumberInputType.textFieldDATA
180firstNameFirst NameInputType.textFieldDEFAULT
190lastNameLast NameInputType.textFieldDEFAULT
200phonePhoneInputType.textFieldENTITY
210emailEmailInputType.textFieldENTITY
220languageLanguageInputType.textFieldDEFAULT
230titleTitleInputType.textFieldDEFAULT
240genderGenderInputType.selectDEFAULT
250personTypePerson TypeInputType.selectCONTROL
260dateOfBirthDate Of BirthInputType.datepersonal
270cityOfBirthCity Of BirthInputType.textFieldpersonal
280countryOfBirthCountry Of BirthInputType.textFieldpersonal
290nationalityNationalityInputType.textFieldpersonal
300disabilityCodeDisability CodeInputType.textFieldpersonal
310maritalStatusMarital StatusInputType.selectpersonal
320degreeDegreeInputType.textFieldpersonal
330highestEducationHighest EducationInputType.textFieldpersonal
340educationDetailsEducation DetailsInputType.textFieldpersonal
350noOfChildrenNo Of ChildrenInputType.numberpersonal
360homeAddressIdHome Address IdInputType.textREFERENCE
370homeAddressHome AddressInputType.textFieldENTITY
380permanentAddressPermanent AddressInputType.textFieldENTITY
390permanentAddressIdPermanent Address IdInputType.textREFERENCE
400mobileNumberMobile NumberInputType.textFieldDATA
410homePhoneNumberHome Phone NumberInputType.textFieldDATA
420otherEmailOther EmailInputType.textFieldENTITY
430dateFirstHiredDate First HiredInputType.dateDATE
440legalOrgIdLegal Org IddefferedSelectREFERENCE
450hrJobIdHr Job IddefferedSelectREFERENCE
460hrPositionIdHr Position IddefferedSelectREFERENCE
470hrPayrollIdHr Payroll IddefferedSelectREFERENCE
480hrGradeIdHr Grade IddefferedSelectREFERENCE
490hrCompensationHeaderIdHr Compensation Header IddefferedSelectREFERENCE
500hrLeaveEntitlementHeaderIdHr Leave Entitlement Header IddefferedSelectREFERENCE
510locationIdLocation IdInputType.textREFERENCE
520jobTypeJob TypeInputType.selectCONTROL
530jobStatusJob StatusInputType.selectCONTROL
540supervisorEmployeeIdSupervisor Employee IdInputType.textREFERENCE
550probationPeriodUomProbation Period UomdefferedSelectFINANCE
560probationPeriodProbation PeriodInputType.numberFINANCE
570noticePeriodUomNotice Period UomdefferedSelectFINANCE
580noticePeriodNotice PeriodInputType.numberFINANCE
590revisionNumberRevision NumberInputType.numberDATA
600workPolicyIdWork Policy IdInputType.textREFERENCE
610expenseAcIdExpense Ac IddefferedSelectREFERENCE
620salaryAcIdSalary Ac IddefferedSelectREFERENCE
630performanceIdPerformance IdInputType.textREFERENCE
640vehicleNumberVehicle NumberInputType.textFieldDATA
650assetNumbersAsset NumbersInputType.textFieldDATA
660contractIdContract IdInputType.textREFERENCE
670bankAccountIdBank Account IdInputType.textREFERENCE
680taxRegNumberTax Reg NumberInputType.textFieldDATA
690socialAcNoSocial Ac NoInputType.textFieldpersonal
700socialAcNo2Social Ac No 2InputType.textFieldpersonal
710passportNumberPassport NumberInputType.textFieldDATA
760glAcProfileHeaderIdGl Ac Profile Header IddefferedSelectREFERENCE
770srcEntityNameSrc Entity NamedefferedSelectDEFAULT
780srcEntityIdSrc Entity IdInputType.textREFERENCE
5720createdByCreated ByInputType.textREFERENCE
5730creationDateCreation DateInputType.textREFERENCE
5740lastUpdatedByLast Updated ByInputType.textREFERENCE
5750lastUpdateDateLast Update DateInputType.textREFERENCE

Education

You can maintain employee education on the education tab. Employees can also add/update their education details in the self-service work area.

You can add multiple employee education details to each employee header. Each employee's education shows an employee's education name, code, education type, education value, etc.

Navigate to the "employee education" tab to view/add/update employee education details.
Click on the add new entity to add a new line. If a line already exists, click on copy entity to copy all the details. You can enable/disable fields allowed to be copied in the menu configuration.

Degree Level: Select an education degree level. It's mandatory field with several values : 'high_school', 'apprenticeship', 'diploma', 'associate', 'bachelor', 'master', 'doctoral', 'professional', 'other'

You can make any other field, such as institute, education mode, start date, end date, etc., mandatory by changing the configuration.

Scroll left, right, up, and down view all other fields.
The reference groups show various ids for reference only. You don't need to enter any information in this section.

The default configuration shows fields in various functional groups, such as

  • Reference
  • Control
  • Etc

You can configure the application to show which fields should be shown under which group. You can also create new groups as per your business requirements.

Enter all the other fields and click on the save button to save the employee. The app will post all the data to the server and will show the messages returned from the server.

All Fields
SequenceNameLabelInputTypeField Group
10hrEmployeeEducationIdHr Employee Education IdInputType.textREFERENCE
10hrEmployeeIdHr Employee IddefferedSelectREFERENCE
20degreeLevelDegree LevelInputType.selectDEFAULT
30seqSeqInputType.numberDEFAULT
40degreeNameDegree NameInputType.textFieldDEFAULT
50instituteInstituteInputType.textFieldDEFAULT
60instituteAddressInstitute AddressInputType.textFieldENTITY
70specializationSpecializationInputType.textFieldDEFAULT
80eduStartDateEdu Start DateInputType.dateDATE
90eduEndDateEdu End DateInputType.dateDATE
100modeOfEducationMode Of EducationInputType.selectDEFAULT
110gradeGradeInputType.textFieldDEFAULT
120marksPercentageMarks PercentageInputType.textFieldDEFAULT
130commentsCommentsInputType.textFieldDEFAULT
180srcEntityNameSrc Entity NamedefferedSelectDEFAULT
190srcEntityIdSrc Entity IdInputType.textREFERENCE
5140createdByCreated ByInputType.textREFERENCE
5150creationDateCreation DateInputType.textREFERENCE
5160lastUpdatedByLast Updated ByInputType.textREFERENCE
5170lastUpdateDateLast Update DateInputType.textREFERENCE

Experience

You can maintain employee experiences on the experience tab. Employees can also add/update their experience details in the self-service work area.

You can add multiple employee experience details to each employee header. Each employee experience shows an employee experience name, code, experience type, experience value, etc.

Navigate to the "employee experience" tab to view/add/update employee experience details.
Click on the add new entity to add a new line. If a line already exists, click on copy entity to copy all the details. You can enable/disable fields allowed to be copied in the menu configuration.

Designation:Enter a designation. It's a free text mandatory field.

Organization:Enter the name of the organization. It's also another free text mandatory field.

You can make any other field, such as job, position, salary, etc., mandatory by changing the configuration.

Scroll left, right, up, and down view all other fields.
The reference groups show various ids for reference only. You don't need to enter any information in this section.

The default configuration shows fields in various functional groups, such as

  • Reference
  • Control
  • Etc

You can configure the application to show which fields should be shown under which group. You can also create new groups as per your business requirements.

Enter all the other fields and click on the save button to save the employee. The app will post all the data to the server and will show the messages returned from the server.

All Fields
SequenceNameLabelInputTypeField Group
10hrEmployeeExperienceIdHr Employee Experience IdInputType.textREFERENCE
10hrEmployeeIdHr Employee IddefferedSelectREFERENCE
20organizationNameOrganization NameInputType.textFieldENTITY
30designationDesignationInputType.textFieldDEFAULT
40employmentTypeEmployment TypeInputType.selectCONTROL
50seqSeqInputType.numberDEFAULT
60employeeNumberEmployee NumberInputType.textFieldDATA
70departmentDepartmentInputType.textFieldDEFAULT
80workStartDateWork Start DateInputType.dateDATE
90workEndDateWork End DateInputType.dateDATE
100jobJobInputType.textFieldDEFAULT
110positionPositionInputType.textFieldDEFAULT
120gradeGradeInputType.textFieldDEFAULT
130lastManagerLast ManagerInputType.textFieldDEFAULT
140lastDrawnSalaryLast Drawn SalaryInputType.textFieldDEFAULT
150communicationDetailsCommunication DetailsInputType.textFieldDEFAULT
160projectDetailsProject DetailsInputType.textFieldDEFAULT
170srcEntityNameSrc Entity NamedefferedSelectDEFAULT
180srcEntityIdSrc Entity IdInputType.textREFERENCE
5190createdByCreated ByInputType.textREFERENCE
5200creationDateCreation DateInputType.textREFERENCE
5210lastUpdatedByLast Updated ByInputType.textREFERENCE
5220lastUpdateDateLast Update DateInputType.textREFERENCE