Moodle Integration

← Knowledge Base Homepage

← Plug-ins and Integration Homepage

← Other Plug-ins and Integration Homepage

On this page:

Using the Moodle Integration

This is a chargeable module/integration, please speak to your CSM if you would like any more information about this feature.

What does Moodle Integration do?

Classroom & Webinar Courses

The Moodle Integration will schedule Classroom and Webinar courses in your Moodle environment, and enlist your Users onto the Courses in Moodle that they have booked onto in accessplanit!

You can decide which of your class and web accessplanit courses are sent to Moodle, and which ones you manage in accessplanit only by checking a checkbox called ‘Sync to Moodle’.

Open

• If you do not enter a Moodle ID for the course once you have checked this checkbox, then your accessplanit Moodle integration will create a new course for you in Moodle. Once the Courses has been logged in Moodle, Moodle will provide your accessplanit platform with the Course Moodle ID so that the Courses is sent over again!

• If you would like to link a course in your accessplanit platform, to an existing course in Moodle, then you can add in the Course ID from your Moodle system, and your accessplanit Moodle integration will connect to that existing course instead of creating a new course for you in Moodle.

Once your accessplanit course is linked to a course in Moodle, it is ready for you to add delegates to it!

eLearning Courses

The Moodle Integration will link your accessplanit eLearning courses to your eLearning courses in your Moodle environment, and enlist your Users onto the Courses in Moodle that they have booked onto in accessplanit!

Please note that your accessplanit Moodle integration will not create eLearning courses in your Moodle system, these should already exist so that their Moodle Course ID can be added into your accessplanit platform.

You can decide which of your eLearning accessplanit courses are linked to your Moodle courses, and which ones you manage in accessplanit only by only providing the Moodle’s Course ID for the courses that you would like to link. This is set up in your accessplanit platform on your eLearning Course Templates.

Open

• If you do not enter a Moodle ID for your eLearning Course Template, then delegates that are added to this course in your accessplanit platform will not be sent to Moodle.

• If you do enter a Moodle ID for your eLearning Course Template, then delegates that are added to this course in your accessplanit platform will registered on the corresponding course in Moodle.

Once your accessplanit eLearning Course Template is linked to a course in Moodle, it is ready for you to add delegates to it!

Process flows

Here is the Course Sync Process:

Open

Here is the Delegate Sync Process:

Open

Once the Courses and Users have been logged in Moodle, Moodle will provide us with the User Moodle ID and the Course Moodle ID so that the Courses and Users are not sent over again!

Updates from Moodle

If you would like, the accessplanit Moodle integration module is also able to:

1. Send updated start and end dates/times from your accessplanit platform to your Moodle system when they are updated, keeping your courses in sync.

2. Receive the score assigned to your delegates in Moodle, please note that the delegate status cannot be received from Moodle at this time.

Please let the accessplanit team know if you would like these enabling on your accessplanit Moodle integration.

Setting up Moodle for accessplanit integration

accessplanit requires the following information from you to set up your integration with Moodle

1. Your Moodle Site's URL

2. Token

3. The Category ID to be assigned to your courses

4. The Role ID to be assigned to your delegates

Please follow these steps to gather this information:

How to set up a Moodle Token

The Token is used by accessplanit to connect to your Moodle system securely. It is the equivalent of a username and password.

1. Before you can generate the Token, you must have an admin User set up in your Moodle site who will be the authorised user for the integration, if you do not have an admin User available please see the steps in the FAQ below: How do I add a new Moodle User?
   
   

2. You then need to set up an External Service. To do this go to Site Administration > Server > Web Services > External Services
   
   

3. Click Add, provide a name for the Service i.e. 'accessplanit' and a shortname i.e. 'APIT',  and set it as enabled and for authorised users only. All other options are optional
   
   

    

   Open

   

    

4. Assign the following Functions to your External Service:
   core_course_create_courses 

   core_user_create_users

   core_course_update_courses

   enrol_manual_enrol_users
   
   

   Open

   

   
   
   

5. Assign the User created in step 1 as an Authorised user for the External Service.
   
   

   Open

   

   
   
   

6. You then need to create the Token itself, to do this go to Site Administration > Server >Web Services > Manage Tokens.
   
   

7. Click 'Create Token', select the User created in step 1, select the External Service created in step 2 and Save.
   
   You'll then have access to the Token:
   
   

   Open

   

8. Navigate back to Manage Tokens. You should now be able to generate the token as expected.
   
   

   Open

   

How to find your Moodle Category

