Microsoft Entra ID Field Mapping for HR Sync
HR Sync can connect equipme with different HR and identity systems. The fields available for synchronization depend on the connected source system and the configured mapping.
This article documents the standard mapping currently used when employee data is synchronized from Microsoft Entra ID to equipme.
Important: This overview applies specifically to Microsoft Entra ID. Other HR Sync source systems may provide different fields and mappings.
Standard field mapping
Microsoft Entra ID field
Microsoft Graph property
Field in equipme
Behavior in equipme
First name
givenName
First name
The value is transferred to the employee profile
Last name
surname
Last name
The value is transferred to the employee profile
User principal name
userPrincipalName
Username
The UPN is used as the employee’s username
Job title
jobTitle
Position
The value is transferred as the employee’s position
Department
department
Department group
The employee is assigned to the corresponding department group. A new group is created if it does not yet exist
Employee ID
employeeId
Personnel number
The value is transferred as the personnel number
Office location
officeLocation
Location
The employee is assigned to the corresponding location. A new location is created if it does not yet exist
Business phone
businessPhones
Business phone
The value is transferred to the business phone field
Mobile phone
mobilePhone
Mobile number
The value is transferred to the mobile number field
Email address
mail
Business email
The value is transferred as the employee’s business email address
Cost center
employeeOrgData.costCenter
Cost center
The value is transferred as the employee’s cost center
Manager
manager
Supervisor
The manager relationship is used to assign the employee’s supervisor
Username and business email
Microsoft Entra ID stores the user principal name and the email address separately.
The user principal name, or UPN, is transferred to the Username field in equipme. The value stored in the Entra email field is transferred separately to the Business email field.
Source in Microsoft Entra ID
Target in equipme
User principal name
Username
Email address
Business email
Although both values are often identical, they are treated as separate source fields.
Departments and locations
The department stored in Microsoft Entra ID is mapped to a department group in equipme. The value from the Entra office location field is mapped to a location in equipme.
When a matching department group or location does not yet exist, it is created during synchronization. The employee is then assigned to the corresponding structure.
Source value
Result in equipme
Existing department
The employee is assigned to the existing department group
New department
A new department group is created and assigned
Existing office location
The employee is assigned to the existing location
New office location
A new location is created and assigned
Microsoft Entra ID does not provide a dedicated location object with its own address data. The officeLocation field only supplies the location name used for the assignment.
As a result, locations created through the Entra synchronization do not contain an address. The address must be added and maintained directly in equipme after the location has been created.
Ich würde außerdem die Location-Zeile in der Haupttabelle leicht anpassen:
Microsoft Entra ID field
Microsoft Graph property
Field in equipme
Behavior in equipme
Office location
officeLocation
Location
The employee is assigned to the corresponding location. A new location is created if it does not yet exist. Newly created locations do not include an address
Personnel number and cost center
The Entra employee ID is transferred to the Personnel number field in equipme.
The standard source for the cost center is:
employeeOrgData.costCenter
The value is transferred to the employee’s Cost center field in equipme.
Some organizations maintain information such as the cost center or company location in another Entra attribute. In these cases, the source field can be adjusted as part of the HR Sync configuration, provided the required information is available as a suitable single value field.
Supervisor
The manager assigned to a user in Microsoft Entra ID is used to populate the Supervisor field in equipme.
This allows the reporting relationship maintained in Entra to be represented in the employee structure in equipme.
Optional home office address
The contact address stored in Microsoft Entra ID is not transferred as a home office address in the standard configuration.
The address mapping can be enabled separately when the address data in Entra is maintained as the employee’s actual home office address.
Before enabling this option, the organization should verify that the Entra address fields contain the intended employee address and not a general company or office address.
Scope of this overview
This table documents the standard Microsoft Entra ID mapping currently used for HR Sync.
The mapping is not a universal field list for every HR Sync connection. Other connected systems may provide different employee attributes, and individual mappings may be adjusted during configuration when an organization maintains information in different source fields.