BeyondERP.Newsletter
Menu

Setup page · Human resources

Position hierarchy validation

A page that checks the position line hierarchy for circular references, such as two positions that each report to the other, as of a date and time you enter.

Used by
Compensation and benefits manager, Human resource assistant, Recruiter
Business process
Develop people strategy
Menu item
HcmPositionHierarchyInCircularReference
Main table
HcmTmpPositionHierarchyC
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 isA page that checks the position line hierarchy for circular references, such as two positions that each report to the other, as of a date and time you enter.
What you do hereUse this page to find reporting loops before they break manager lookups and workflow routing, and to check the structure again at other dates.
ExampleFor example, after a reorganization BEAT sets position 000220 to report to 000300 while 000300 already reports to 000220; validating as of April 1, 2026 lists both positions, and after 000300 is pointed to 000100 the check returns no lines.
Position hierarchy validation 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

Business processDevelop people strategy
Menu pathHuman resources › Positions › Position hierarchy validation
Set up firstAll positions (Reports to position) Microsoft Learn
Used next byPosition hierarchy Microsoft Learn
Related pagesPosition hierarchy types Microsoft Learn
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

Validate the line hierarchy

Find reporting loops before go-live and after each reorganization.

Steps from Microsoft

  1. Go to Human resources > Positions > Position hierarchy validation.
  2. Enter the date and time to check the hierarchy as of.
  3. Select Validate line hierarchy.
  4. Review the Position, Description and Reports to position of each position caught in a circular reference.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
PositionA position caught in a circular reference in the line hierarchy.Microsoft Learn 000220
Reports to positionThe position it reports to, which in turn leads back to it.Microsoft Learn 000300

Common errors and fixes

MessageWhat to do
The check returns no lines but a loop appears laterDetection is done for one point in time. Run it again as of the effective date of the planned reporting changes. Microsoft Learn
The page isn't in the menuIt is part of the Human resource user experience enhancements feature. Turn the feature on in Feature management. Microsoft Learn

Test checklist

  1. In a test company, set position A to report to position B and position B to report to position A.
  2. Run Position hierarchy validation and check the loop between A and B is reported.
  3. Correct the Reports to position on one of them, run the validation again and check no circular reference is reported.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Validate the line hierarchyValidate as of today and as of the effective date of every planned reporting change; an empty result is the target.Detection covers one point in time only, and a loop means the manager of the positions in it can't be found correctly.When should the hierarchy be validated?Running it once as of today and missing loops created by future-dated reports-to changes.Test: Loop is reported

Feature management and licence

Feature to turn onHuman resource user experience enhancements (Must be on)
Licence or add-inOn BEAT the page is run by Human resource assistant, Compensation and benefits manager and Recruiter; the full list is under the page's security roles.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: the check reads positions, which are not per company; Data management lists Positions V2 and Position hierarchies as shared. Checked in Dynamics 365
Can it be undoneReversible: The page runs a check for circular references in the position line hierarchy. It reports problems; you fix them by changing the Reports to position on the affected positions. Microsoft Learn
If you change it laterCircular reference detection is limited to a single point in time, so a loop created by a future-dated reports-to change shows only when you validate as of that date. Fixing a loop changes who the workers' manager is from the date of the change. Microsoft Learn
Technical architect

6Technical

Menu itemHcmPositionHierarchyInCircularReference Checked in Dynamics 365
FormHcmPositionHierarchyInCircularReference Checked in Dynamics 365
TableHcmTmpPositionHierarchyCShown as “CIRCULAR REFERENCES IN POSITION HIERARCHY” in Record infoChecked in Dynamics 365
Who can open itPrivilegesValidate position hierarchy HcmPositionHierarchyInCircularReferenceDutiesMaintain job and position master HcmJobPositionMaintain
3 security rolesCompensation and benefits manager HcmCompensationAndBenefitsManagerHuman resource assistant HcmHumanResourceAssistantRecruiter HcmRecruiter
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 HcmRecruiterGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmPositionHierarchyInCircularReference
Data migrationLoad order: Position hierarchy validation has no data entity in Data management, so it can't be loaded from a file or a configuration template. It checks the loaded positions; load positions and Position hierarchies with the Jobs and positions template, then run the check as of the go-live date.Microsoft Learn
Everyone

8Sources