Who can use this feature?
|
The HRIS connector administrator panel allows you to:
- View the daily synchronization results of your HRIS connector.
- Download all the synchronization logs of your HRIS connector. The synchronization logs provide actionable information about errors occurring during the connector initialization or the processing of the user provisioning CSV file.
For more information on the user synchronization performed by the HRIS connector, see Synchronize users from your HRIS.
View the daily synchronization results
- In the left sidebar, click on the platform group (with the golden crown at the bottom right of its icon).
- At the top right, click
Settings.
- In the left sidebar, click
Integrations.
- Select the HRIS connector.
The connector administrator panel displays the following information:
- Last connector sync: The date of the last synchronization.
- Created users: The number of users created on the 360Learning platform during the last synchronization.
- Updated users: The number of users updated on the 360Learning platform during the last synchronization.
- Duplicated users: The number of users duplicated during the last synchronization. Duplicated users are not created or updated on the 360Learning platform.
- Ignored users: The number of users ignored during the last synchronization. Ignored users are not created on the 360Learning platform.
- Archived users: The number of users archived on the 360Learning platform during the last synchronization.
- Users matching no group rules (Only with the Advanced Group Synchronization feature): The number of users that have not been assigned to a 360Learning group during the last synchronization.
Download the synchronization logs
You can download detailed information on the synchronization execution results, including the reason for the execution failure and the list of users ignored, duplicated, and matching no group rules.
- In the left sidebar, click on the platform group (with the golden crown at the bottom right of its icon).
- At the top right, click
Settings.
- In the left sidebar, click
Integrations.
- Select the HRIS connector.
The HRIS connector administrator panel opens. - Click See all syncs.
The All synchronizations dialog box opens with the list of synchronization logs. Each line corresponds to the synchronization of one CSV file. - (Optional) At the top right, click
Filter to filter by synchronization status:
- Successful: The synchronization was executed without errors.
- Successful with error(s): The synchronization was executed with some errors.
- Failed: The synchronization failed to execute.
- Running: The synchronization is still running.
- Select the check box on the left of the synchronization log you want to download.
- Click EXPORT.
To ensure the synchronization log is completely downloaded, do not close your browser while the file is being downloaded.
Each synchronization log displays the detailed synchronization execution results for one CSV file, with the following properties in JSON format:
Property | Type | Required | Description |
Date |
String | Yes | Date and time of the start of the synchronization, expressed in ISO 8601 format — example: 2022-05-16T22:00:00.000Z . |
endDate |
String | Yes |
Date and time of the end of the synchronization, expressed in ISO 8601 format — example: |
status |
String | Yes |
Status of the synchronization:
|
logs |
Array | No |
Reason for the synchronization failure. |
numberOfCreatedUsers |
Integer | Yes |
Number of users created on the 360Learning platform. |
numberOfUpdatedUsers |
Integer | Yes |
Number of users updated on the 360Learning platform. |
numberOfArchivedUsers |
Integer | Yes |
Number of users archived on the 360Learning platform. |
numberOfDuplicateUsers |
Integer | Yes |
Number of users duplicated. Duplicate users are not created or updated on the 360Learning platform. |
numberOfIgnoredUsers |
Integer | Yes |
Number of users ignored. Ignored users are not created on the 360Learning platform. |
numberOfNoGroupsMatchUsers |
Integer | No |
(Only with the Advanced Group Synchronization feature) Number of users that are not assigned to a 360Learning group because they do not match any group assignment. |
duplicateUsers |
Array | Yes |
List of duplicated users, with the following attributes:
|
ignoredUsers |
Array | Yes |
List of ignored users, with the following attributes:
|
noGroupsMatchUsers |
Array | No |
(Only with the Advanced Group Synchronization feature) List of users that are not assigned to a 360Learning group, with the following attributes:
|
Errors and warnings during the synchronization
Initialization errors
When an error occurs during the connector initialization and prevents the processing of the CSV file, the synchronization log contains a logs
array with the reason for the synchronization failure.
Below is a table with logs
examples and the corresponding description.
logs examples |
Description |
“logs” : [ “Connection to the SFTP server failed” ] |
The synchronization failed to execute because of one of the following reasons:
The synchronization is stopped and will be retried the next day. |
“logs”: [ File encoding is not supported for hrisBadEncoding.tsv, please make sure the file is encoded using UTF-8”] |
The CSV file is invalid because of bad encoding. The CSV file must be UTF-8 encoded. |
“logs” : [ “File is empty” ] |
The CSV file does not contain any user data. |
“logs” : [ Required fields are missing from the CSV header: myEmail”] |
Required fields are missing in the headers of the CSV file. To view the fields required for the effective processing of user provisioning data, see Synchronize users from your HRIS. |
“logs” : [ “File contains no data”] |
The CSV file only contains headers. |
“logs” : [ “The following fields are mentioned more than once in
the file headers: email, lastName”] |
Some fields in the header of the CSV file are duplicated. |
The following is an example of a synchronization log where the synchronization failed because of a missing required field in the CSV file:
{
"startDate": "2023-08-02T12:28:37.264Z",
"endDate": "2023-08-02T12:28:42.506Z",
"status": "Error",
"logs": [
"Required fields are missing from the CSV header : uniqueId"
],
"numberOfCreatedUsers": 0,
"numberOfUpdatedUsers": 0,
"numberOfArchivedUsers": 0,
"numberOfDuplicateUsers": 0,
"numberOfIgnoredUsers": 0,
"numberOfNoGroupsMatchUsers": 0,
"duplicateUsers": [],
"ignoredUsers": [],
"noGroupsMatchUsers": []
}
Processing errors
When an error during the processing of some user data does not prevent the processing of the CSV file, the synchronization log contains the list of users ignored, duplicated, and matching no group rules with an error message.
The following is an example of a synchronization log where one user could not be created:
{
"startDate": "2023-04-26T07:08:20.035Z",
"endDate": "2023-04-26T07:08:21.962Z",
"status": "Warning",
"numberOfCreatedUsers": 4,
"numberOfUpdatedUsers": 0,
"numberOfArchivedUsers": 0,
"numberOfDuplicateUsers": 0,
"numberOfIgnoredUsers": 1,
"numberOfNoGroupsMatchUsers": 0,
"duplicateUsers": [],
"ignoredUsers": [
{
"id": "5",
"email": "",
"firstName": "test",
"lastName": "test",
"errorMessage": "No email provided"
}
],
"noGroupsMatchUsers": []
}