In this guide:
Moodle Direct V1 users use both the Direct V1 and V2 plugins for assignments at the same time. We have provided the original documentation on how to migrate your Direct V1 assignments to Direct V2 assignments. However, since the push for the Direct V1 to V2 migration occurred several years ago, it’s possible these directions may not work as expected with newer versions of Moodle and the Direct V2 plugin. If you encounter this problem, the only way to proceed is to create new V2 assignments to replace the old V1 assignments.
Accessing the Moodle Migration Tool
- From Moodle, select Site administration and select the Plugins option.
- Select Plugins overview to view a list of your installed plugins.
- Find Turnitin Assignment 2 (this is the Moodle Direct V2 plugin) in the list and select Settings.
- To access the Moodle Migration tool, select the V1 Migration tab.
If you are using newer versions of the Direct V2 plugin, it is possible that this tab is no longer available. If that is the case, there is no migration pathway for your Direct V1 assignments. Those assignments will need to be recreated as Direct V2 assignments.
If you do see this tab, once you have performed the migration you will need to update your Direct V2 integration to the latest version.
- The Moodle Migration tool will be disabled by default. Use the dropdown menu to enable the tool, allowing your instructors to start the migration of Direct V1 assignments.
Disable migration makes the Direct V1 to Direct V2 migration unavailable to your instructor.
Prompt instructor at launch gives instructors the option to migrate an assignment from Direct V1 to Direct V2 upon access to the Direct V1 assignment. This prompt will be displayed to anyone with grading permissions in Moodle, therefore, classed as an instructor within Turnitin.
Automatic at launch will perform the migration when an instructor accesses a Direct V1 assignment. - Select Save changes.
Deleting migrated assignments
You cannot delete Direct V1 assignments that have not yet been migrated. The checkbox to select and delete a Direct V1 assignment will only be made available after migration.
- Use the checkboxes to select the Direct V1 assignments that have already been migrated to Direct V2.
- Select the Delete Selected button to permanently remove the migrated Direct V1 assignment.
Locating assignments to delete
Use the search box to search for specific assignments to check their migration status.
To view a specific number of assignments within the search results page, select a value from the Show X entries dropdown menu. Alternatively, move from page to page using Previous, Next and page number links.
Frequently asked questions
- What if my Direct V1 and Direct V2 plugin settings differ?
- What if the account ID and secret key in my V1 and V2 plugin settings differ?
- Why can't Direct V1 assignments be migrated in bulk?
- What if a migration fails?
- Who will receive a prompt to migrate?
- When is it safe to remove the Direct V1 plugin from my Moodle environment?
- Can I create Direct V1 assignments if my institution is in the process of migrating to Direct V2?
- How does this migration affect assignments in Turnitin?
What if my Direct V1 and Direct V2 plugin settings differ?
If a feature is enabled in Moodle Direct V1 but disabled in Direct V2, the assignment will still migrate to Direct V2 regardless of this difference. For example, if anonymous marking is enabled in Direct V1 but disabled in Direct V2, this feature may become unavailable within the migrated assignment. We strongly recommend that you align your plugin settings before migration to prevent any unintended loss or accrual of features. Please communicate this to your users.
What if the account ID and secret key in my V1 and V2 plugin settings differ?
For a migration to complete successfully, the account ID and secret key in your Direct V1 and Direct V2 plugin settings must match exactly.
Why can't Direct V1 assignments be migrated in bulk?
Each Direct V1 assignment must be assessed individually before being migrated to Direct V2. Some Direct V1 assignments may still be accepting submissions, removing the option of bulk migration. Additionally, there may be instructors still grading Direct V1 assignments.
Administrators can track the progress of their migration efforts within the Moodle Migration Tool.
What if a migration fails?
The assignment will stay as or revert back to a Direct V1 assignment and the instructor will be directed to their Direct V1 assignment inbox. Upon accessing the Direct V1 assignment for a second time, the assignment will either migrate automatically or give the instructor the option to migrate, depending on your migration settings.
Who will receive a prompt to migrate?
If you've selected “Prompt instructor at launch” in the Moodle Migration Tool, the prompt will be available to anyone with a grading right in Moodle, and therefore, classed as an instructor with Turnitin.
When is it safe to remove the Direct V1 plugin from my Moodle environment?
It is safe to remove the Direct V1 plugin after completing the following steps:
- Ensure all Direct V1 assignments have migrated to Direct V2.
If you remove the Direct V1 plugin before the intended migration of any Direct V1 assignments, you will lose access to these assignments. You must migrate all Direct V1 assignments before removing the Direct V1 plugin if you would like to continue accessing them.
- To ensure your assignment lists include Direct V2 only, delete all migrated Direct V1 assignments using the Moodle Migration Tool.
Cleaning up your assignment lists removes any assignments that will no longer be accessible once the Direct V1 plugin is removed from your Moodle environment.
Can I create Direct V1 assignments if my institution is in the process of migrating to Direct V2?
We recommend only creating Direct V2 assignments at this stage. If you have the “automatic at launch” option configured, a Direct V1 assignment will be migrated almost immediately after creation, which is likely to cause confusion among your instructors. Creating a Direct V2 assignment will alleviate this confusion.
How does this migration affect assignments in Turnitin?
By migrating a Direct V1 assignment to Direct V2, the same assignment in Turnitin will remain unaffected, even after the Direct V1 assignment is deleted from Moodle. Additionally, the assignment ID will remain the same after its migration to Direct V2.