BeyondERP.Newsletter
Menu

Setup page · Human resources

Configure links

A setup page where system administrators define links that appear on Human Resources pages and open a specific page in another Finance environment.

Used by
Information technology manager
Business process
Develop people strategy
Menu item
UserDefinedLinkSetup
Main table
UserDefinedLink
Data entity
UserDefinedLinkEntity
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 setup page where system administrators define links that appear on Human Resources pages and open a specific page in another Finance environment.
What you do hereUse this page to set up the target Finance environments and the links themselves, including which Human Resources page shows each link and which page it opens.
ExampleFor example, BEAT adds the link Finance employees on the Worker page, target system BEAT-FIN and menu item HcmWorkerListPage_Employees; the system administrator tests it with Enable this link at No, then sets it to Yes for the 12 HR users.
Configure links 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

Steps from Microsoft

  1. Go to Human resources > User defined links > Configure links.
  2. Select Configure target system.
  3. Enter the target system name and the URL of the Finance environment.
  4. Create a link and enter the display name.
  5. Select the page to show the link on, the target system, and the target menu item.
  6. Set Enable this link to Yes when the link is ready for users.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
LinkThe name of the link, used only to identify it.Microsoft Learn FIN-EMPLName
Enable this linkShows the link to Human Resources users when set to Yes.Microsoft Learn YesIsEnabled
Display nameThe text users see as the link.Microsoft Learn Finance employeesDisplayName
Surface link on formThe page that shows the link: Employee self service, Job, Position, Worker or Streamlined Worker.Microsoft Learn WorkerSurfaceForm
GroupA group used to organize links.Microsoft Learn FinanceGroupName
Target systemThe other environment the link opens.Microsoft Learn BEAT-FINBaseName
Use user's current companyUses the user's current company in Finance, or a selected company when set to No.Microsoft Learn YesUseUserCurrentCompany
Link to data sourceThe data the link refers to, such as Worker or Position.Microsoft Learn Worker

Common errors and fixes

MessageWhat to do
Users get a security dialog box when they use a linkThey have no security rights in the target Finance environment. Grant them a role there for the target page. Microsoft Learn
HR users don't see a new linkEnable this link is No; only system administrators see links before they are enabled. Set it to Yes. Microsoft Learn

Test checklist

  1. Select Configure target system and enter the name and URL of the Finance environment.
  2. Create a link with Surface link on form = Worker, Target menu item HcmWorkerListPage_Employees and Enable this link = No.
  3. As a system administrator open a worker and check the link opens the employee list in the target environment.
  4. As an HR user check the link is hidden; set Enable this link to Yes and check it appears.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Configure linksLeave Enable this link at No until a system administrator has tested the link, then set it to YesSystem administrators see new links on the chosen pages even when Enable this link is No, so they can test before other roles see them.Which pages should carry links to Finance?Not granting users security rights in the target Finance environment. They then get a security dialog box when they use the link.Test: Link visibility before and after enabling

Feature management and licence

Feature to turn onHuman resource user experience enhancements (Must be on)
Licence or add-inOn BEAT the page is maintained by Information technology manager; the full list is under the page's security roles.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: links are not per company. Data management lists the User defined links and User defined link base URI entities as shared. Checked in Dynamics 365
Can it be undoneReversible: Links can be disabled or changed at any time; disabling hides them from all roles except system administrators. Microsoft Learn
If you change it laterEnabling a link makes it visible to every user who can open the page it is placed on; system administrators see links even before they are enabled, and users still need security rights in the target environment. Microsoft Learn
Technical architect

6Technical

Menu itemUserDefinedLinkSetup Checked in Dynamics 365
FormUserDefinedLinkSetup Checked in Dynamics 365
TableUserDefinedLinkShown as “USER DEFINED LINKS” in Record infoKey field: NameChecked in Dynamics 365
Data entitiesUserDefinedLinkEntityUser defined links UserDefinedLinkBaseUriEntityUser defined link base URI (The target systems: name and URL of each Finance environment.)
Who can open itPrivilegesMaintain user defined link setup for the system. UserDefinedLinkSetupMaintainDutiesMaintain user defined link setup including exposing external links within the core product to users. UserDefinedLinkMaintain
1 security roleInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itInformation technology manager SysServerITManagerGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the page(Action Pane without tabs): Configure target systemChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=UserDefinedLinkSetup
Integrate withUserDefinedLinkEntity data entity
Data migrationUserDefinedLinkBaseUriEntity User defined link base URI: the target systems. Shared.UserDefinedLinkEntity User defined links. Shared.Load order: Both entities are in the System setup template (010); load User defined link base URI before User defined links, because each link names its target system, and check the URL in each environment.Microsoft Learn
Everyone

8Sources