Onboarding
Onboarding turns a successful applicant into an employee and tracks the tasks that need to be done for each new hire. You can also use it for someone who is already an employee.
Navigation: left sidebar → HR → Recruitment → Onboarding (/recruitment/onboardings).
Workflow
Section titled “Workflow”| Step | Where | What happens |
|---|---|---|
| 1 | Onboarding templates | Set up the task list, and mark one template as the default |
| 2 | Job applications | Set the application to a status that is ready to hire (Completed by default) |
| 3 | New employee onboarding | Hire the applicant, or start onboarding for an existing employee |
| 4 | Track progress | Task owners complete their tasks, and HR follows progress |
Start onboarding
Section titled “Start onboarding”Open the form from either place:
- Recruitment → Onboarding → Create
- Personnel → Employees → header menu (⋯) → New Employee Onboarding
Use Onboarding For to choose who the onboarding is for.
Hire an applicant
Section titled “Hire an applicant”- Select Applicant, then choose the applicant and job. Only applications that are ready to hire and not yet hired are listed.
- Check the start date, job title, organizational unit, and location, which are filled in from the job requisition.
- Complete the other fields. Start date and Job Title are required.
- Choose an Onboarding Template, or leave it blank to use the default.
- Click Hire Applicant.
AKAS then:
- Creates the employee from the applicant’s personal and contact details.
- Copies education, work experience, languages, skills, memberships, and references.
- Creates the first employment record.
- Sets the job application status to Hired.
- Starts onboarding with the template’s tasks.
The form does not set pay. Complete pay and the remaining employment details on the Employment Record. Check the new employee’s details too, because applicants may not have every field that the employee form requires.
An applicant can only be hired once, even if their onboarding is later cancelled and deleted.
Start for an existing employee
Section titled “Start for an existing employee”- Select Existing Employee, then choose the employee.
- Check the employment details, which are filled in from their current employment. If their employment has not started yet, the upcoming one is used.
- Set Start date. It is filled in with the date they were employed, and task due dates are calculated from it, so change it if onboarding starts later.
- Choose an Onboarding Template, or leave it blank to use the default.
- Click Start Onboarding.
The copied employment details are read-only, because this only starts onboarding. To change them, use the Employment Record.
An employee can only have one onboarding in progress, and onboarding cannot be started for a separated employee.
Onboarding templates
Section titled “Onboarding templates”Templates are reusable task lists. Open them from HR → Recruitment → Onboarding Templates (/recruitment/onboarding-templates).
| Field | Description |
|---|---|
| Name / Local Name | Template name. |
| Default | Used when no template is chosen. Only one template can be the default, so setting it here removes it from any other template. |
| Disabled | The template can no longer be chosen. |
| Remark | Optional note. |
Each row in the task table is one task:
| Column | Description |
|---|---|
| Task | An item from the Employee Checklist list of values. Add an item there if the task you need isn’t listed. |
| Category | Optional grouping from the Onboarding Task Category list of values. |
| Owner | Who is responsible. See Task owners. |
| Specific Employee | The responsible employee. Only applies when the owner is SpecificEmployee. |
| Due Offset (Days) | Days from the start date. Use a negative number for tasks due before the start date. |
| Required | Whether the task must be done for onboarding to complete. This is off by default on new rows. |
| Description | Optional instructions. |
Tasks are copied when onboarding starts, so later changes to a template don’t affect onboarding already in progress. If no template is chosen and there is no default, onboarding starts with no tasks.
Task owners
Section titled “Task owners”| Owner | Assigned to |
|---|---|
| None | No one. Shown as Unassigned. |
| HR | No individual. Shown as HR. |
| Manager | The person in Reports to on the employee’s employment record. |
| SpecificEmployee | The employee chosen on the template task. |
Users with the update permission can complete any task, including tasks with no assignee.
Track progress
Section titled “Track progress”The Onboarding list shows each person’s template, start date, status, tasks completed, overdue tasks, and completed date. Filter by Status, or search by employee name or ID. Click the edit icon on a row to see its tasks.
The same tasks appear on the Onboarding tab of the employee form.
| Status | Meaning |
|---|---|
| In Progress | At least one required task is still open, or onboarding has just started. |
| Completed | All required tasks are done. Unticking a required task puts it back to In Progress. |
| Cancelled | Stopped by a user. Its tasks are kept but can no longer be changed. |
If a template has no required tasks, onboarding becomes Completed as soon as the first task is ticked.
Tasks assigned to you
Section titled “Tasks assigned to you”Open tasks assigned to you appear in the My Onboarding Tasks dashboard widget. Tick a task to complete it.
Assigned employees with a user account get a message in AKAS:
- When onboarding starts, listing their tasks.
- On the first day after a task’s due date, if it is still open.
Tasks with no assignee, such as HR tasks, don’t send messages. Follow those on the Onboarding list.
Cancel or delete
Section titled “Cancel or delete”Cancel: open an In Progress onboarding and click Cancel Onboarding. Completed onboarding cannot be cancelled.
Delete: on the Onboarding list, click the delete icon on a Cancelled row. Other statuses cannot be deleted.
Deleting removes the onboarding record and its tasks. It does not remove the employee or employment record. To restart onboarding for that person, use Existing Employee.
Which applications are ready to hire: the JOB_APP_HIRE_READY_STATUS system setting lists the job application status codes that can be hired, separated by commas. The default is completed. If your statuses use different codes, update this setting, otherwise no applicants will be listed.
Permissions: assign these through roles.
| Permission | Allows |
|---|---|
onboarding.list, onboarding.view |
See the Onboarding list, task details, and the employee form tab. |
onboarding.create |
Hire applicants and start onboarding. |
onboarding.update |
Complete any task, and cancel onboarding. |
onboarding.delete |
Delete cancelled onboarding. |
onboarding_tpl |
Manage onboarding templates. |
Employees can complete tasks assigned to them without these permissions.
Onboarding requires the hr_recruitment module to be enabled for the tenant.
