There are a few reasons why a user account may be un-enabled/disabled either as a one-off or periodically. In this article, we'll share steps to help you find out why this might be the case for a User in your Learn LMS.
If your site has an automated People-data feed configured, then this report is your key troubleshooting tool.
As always, if you don't find the answer you need from this article, please contact the Support team for more guidance.
The key steps are:
- Review the User import report
- Check the time the feed file was processed (for maually added People-data)
- Check the file format (for maually added People-data) is correct
- Check the Users import key is unique
- Examine the Submitted File: Review the submitted file to check if the User record appears. Each User record should be unique; multiple records for the same User can cause processing issues.
- Check User's Import Key: Ensure that each User's import key is allocated uniquely. Import keys are unique and cannot be shared among multiple Users.
Review the User import report
The User import report is the first step. It summarises actions with the data feed, and where issues have occurred, it will detail exactly what they are. The most common issue is a Username that already exists or is in the wrong format.
- FInd out more about the User Import report (New reporting and analytics with Power BI)
- Find out more about the User Import report (Business Objects)
Note that this report displays only the last successfully processed file. If your People-data feed runs every day, make sure to check the report before it runs again.
Check the time the feed file was processed (for maually added People-data)
The time at which the feed file was processed is important to check. It's possible that the feed file was manually added too late, and the datafeed had already run. Take a look at:
- Upload Time: Check when the file was uploaded to Kallidus
- Processing Action Start Time: The User import report will detail this
- File Upload Completion: Ensure that the file is fully uploaded before the scheduled processing action start time. If the file hasn't completed uploading by the designated time, processing actions won't commence, and it will be logged as 'no file to process.'
Review any automated or manual upload processes to guarantee that files are uploaded in full before the set processing action starts to avoid processing issues.
Review the expected fule format What is the expected file format?
- Verify File Format: Confirm that the feed file has been submitted in the correct and expected format.
When troubleshooting, it's crucial to confirm that the feed file adheres to the expected format. Here are key considerations:
- File Type: Verify if the file is in the correct format (e.g., xlxs, csv). If uncertain about the expected file type, compare with a previously processed file or contact support for clarification.
- File Naming: Confirm that the file is named correctly in comparison to previous submissions.
- Column Order: Columns in the file must be in the correct order as expected for mapping to Learn. Any deviation will halt processing actions.
- Column Headers: Ensure that column headers precisely match the expected naming convention. Pay attention to upper and lower case usage and avoid trailing spaces at the start or end of words.
- Additional, Missing, Unexpected Columns: Check for any additional, missing, or unexpected columns in the file, as these issues halt processing actions.
Reviewing a past successfully processed file can assist in comparing and identifying any discrepancies. If changes are needed, such as adding columns mapped to Learn, contact support to discuss and agree on the necessary adjustments. Keep in mind that processing actions will not proceed as expected until revised files are fully mapped.
Check for unique User records
To troubleshoot, examine the feed file to locate the User's Username record. Follow these steps:
- Search in the Feed File: Locate the User's record in the feed file and check for the presence of their Username.
- Username Uniqueness: Ensure that the Username is unique and not assigned to any other records. A Username must be distinct and allocated to only one User. If the same Username is associated with multiple Users in the file, or if the same User appears more than once, the Import process will ignore these records. A Username must have a unique association with each User, and only one record per User should exist in the file.
- Impact of Duplicate Usernames: When a Username is duplicated for different Users or the same User is repeated in the file, Users who were previously enabled in Learn may become unenabled. The processing action cannot determine the correct User for the unique Username in such cases.
If the User's record is not found in the file:
- No Record in the File: If there is no record for the User in the file, the User's information will not be added to the LMS. If the User already existed in Learn, their User account will be unenabled, unless they are designated as a 'manually maintained user.'
- Manually Maintained Users: Users marked as 'manually maintained' do not appear in HR data files. This designation is often used for seasonal or contractual workers not directly linked to HR systems
Check the uniqueness of the User import key
Ensure that the ImportKey, which is unique to each User, is not already assigned to another User and is not listed more than once in the data feed file. Here are some considerations:
- Locate the ImportKey in the File: Verify if the ImportKey for the User can be found in the data feed file.
- Check for Duplicate Entries: Ensure that the same ImportKey is not listed more than once for the same User in the file. Duplicate entries for a User can cause processing actions to ignore these records, as the system cannot determine the correct User when faced with duplicate ImportKeys.
- Review ImportKey Across Users: Check if the same ImportKey is set against multiple Users in the file. If multiple Users share the same ImportKey, processing actions will ignore the record, as it cannot identify the correct User associated with that ImportKey.
- Manually Maintained Users: Look for the ImportKey linked to a 'manually maintained User' already present in Learn. 'Manually maintained Users' do not appear in HR data files and are often set up for seasonal or contractual workers not directly linked to HR systems.
- Consider Value Format: Remember that the ImportKey is a text field, and the value '1' is not the same as '001.' While this might not be apparent in a standard data file view, using software like Notepad++ can help visualise the details for processing actions. Ensure compliance with IT policies and seek necessary permissions before using external software
If you have checked all the things suggested in this article and still cannot identify the issue, contact Support for further guidance and assistance.
View 'Managing data and processes in Learn' in The Academy to learn more about making changes to the HR data feed, housekeeping tips and best practice and more. This is essential learning for any Learn administrator team!
Get deeper learning in The Academy
The Academy is your learning hub for Kallidus products, including live events, eLearning videos, and more. If you're new to The Academy or know someone who is missing out on free learning, contact your Customer Experience Manager or the Support Team to sign up today.
Discover the latest insights, tips and industry news on the Kallidus blog.