BeyondERP.Newsletter
Menu

Page · Human resources

Workers

The main worker list and record page, which shows employees and contractors together in one list.

Used by
Accounts payable manager, Auditor, Chief executive officer and 23 more roles
Business process
Update worker information
Menu item
HcmWorkerListPage
Main table
HcmWorker
Data entity
HcmWorkerEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isThe main worker list and record page, which shows employees and contractors together in one list.
What you do hereUse this page to view and update worker and employment information for past, active, and future employees and contractors, across legal entities if needed.
ExampleFor example, BEAT's HR assistant sets View options to exited employees in all legal entities and finds 18 people who left in 2026, each with a termination date and reason; she then opens Tom Becker, who moved from BEAT to BEUK, and sees both employments on the Work history tab.
Workers page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Transfer and terminate workers from the worker record

Run transfers and terminations so position assignments, employment and follow-up checklists stay right.

Steps from Microsoft

  1. Go to Human resources > Workers > Workers.
  2. Use this list to find any worker, past, active or future, employee or contractor. Pending workers and Past workers show narrower parts of the same records.
  3. In View options, choose active, pending or exited workers, employees or contractors, and the current legal entity or all legal entities; the columns change with your choice.
  4. Search on Personnel number, the unique identifier of the worker, when two workers have similar names.
  5. Select a worker to read the banner: for an active worker it shows Title, Department, Position type, Worker type, Manager and Legal entity.
  6. Use the Work history and Positions tabs to see and edit the worker's employment and position history across legal entities.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
TitleThe worker's job title, shown in the banner for active workers.Microsoft Learn Sales manager
Worker typeShows whether the worker is an employee or a contractor.Microsoft Learn Employee
Personnel numberThe unique identifier of the worker.Microsoft Learn 000087PersonnelNumber
Employment start dateThe date the worker's employment starts, such as the hire date.Microsoft Learn 1 March 2026

Common errors and fixes

MessageWhat to do
A worker can't simply be moved to a position in another legal entityEmployment is per legal entity. Terminate the employment in the first legal entity, then rehire the person in the new one, so leave, benefits and performance data stay consistent. Microsoft Learn
Exited or pending workers are missing from the listView options show active workers unless you choose otherwise. Select exited or pending workers, and all legal entities if needed. Microsoft Learn
Workers of some legal entities never appearWith advanced security on, the list shows only workers in the legal entities you have access to. Ask for access to the other legal entities. Microsoft Learn

Test checklist

  1. Open Workers and use View options to show employees and contractors across legal entities.
  2. Switch View options to exited workers and check that termination date and reason columns appear.
  3. Open an active worker and check the banner shows Title, Department, Position type, Worker type, Manager and Legal entity.
  4. On the Work history tab, edit an entry for another legal entity and check it saves without changing company.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Transfer and terminate workers from the worker recordWithin a legal entity, transfer by changing the worker's position assignment (with an approval workflow if policy needs one); between legal entities, terminate and rehire. Terminate with a termination date and a reason code, and apply the offboarding or transition checklist.Terminating employment ends all of the worker's position assignments and employment affiliations; a transfer between legal entities done as terminate and rehire keeps leave, benefits and performance data consistent.How are transfers between legal entities done?Moving a worker to another legal entity without terminating the old employment first, which leaves employment data inconsistent.Test: Transfer between legal entities

Feature management and licence

Feature to turn onStreamlined employee entry (Mandatory, on by default)

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared worker, per-company employment: Data management lists the Worker entity as shared, so a person is one worker record for every legal entity, while employment is held per legal entity. To move a worker to another legal entity, Learn's way is to end the employment in the first legal entity and rehire in the new one. With View options you can list workers of the current legal entity or of every legal entity you have access to. Checked in Dynamics 365
Can it be undoneHard to reverse: Work history entries can be edited directly on the page for past, active and pending workers. Deleting a worker is only possible after termination and after removing position assignments, fixed and variable compensation and checklists, so treat worker creation as hard to reverse. Microsoft Learn
If you change it laterTurning on the Disable streamlined employee entry parameter switches off the streamlined worker entry experience on this page. Microsoft Learn
Technical architect

6Technical

