With Emply People's integration to Microsoft Entra ID, users from your Entra ID groups will be synchronized to Emply People. This guide covers activating the integration, setting up the integration, and an overview of synchronized data.
Before activating and setting up the integration, ensure the following:
-
You only use cloud–Entra ID.
-
If you are using a hybrid setup, the integration works one-way only; data cannot be sent to your Entra ID.
-
The user who activates the integration must have the Global Administrator role in Microsoft Entra ID.
Microsoft Entra ID Activation
-
Go to + and click for the Microsoft Entra ID integration.
-
In the pop-up window, click .
-
Sign in with your Microsoft account (Ensure you log in as a Global Administrator). Review the permissions and click to grant Emply People access.
Calendar Options
-
Synchronize calendars: Enable to synchronize Outlook calendars with Emply People and gain the ability to add meeting rooms. When enabled, the Always share dates and titles with team members option becomes available.
-
Always share dates with titles and team members: Enable to turn on sharing for all existing calendars in Emply People and set it as the default for new calendars.
Setting up the integration
-
Add your Microsoft Entra ID groups.
-
Define the default settings:
-
Default role: Role assigned to all users in the group when created in Emply People. Existing users are updated if Synchronize roles is enabled.
-
Default department: Department assigned in user creating in Emply People.
-
Language: Default language for the user.
-
Time zone: Default time zone for the user.
-
Currency: Default currency for the user.
-
Synchronize roles: Enable to update all roles of the current user based on the roles present in the integration group.
Note
If multiple groups have different roles and departments and a user in more than one group, the user receives all departments and roles defined in those groups.
-
-
A window will pop up with several options for the synchronization.
Note
Users in the connected groups are automatically created in Emply People.
-
To enable calendar synchronization:
-
Enable to sync users' Outlook calendars with Emply People.
-
Optionally enable Always share dates and titles with team members to activate sharing for all calendars and set it as a default for new calendars.
-
Click to enable one-way synchronization from Microsoft Entra ID to Emply People.
-
-
Go to your user settings in Emply People.
-
Open Calendar settings and press .
-
Login with your Global Administrator Account.
-
Review the permissions and enable Consent on behalf of your organization and click .
-
Select the calendar you want to sync and click .
-
After synchronization completes, Emply People automatically adds calendars for all users.
-
Share dates and titles with your team: Must be enabled by each user to allow other user stories view calendar details.
-
Synchronize events with this calendar: Enable to keep events in sync. Users outside your team will see Busy without titles/details if sharing is not enabled.
Important
Emply People can create absences in the calendar but cannot update existing absences.
-
Add meeting rooms: Go to + and click to edit the setup. Meeting rooms must be created as User type in Microsoft Entra ID to be added. Rooms created as Resource type cannot be added.
-
-
Enable two-way synchronization from Emply People to Microsoft Entra ID:
-
: Create users from Emply People in Microsoft Entra ID.
-
: Update Microsoft Entra ID users with changes from Emply People.
-
: Delete Microsoft Entra ID users when they are deleted in Emply People.
Note
If Create or Update is enabled, a Map Fields button appears for mapping Emply People elements to Microsoft Entra ID properties. No fields are mandatory - unmapped elements will be updated with null. Click when finished.
-
-
Synchronize profile pictures: By enabling Create and/or Update, a profile pictures can be synchronized from Emply People to Microsoft Entra ID.
Important
Synchronization from Microsoft Entra ID to Emply People is not supported here.
Overview of Synchronized Data
Note
For hybrid setups and FAQ, refer to the companion FAQ articles in the same Users and calendars section.
When a user is synchronized with an employee, updating an existing user from Microsoft Entra ID to Emply People will only update: First name, Last name, Job title, and Mobile phone number. To update other information: enable in the integration setup and ensure the fields are mapped. Below is an overview of the data that is being synchronized.
Table 3. Synchronized Data Table
|
Microsoft Entra ID |
Emply People |
Comments |
|---|---|---|
|
First name |
First name |
Only when defined in Microsoft Entra ID |
|
Last name |
Last name |
Only when defined in Microsoft Entra ID |
|
|
|
Only when not defined in Microsoft Entra ID |
|
User Principal Name |
Username |
Only when not defined in Emply People |
|
MobilePhone |
MobilePhone |
Only when defined in Microsoft Entra ID |
|
MainGroupID |
Department |
Default department ID from found Microsoft Entra ID group. Otherwise default department ID from Microsoft Entra ID integration. |
|
Job Title |
Job Title |
Only when defined in Microsoft Entra ID |
|
MainGroupID |
Language |
Default language from found Microsoft Entra ID group. Otherwise default language from Microsoft Entra ID integration. |
|
GroupId |
Roles |
If Synchronize roles is disabled and there are old roles, then old roles are used. Roles are taken from default role ID from found Microsoft Entra ID group or default role ID from Microsoft Entra ID integration. |
|
MainGroupId |
Time Zone |
Default time zone from found Microsoft Entra ID group. Otherwise default timezone from Microsoft Entra ID integration. |
|
MainGroupId |
Currency |
Default currency from Microsoft Entra ID group found. Otherwise default currency from Microsoft Entra ID integration. |