When setting up your integration, you can decide what should be updated every time the integration syncs and what should not. This is done using settings.
Before delving into the settings, it's important to understand the following:
If no data is retrieved from the integration, your user will be assigned the default from your platform.
To set up your integration yourself in the integration hub, we recommend reading this article: Integration Hub: Integrate with Learningbank. Here, you will get to know how to set up the integration step by step and also become familiar with things to look out for, such as exclude and include lists.
Now, let's explore the settings!
Change job profile
Enabled: When you enable the job profile, the platform syncs data from your integrated system (like your HR system or Active Directory). This means that when the data updated is updated in your integrated system it'll automatically be updated in your platform, keeping both systems in sync.
Disabled: If the job profile is disabled, the platform will still pull data from your external system, but you can update it manually. So if the job profile is disabled, the integration won't automatically make updates. This option is useful if you if the data in your integrated system isn't well-organized.
This settings are enabled by default
Change permissions
Default: Managing permissions within the platform is crucial for controlling user access. By default, this setting is disabled to ensure that the users in the platform retain their assigned permissions without overwriting them from the external system. Enabling this setup allows for the synchronisation of permission types (or user types).
Enabled: This setup is particularly useful when the integrated system has its own set of user types/permissions that need to be mirrored in the platform. It is worth noting that enabling this setup and syncing permissions for users will create permissions with identical names to those in the integrated system but with basic settings in the platform. Therefore, we recommend that you adjust the permission types afterwards as needed.
This setting is disabled by default
❗If you enable this setting: During the synchronisation, it is crucial to put any administrator on the exclude list if they also exist in the integrated system you do this under the "Users" tab in the integration. This prevents the overwriting of administrator permissions, ensuring that users with administrator privileges are not affected.
Automatically Update Permissions: Best Practice
We recommend only having permission types you actually use in the platform for an easy overview.
The most common permissions on the platform are user (Default), administrator (platform owner), manager, and content creator. Therefore, it is advised that you narrow down the field you use to these (you can have more if you wish). When that is done, you can start with the steps below, if the field you use does not match the default one, we map it to.
Allocate a text field in the integrated system for us to retrieve and map permissions.
To ensure successful mapping, ensure that the permission names in your platform and the integrated system's text field match precisely.
For scalability, limit the number of permissions used in your platform.
Ensure all desired permissions are pre-created in your platform.
If not already done, expose the field through your integrated system's API.
Provide us with the allocated field ID from the integrated system.
With this information, we can efficiently help them map permissions.
Change departments
Enabled: Departments are crucial for the setup of the platform to ensure that users can see and interact with the correct users and departments, following the waterfall structure. This setup is enabled by default, where it overrides the departments assigned to a user in the platform with the departments assigned in the external system. This setup is useful when the external system incorporates the use of departments that need to be consistent with the ones in the platform.
Disabled: If the setting is disabled, the users from the external system will retain the department assigned to them in the platform. If the user does not exist on the platform, they will be created by the department of the external system.
This setting is enabled by default
❗It is important to note that synchronising with an integrated system does not automatically create the departmental waterfall structure (hierarchy). That must be done manually with the parent department directly under the department tab. After the waterfall structure has been created manually, it will stay this way.
If you wish to have your department structure hierarchically by default, we must create a hierarchy department integration, customised for you.
Reach out to your Customer Success Manager or [email protected] to initiate this, and be informed that it comes with a cost. For organisations with fewer than 30 departments, you most likely can handle this manually as a one-time setup.
Deactivate users
Default: To facilitate both integration and manual user uploads, it's essential to keep the "Deactivate users" setting disabled. This set up is commonly used for consultants or external personnel requiring training access and is not included in the integrated user management system. In this case, we recommend also setting up user automation to ensure users from the integration are deactivated and that you comply with GDPR.
Enabled: Enabling this setup guarantees automatic deactivation of users once they are removed from your user management system. This is commonly used when incorporating the user's last day into the integration, allowing for automated deactivation.
This setting is disabled as the default
❗If enabled, any users who have been manually created in the platform need to be excluded under the "Users" tab or whole departments on the "Departments" tab. If they are not excluded, they will be considered as not being part of the external system and, therefore, deactivated.
Create job profile, permissions or departments
Enabled: When you enable the creation of job profiles, permissions or departments, the platform will sync data from your external system. This means that if a user has e.g. a job profile that is currently not created on your platform, it will automatically create it.
Disabled: If job profiles, permissions, or departments are disabled, no job profiles, permissions, or departments will be created automatically. Users will still be assigned e.g. a job profile automatically if the job profile exists in the platform. However, if the job profile does not exist, the user will instead get assigned the default.
Use case: This setting is useful for deactivating users if you want complete control over which job profiles, permissions, or departments are created in the platform. It allows you to manually create and delete these without the integration creating or updating them automatically.
Enabling and Disabling of synchronisation
Enabled: When you enable the synchronisation of an integration, it will automatically sync data from your external system. It considers the different settings that have been set alongside the exclusion and inclusion of users and departments. It is useful to have the synchronisation enabled, as it will automatically create and update data based on the settings chosen.
Disabled: When you disable synchronisation, the platform will not pull data from your external system until you turn it on again. Disabling synchronisation also provides multiple benefits. For example, if changes in the organisational structure require manual work and changes in settings, this can then act as a pause in the integration until everything is set up. It is also useful when setting up a new integration.
Quick tip💡
When enabled, the integration runs a synchronisation about every 4 hours.
This setting is disabled as the default