Applicable Product:

Peoplefluent Learning

Applicable Release:

All

Summary:

AICC courses, built to comply with the Aviation Industry Computer-Based Training Committee standards, are widely used for eLearning content delivery and tracking. Despite their robustness and interoperability, users and administrators may sometimes encounter issues when deploying or running AICC courses. This guide covers common problems and straightforward troubleshooting steps to help you resolve typical AICC course issues.

Detailed Information:

Common Issues with AICC Courses

1. Course Fails to Launch
2. Progress or Scores Not Reporting to LMS
3. Communication Errors Between Course and LMS
4. Content Display Problems
5. Session Timeout or Data Loss
6. Incompatible Browser or LMS Issues

Basic Troubleshooting Steps

1. Check LMS and Course Compatibility

• Ensure your LMS supports AICC standards. Most modern LMSs support AICC, but some might have deprecated it.
• Confirm that the course package follows AICC specifications — especially the presence and correctness of the .au file and the course structure.

2. Verify Launch URL and Parameters

• AICC courses are launched through URLs with parameters sent by the LMS.
• Verify the launch URL is correct and includes all required AICC parameters (such as aicc_sid, aicc_url, aicc_command).
• Incorrect or missing parameters can prevent the course from initializing properly.

3. Inspect Communication Between Course and LMS

• AICC courses communicate with the LMS via HTTP POST or GET commands.
• Check if your browser or network security settings (firewalls, proxies) are blocking these communications.
• Use browser developer tools or network analyzers (e.g., Wireshark) to inspect requests and responses.
• Look for HTTP errors (like 404 or 500) on the communication URLs.

4. Confirm Course Files Are Properly Uploaded

• Verify that all course files, including the .au file and all HTML, media, and script files, are correctly uploaded to the LMS or web server.
• Missing or corrupted files can cause display or launch failures.

5. Test on Different Browsers and Devices

• Some browsers may handle AICC communication or content differently.
• Test the course on multiple browsers (Chrome, Firefox, Edge) to rule out browser-specific issues.
• Ensure your browser is up to date and supports the features used by the course.

6. Check Browser Security Settings

• Modern browsers may block mixed content (HTTP content on HTTPS sites) or restrict cookies and cross-origin requests.
• Configure LMS and course delivery to use HTTPS to avoid mixed content errors.
• Adjust browser settings or whitelist LMS and course URLs if necessary.

7. Look for JavaScript Errors

• Use browser developer tools to check the console for JavaScript errors.
• Errors in course scripts can halt course execution or data reporting.

8. Validate User Permissions and Accounts

• Ensure the learner has the proper permissions and is correctly enrolled in the course.
• User account or enrollment issues may prevent course launch or progress reporting.

9. Clear Cache and Cookies

• Sometimes cached files or cookies cause unexpected behavior.
• Clear browser cache and cookies and retry launching the course.

10. Review LMS Logs and Course Logs

• Many LMS platforms provide logs of course launches and tracking data.
• Review logs to identify errors or communication failures.
• Some AICC courses also generate client-side logs — check these if available.

When to Escalate

If the basic troubleshooting steps do not resolve the issue:

• Contact your LMS support team with detailed error descriptions and logs.
• Reach out to the course content vendor or developer.
• Check for updates or patches for both LMS and course content.

Best Practices to Prevent Issues

• Always test AICC courses on the target LMS before full deployment.
• Keep LMS and browsers updated to support current standards.
• Use HTTPS consistently for secure communication.
• Regularly review and update course packages for compliance.
• Provide learners with guidance on compatible browsers and settings.