BeyondERP.Newsletter
Menu

Page · Human resources

Skill mapping profiles

A page where you create and save skill mapping profiles, which are sets of skill, education, certificate and range criteria used to search for workers, applicants or contacts with matching qualifications.

Used by
Human resource assistant, Human resource manager, Recruiter and 1 more role
Business process
Develop people strategy
Menu item
HcmSkillMapping
Main table
HcmSkillMappingHeader
Data entity
HcmSkillMappingHeaderEntity
Setup steps
2 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 where you create and save skill mapping profiles, which are sets of skill, education, certificate and range criteria used to search for workers, applicants or contacts with matching qualifications.
What you do hereUse this page to define a profile or retrieve one from a person, job or course, mark criteria as optional with an importance, run the search, and view the best matches and gaps.
ExampleFor example, for the opening Senior accountant the recruiter creates the profile SrAccountant-2026, retrieves the profile of the Senior accountant job (CPA, Excel at Expert, a Bachelor's degree), limits the range to the Finance department, marks Excel Optional with Importance High, and the result lists 2 applicants and 1 employee, with the best match at the top of the report.
Skill mapping profiles 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

Set up Skill mapping profiles

Use this page to define a profile or retrieve one from a person, job or course, mark criteria as optional with an importance, run the search, and view the best matches and gaps.

Find candidates for an opening with a profile

Build a search profile from the job of the opening and run it over applicants and workers.

Steps from Microsoft

  1. Go to Human resources > Recruitment > Skill analysis > Skill mapping profiles.
  2. Select New, name the profile after the opening, and enter the Description and Date.
  3. Select Retrieve profile > Job, select the job of the opening, and select OK.
  4. On the Range FastTab, add limits such as the department; review the Certificates, Skills and Education FastTabs.
  5. Mark nice-to-have criteria Optional and set their Importance.
  6. Select Execute, then Result; open Resume for a person to see their certificates, skills and experience.
  7. Select Report to see the best matches first and the gap for each criterion, then Save the profile.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Skill mappingThe name of the profile.Microsoft Learn SrAccountant-2026
DateThe date as of which people must meet the criteria.Microsoft Learn 1 December
ApplicantIncludes applicants in the results (Worker and Contact work the same way).Microsoft Learn Yes
OptionalMakes a criterion optional rather than required.Microsoft Learn Yes, for Excel
ImportanceThe weight of an optional criterion when points are calculated.Microsoft Learn High
LevelThe minimum skill level people must have.Microsoft Learn Expert

Common errors and fixes

MessageWhat to do
A known applicant isn't in the resultOnly people with Include in skill mapping set to Yes are searched. Set it on the applicant and select Execute again. Microsoft Learn
The result is empty for a demanding jobMark nice-to-have criteria Optional with an Importance, remove criteria the opening doesn't need, and run it again. Microsoft Learn

Test checklist

  1. Create a profile with a name, description and date, then select Retrieve profile > Job and pick a job that has skills set up.
  2. Check the Certificates, Skills and Education FastTabs are filled from the job; mark one skill Optional and set its Importance.
  3. Select Execute, then Result, and check people with matching competencies are listed.
  4. Select Report and check the best matches are at the top with gap elements shown.
  5. Set Include in skill mapping to No for one matching applicant, run Execute again and check the applicant no longer appears.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Skill mapping profilesStart each profile with Retrieve profile from the job (or from a person whose skills you want to match), then mark the nice-to-have criteria Optional with an Importance.Retrieve profile pulls in the certificate, skill and education data of the selected person, job or course as the basis of the search; you then add or remove criteria, mark them optional and rank their importance.What should a succession profile start from?Expecting every worker or applicant to be searched. Only workers, applicants and contact persons with Include in skill mapping set to Yes appear in results, so people without it are silently missed.Test: Skill mapping returns only people included in skill mapping
Find candidates for an opening with a profileOne profile per opening, retrieved from the job, with the range limited where it matters and nice-to-have criteria marked Optional with an Importance; run it with Applicant and Worker both included.Retrieve profile pulls the job's certificates, skills and education as the search basis; the report ranks the best matches and shows the gap between the profile level and the person's level.Whom should a profile for an opening search?Expecting every applicant to be searched: only people with Include in skill mapping set to Yes appear.Test: Profile ranks matching applicants

Feature management and licence

Licence or add-inRecruiters, HR staff and training managers use it: the live security grants it to the Recruiter, Human resource manager, Human resource assistant and Training manager roles. No Feature management feature is needed for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: skill mapping profiles are not per company. Data management lists the Skill-mapping - main entity as shared, so every legal entity sees the same records. Checked in Dynamics 365
Can it be undoneReversible: Profiles are saved search criteria. Editing and running them again only changes the result list; worker, applicant and job competencies are not changed. Microsoft Learn
If you change it laterOnly people marked Include in skill mapping appear in the results. Microsoft Learn
Technical architect

6Technical

Menu itemHcmSkillMapping Checked in Dynamics 365
FormHcmSkillMapping Checked in Dynamics 365
TableHcmSkillMappingHeaderShown as “SKILL-MAPPING - MAIN” in Record infoKey field: SkillMappingHeaderIdChecked in Dynamics 365
Data entitiesHcmSkillMappingHeaderEntitySkill-mapping - main Checked in Dynamics 365HcmSkillMappingSkillEntitySkill-mapping - skills (The skill criteria of a profile.) HcmSkillMappingCertificateEntitySkill-mapping - certificates (The certificate criteria of a profile.) HcmSkillMappingEducationEntitySkill-mapping - education (The education criteria of a profile.) HcmSkillMappingRangeEntitySkill-mapping - criteria (The range criteria of a profile, such as department.)
Who can open itPrivilegesMaintain skill mapping profiles HcmSkillMappingProfileMaintainView skill mapping profiles HcmSkillMappingProfileViewDutiesInquire into skills data HcmSkillInquireMaintain skills HcmSkillMaintainInquire into training process HcmTrainingProcessInquire
4 security rolesHuman resource assistant HcmHumanResourceAssistantHuman resource manager HcmHumanResourceManagerRecruiter HcmRecruiterTraining manager HcmTrainingManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itHuman resource assistant HcmHumanResourceAssistantRecruiter HcmRecruiterTo use itHuman resource manager HcmHumanResourceManagerTraining manager HcmTrainingManagerGive people one of these roles. On this system, 4 roles can open this page.Checked in Dynamics 365
Actions on the page(Action Pane without tabs): Execute, Result, Retrieve profileChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=HcmSkillMapping
Integrate withHcmSkillMappingHeaderEntity data entity Checked in Dynamics 365
Data migrationHcmSkillMappingHeaderEntity Skill-mapping - main: the profile header. Shared by all companies.HcmSkillMappingSkillEntity Skill-mapping - skills.HcmSkillMappingCertificateEntity Skill-mapping - certificates.HcmSkillMappingEducationEntity Skill-mapping - education.HcmSkillMappingRangeEntity Skill-mapping - criteria.Load order: Skill mapping is in the Employee development template: load skills, certificate types and education disciplines first, then the profile header, then its criteria lines.Load first: HcmSkillEntity, HcmCertificateTypeEntity, HcmEducationDisciplineEntityMicrosoft Learn
Everyone

8Sources