Skip to content

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).

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

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.

  1. Select Applicant, then choose the applicant and job. Only applications that are ready to hire and not yet hired are listed.
  2. Check the start date, job title, organizational unit, and location, which are filled in from the job requisition.
  3. Complete the other fields. Start date and Job Title are required.
  4. Choose an Onboarding Template, or leave it blank to use the default.
  5. 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.

  1. Select Existing Employee, then choose the employee.
  2. Check the employment details, which are filled in from their current employment. If their employment has not started yet, the upcoming one is used.
  3. 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.
  4. Choose an Onboarding Template, or leave it blank to use the default.
  5. 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.

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.

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.

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.

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: 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.