1. You need to decide which Category in Moodle you would like all of your Courses sent from accessplanit to be added to. You can either create a new dedicated Category or you can use an existing Category.
   
   

2. You can access your Categories in Moodle by going to Site Administration > Courses > Manage Courses and Categories.

    

3. To identify the Category's ID, click to Edit it and view the URL, the category ID will be at the end of the URL. Please note that it is not the 'Category ID Number' field.
   
   

   Open

   

   
   
   

Open

How to find a Role ID

1. You need to decide which Role in Moodle you would like all of your Delegate Enrolments to be assigned. The most common option here is 'Student'
   
   

2. You can access your Roles in Moodle by going to Site Administration > Users > Permissions > Define Roles.
   
   

3. To identify the Role’s ID, click to Edit it and view the URL, the Role ID will be at the end of the URL. 

Open

How to use Moodle Integration for Classroom and Webinar courses

1. If you would like to send a course to Moodle, you need to check the Sync to Moodle box on the Course.

   Open

   

    

2. Once you click Sync to Moodle you will be able to provide your course with a Moodle ID. If you do this accessplanit will not create a new course in Moodle.
   
   

3. If you have not provided a Moodle ID,  the course will be sent to Moodle this will generate a 'Moodle ID' which will be sent back to accessplanit and stored against your course.
   
   

   Open

   

4. The following information is sent to Moodle from accessplanit:

• Course Label

• ID

• Aims text (from Course Template)

• Start Date

• Category Number

How to use Moodle Integration for eLearning courses

1. If you would like eLearning Delegates in your accessplanit platform to be automatically enrolled on your eLearning course in Moodle, you will need to make the following changes to your Course Template in accessplanit:
   
   

2. At the bottom of your Course Template details enter the Moodle ID 
   
   
   

3. You can gather the Moodle ID for the course by logging into Moodle, editing your Course, and copying the ID from the URL. Please note that it is not the 'Course ID Number' field.
   
   
   

   Open

   

How to use Moodle Integration for Users

1. When you make a booking onto a Moodle Course, either Classroom, Webinar or eLearning, the integration will first check if the User being booked onto the course has a Moodle ID yet.
   
   

2. If the User does not yet have a Moodle ID, your accessplanit platform will send their details over to Moodle. It is Moodle's responsibility to send out their new log in details for Moodle so that the User can log into their Moodle account.
   
   

3. The following information is sent to Moodle by accessplanit for new users:
   
   

   Open

   

    

4. When a User has been successfully generated in Moodle, Moodle will post back the ID of the User in Moodle into the MoodleID field within accessplanit.
   
   

   Open

   

How to use Moodle Integration for Delegates

1. When a User with a Moodle ID is booked onto a Moodle Course, your accessplanit platform will send this information to Moodle so that they are enrolled on the course:

Troubleshooting synchronising issues

Here are some common issues that we see when synchronising courses and delegates to Moodle and how to solve them!

If you are having trouble with your delegates in accessplanit sending successfully to Moodle, please check the following:

I am unable to generate a Token due to “missing capabilities"

Resolving "missing capabilities"

Occasionally, you may not be able to generate the token due to the user account "missing capabilities" . To rectify this, navigate to  Permissions > Define Roles > Add a new Role.

Open

Skip the Role Archetype section. Fill in all of the required details - give it a name such as API Role - and then tick all of the boxes next to Context types where this role may be assigned.

Open

Scroll to the bottom of the page and add any roles that are listed under the missing capabilities error message by typing them into the Filter bar and ticking the Allow box.

Open

Open

Click Create this role to save your changes

Navigate to Users > Permissions > Assign System Roles and add your accessplanit user to the role you've just created.

Open

One delegate is not sending over correctly to Moodle

No delegates are sending to Moodle

FAQs

How do I add a new Moodle User?

How to add a new Moodle User

1. To do this go to Site Administration > Users > Accounts section > Add a new user

2. Provide your user with a Username i.e. accessplanit, an Authentication method of 'Manual accounts', provide them with a Forename, Surname, and Email Address, all other options are optional

Open

Please note

If you have created a User specifically for the integration, rather than using an existing Admin, you are more likely to encounter an issue with “Missing Capabilities” when you generate the token. Please see our troubleshooting steps if you encounter this issue.

Can my accessplanit Moodle integration link a user in accessplanit to a user in Moodle based on their name or email address?

If I delete or transfer a Delegate in accessplanit will this update Moodle?

When a user completes an eLearning course in Moodle will this information be passed back to accessplanit?