Skip to main content

Datacurso webservice setup

The Datacurso webservice setup allows you to automatically configure the web service required for Datacurso AI plugins to securely access contextual information from your Moodle site.

This configuration enables Moodle to share course and activity data with Datacurso AI services in a secure way.

⚠️ Important​

Without completing this setup, the following Datacurso AI plugins will not function correctly:

Make sure the configuration status shows green (Success) before using these plugins.

Access to Datacurso webservice setup​

To configure the web service:

  1. Go to Site administration > Server > Datacurso webservice setup.

    Datacurso Webservice Setup

Current configuration status​

The page displays the current status of all required components.

Webservice Status

Each item may appear as:

  • Red – The component is not configured or not enabled.
  • Green (Success) – The component is correctly configured.

⚠️ Not all items will necessarily appear in red.
Some components may already be configured in your platform.

The setup is complete when all required items appear in green (Success).

The system checks:

  • Web services enabled
  • REST protocol enabled
  • Service user
  • Service role
  • Role assigned to user
  • External service
  • Token exists
  • Registration status

If any required item is not configured, click Configure webservice to automatically complete the setup.

What happens when you click "Configure webservice"​

When you click Configure webservice, Moodle automatically:

  • Enables Web services and REST (if needed)
  • Creates or reuses the user datacursows
  • Creates or reuses the role Datacurso web service
  • Assigns that role at system level to the service user
  • Creates or reuses the external service Datacurso web service
  • Adds the required web service functions
  • Generates (or reuses) a secure token
  • Registers the site with Datacurso

Role capabilities configured​

The setup creates (or updates) the role Datacurso web service and assigns it to the service user.

This role includes the following permissions:

  • webservice/rest:use
  • moodle/category:viewhiddencategories
  • moodle/course:enrolreview
  • moodle/course:view
  • moodle/course:viewhiddencourses
  • moodle/course:viewhiddensections
  • moodle/course:viewparticipants
  • moodle/course:viewhiddenactivities
  • mod/forum:viewdiscussion
  • mod/forum:viewqandawithoutposting
  • mod/wiki:viewpage
  • mod/glossary:view
  • mod/book:read
  • mod/lesson:view
  • mod/choice:choose
  • mod/choice:readresponses
  • mod/feedback:view
  • mod/feedback:viewanalysepage
  • mod/scorm:viewreport
  • mod/scorm:viewscores
  • mod/h5pactivity:view
  • mod/h5pactivity:reviewattempts
  • mod/resource:view
  • mod/page:view
  • mod/assign:view
  • mod/assign:viewgrades
  • mod/data:viewentry
  • mod/data:view
  • mod/folder:view
  • mod/label:view
  • mod/url:view
  • mod/workshop:view

These permissions allow the AI service to securely read course and activity information required to generate contextual responses.

Web service functions enabled​

The following Moodle web service functions are added to the Datacurso web service:

  • core_course_get_contents
  • core_course_get_courses_by_field
  • mod_forum_get_forums_by_courses
  • mod_forum_get_forum_discussions
  • mod_forum_get_discussion_posts
  • mod_wiki_get_wikis_by_courses
  • mod_wiki_get_subwikis
  • mod_wiki_get_subwiki_pages
  • mod_wiki_get_page_contents
  • mod_wiki_get_subwiki_files
  • mod_glossary_get_glossaries_by_courses
  • mod_glossary_get_entries_by_search
  • mod_glossary_get_entry_by_id
  • mod_book_get_books_by_courses
  • mod_lesson_get_lessons_by_courses
  • mod_lesson_get_pages
  • mod_lesson_get_page_data
  • mod_choice_get_choices_by_courses
  • mod_choice_get_choice_options
  • mod_choice_get_choice_results
  • mod_feedback_get_feedbacks_by_courses
  • mod_feedback_get_items
  • mod_feedback_get_finished_responses
  • mod_feedback_get_analysis
  • mod_scorm_get_scorms_by_courses
  • mod_scorm_get_scorm_scoes
  • mod_scorm_get_scorm_user_data
  • mod_scorm_get_scorm_sco_tracks
  • mod_h5pactivity_get_h5pactivities_by_courses
  • mod_h5pactivity_get_attempts
  • mod_h5pactivity_get_results
  • mod_resource_get_resources_by_courses
  • mod_resource_view_resource
  • mod_page_get_pages_by_courses
  • mod_assign_get_assignments
  • mod_assign_view_assign
  • mod_assign_get_submission_status
  • mod_data_get_databases_by_courses
  • mod_data_get_entries
  • mod_data_get_fields
  • mod_folder_get_folders_by_courses
  • mod_folder_view_folder
  • mod_label_get_labels_by_courses
  • mod_url_get_urls_by_courses
  • mod_url_view_url
  • mod_workshop_get_workshops_by_courses
  • mod_workshop_view_workshop
  • mod_workshop_get_submissions

These functions allow Datacurso AI to retrieve structured course data needed to improve contextual responses.

Buttons available​

Webservice Buttons

  • Configure webservice – Runs the full automatic setup.
  • Retry – Attempts to resend the registration if it failed.
  • Regenerate token – Creates a new token and updates the registration.

Live activity log​

During the setup process, a live log shows each step being executed.

Webservice Log

Successful configuration​

When everything is configured correctly:

  • All required status indicators appear in green (Success).
  • The registration is verified.
  • The web service is fully operational.

Webservice Success