Menu itemHcmWorkerListPage Checked in Dynamics 365
FormHcmWorkerV2 Checked in Dynamics 365
TableHcmWorkerShown as “WORKER” in Record infoKey field: Person_NameChecked in Dynamics 365
Data entitiesHcmWorkerEntityWorker Microsoft data model
Who can open itPrivilegesView limited workers HcmLimitedWorkerViewEdit workers HcmWorkerEditMaintain workers HcmWorkerMaintainView workers HcmWorkerViewMaintain time registration workers JmgLimitedWorkerMaintainView limited workers JmgLimitedWorkerViewView workers RetailLimitedWorkerView RetailStoreManagementWorkspaceMaintainMaintain store management workspace for retail trial. RetailTrialStoreManagementWorkspaceMaintainDutiesMaintain audit policies AuditPolicyMaintainCreate maintenance requests EntAssetRequestCreateMaintain maintenance requests EntAssetRequestMaintainMaintain Asset Management setup EntAssetSetupMaintainView Enterprise Asset Management setup EntAssetSetupViewInquire into benefits process HcmBenefitInquireInquire into limited worker information HcmLimitedWorkerInquireInquire into workers HcmWorkerInquireInquire into workers for CEO HcmWorkerInquireCEOMaintain worker master HcmWorkerMaintainView information about workers HcmWorkerViewInquire into time registration workers JmgLimitedWorkerInquireMaintain time registration workers JmgLimitedWorkerMaintainInquire into payroll position and worker setup PayrollPositionWorkerSetupInquireSet up payroll positions and workers PayrollPositionWorkerSetupMaintainEnable project accounting process ProjProjectAccountingProcessEnableMaintain project master ProjProjectMasterMaintain RetailStoreManagementWorkspaceMaintainMaintain store management workspace for retail trial. RetailTrialStoreManagementWorkspaceMaintainMaintain retail worker RetailWorkerMaintain TrvEmployeeCreditCardMaintainEnable expense management process TrvTravelAndExpenseProcessEnableInquire into expense management reference data TrvTravelAndExpenseReferenceDataInquire
27 security rolesAuditor AuditPolicyManagerChief executive officer CompanyChiefExecutiveOfficerMaintenance clerk EntAssetMaintenanceClerkMaintenance manager EntAssetMaintenanceManagerMaintenance requester EntAssetMaintenanceRequesterExpense administrator ExpenseAdministratorField Service Integration User FieldServiceIntegrationUserCompensation and benefits manager HcmCompensationAndBenefitsManagerHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerPayroll administrator HcmPayrollAdministratorPayroll manager HcmPayrollManagerRecruiter HcmRecruiterTraining manager HcmTrainingManagerIoT messaging service role IoTIntMessagingServiceRoleShop supervisor JmgShopSupervisorProduction manager ProdProductionManagerProject accountant ProjProjectAccountantProject manager ProjProjectManagerProject supervisor ProjProjectSupervisorRetail operations manager RetailOperationsManagerRetail service RetailServiceRetail store manager RetailStoreManagerService delivery manager SMAServiceDeliveryManager TestRoleJmgLimitedWorkerMaintainSales manager TradeSalesManagerAccounts payable manager VendInvoiceAccountsPayableManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itHuman resource assistant HcmHumanResourceAssistantCompensation and benefits manager HcmCompensationAndBenefitsManagerRecruiter HcmRecruiterPayroll administrator HcmPayrollAdministratorRetail operations manager RetailOperationsManagerTo use itHuman resource manager HcmHumanResourceManagerPayroll manager HcmPayrollManagerTraining manager HcmTrainingManagerChief executive officer CompanyChiefExecutiveOfficerRetail service RetailServiceGive people one of these roles. On this system, 26 roles can open this page.Checked in Dynamics 365
Actions on the pageWork: Personnel actions, Work details, Changes timeline, Related informationPerson: Personal information, Competencies, DevelopmentLeave: Manage leave, Set upCompensation: Employee compensation, Bank accounts, Labor unions, CommissionPayroll: Taxes, Payroll, Ready to pay, GenerateBenefits: Benefits, Enrollment, Eligibility, ReportsCompliance: ComplianceTime: Maintain, Reports, Inquiries, Time assignment, Flex, Worker balancesProject: Set up, Project control, Transactions, ViewCommerce: Set up, Media, View, External identity, POSGeneral: Cases, CAPA, Set up, Registration, WarehousesExpense: Edit(Action Pane without tabs): New, DeleteChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmWorkerListPage
Integrate withHcmWorkerEntity data entity Microsoft data model
Data migrationHcmWorkerBaseEntity Base worker: the worker record with the person's name and personnel number. Shared by all companies.HcmEmploymentV2Entity Employment V2: the worker's employment in each legal entity, with start and end dates.HcmEmploymentDetailEntity Employment detail: the details of each employment.HcmPersonDetailsEntity Person details: the person's private details.HcmPositionWorkerAssignmentV2Entity Position worker assignments V2: the positions the worker holds.Load order: Load with the Worker data migration template, in its order: Base worker, Employment V2, Employment detail, Person details, then identification, contacts and screenings, then Position worker assignments V2 and Worker primary position. Load the Personnel management setup template and the positions of the Jobs and positions template first, because assignments point to positions.Load first: HcmPositionWorkerAssignmentV2Entity, HcmEmploymentV2Entity, HcmWorkerBaseEntityMicrosoft Learn
Everyone

8Sources