Skip to main content

​
Prerequisites

  • A Business Central tenant on runtime 15.0 (platform 25.2) or later — SaaS or on-prem.
  • The HA BC Base Extension (5dea1714-598f-45ee-8737-d68ad449291f) installed first. The HR extension depends on it.
  • A user with the D365 Extension Management permission set (or equivalent BC admin role).
  • For developer / sandbox installs: AL Language extension in VS Code, or the bc-tools PowerShell module.

​
Install paths

​
A. AppSource (production tenants)

Once published, the extension appears in Extension Marketplace inside BC. Search for Business Central Human Resource (publisher: Hamwi Computer Software) and click Install. Microsoft handles dependency resolution and runs OnInstallAppPerCompany automatically the first time the extension touches each company.

​
B. Sideload to a sandbox

  1. Build the .app file in VS Code (Ctrl+Shift+B on the AL project), or take the prebuilt one from BC-Human-Resource-AL/Hamwi Computer Software_Business Central Human Resource_*.app.
  2. In BC, search for Extension Management.
  3. Upload extension → pick the .app → tick Accept terms of use → Deploy.
  4. Wait for the upload to finish (typically under a minute on SaaS).

​
C. PowerShell / partner pipeline

Publish-NAVApp -ServerInstance BC -Path .\Hamwi*HumanResource*.app -SkipVerification
Sync-NAVApp -ServerInstance BC -Name "Business Central Human Resource" -Version <ver>
Install-NAVApp -ServerInstance BC -Name "Business Central Human Resource" -Version <ver>
On SaaS use Set-NAVServerConfiguration / the AppSource pipeline rather than direct cmdlets.

​
What happens on first install

The install codeunit (Cod70003100 Install Codeunit HAC) runs OnInstallAppPerCompany for each company in the tenant. It:
  1. Creates the EMPJNL general journal template and the DEFAULT batch under it. These are used by the Employee Journal.
  2. Inserts the default salary types: Basic Salary, Transportation Allowances, Travel Allowances, Communication Allowances, Accommodation Allowances. You can rename or delete them later.
  3. Creates every required No. Series with a No. Series Line so document inserts work immediately. Series codes created: SHFT, SLRY-PKG, SLRY, LV-TYP, LV, LV-RULE, LOAN, LOAN-INST, OVERTIME-RULE, EMP-POS, EOS, SOC-INS, HR-LET, HR-DOC, ADV-SLRY, ANN. Each series starts at <CODE>00001 and increments by 1.
Upgrading from an earlier internal build? The upgrade codeunit (Cod70003101 Upgrade Codeunit HAC) runs OnUpgradePerCompany and calls the same setup, so previously-missing series are created automatically.

​
Verifying the install

After the upload finishes:
  1. Search for HR General Setup (Tell-Me, Alt+Q). The page should open with Overtime Hour Rate Calculation Type defaulted to Uniform Month Length (30 Days Each).
  2. Search for Departments. The page should open empty (or with whatever you seeded). No errors.
  3. Search for HR Demo Data Generator — it’s available in Administration. You’ll use this in the next step.
If you see “The No. Series LOAN does not exist” on any HR page, the install codeunit didn’t run. Run it manually:
  • In Object Designer / VS Code: run codeunit 70003100 Install Codeunit HAC.
  • Or run the HR Demo Data Generator action below — it self-heals the No. Series before seeding.

​
Permission assignment

The extension ships a permission set named Human Resource HAC. Assign it to any user who should manage HR data:
  1. Search for Permission Sets.
  2. Filter for Human Resource HAC.
  3. Add it to your HR user’s permission set list, or to a permission set group used by HR roles.
The permission set grants RIMD on every HR-specific table in the extension. It does not grant standard BC employee permissions — assign D365 BUS PREMIUM (or one of the standard HR roles) alongside it.

​
Uninstall

In Extension Management, select the row and click Uninstall. BC asks whether to keep the data:
  • Keep data: tables are preserved. Re-installing the same version restores everything.
  • Delete data: every record in the HR-specific tables is removed. Standard BC tables (Employee, etc.) are untouched even when fields added by this extension are dropped — Microsoft handles that schema cleanup.

​
Next steps

Seed demo data

Populate a fresh tenant with starter records in one click.

Configure HR

First-time configuration walk-through.