Migrating from legacy goals to Totara goals

If you have previously used legacy goals in Totara, you may want to migrate existing goals to the Totara goals system.

Data is not transferred between the two goal systems, so you should be cautious when switching between these tools. Examples will help to illustrate potential issues.

Example 1

A site has legacy goals enabled and legacy goals records. The Site Administrator then changes the setting to enable Totara goals. The following changes occur: 

• A different Goals landing page is displayed with Your goals tab only. 
• The Performance overview page and Goals page will not show any legacy goals.
• If an existing goal has already selected to review in a performance activity, they will still be visible to users. If you have not selected any goal to review for a performance activity, users cannot add existing legacy goals to the activity.

Example 2

A site has Totara goals enabled. The Site Administrator then decides to revert to the legacy goals tool and disable Totara goals. The following changes occur: 

• The Site Administrator cannot add the Create goals element to performance activities.
• Any Totara goals that have been created will no longer be available on the Performance overview page, Goals page, or Goals details page.
• Any Totara goals will still be available in report sources and the goals that had already been added to activities will remain.

Upgrading to Totara 18

When upgrading to Totara 18, the default setting for which goals will be used depends on whether you had goals enabled previously, and whether you have existing goal records on your system. 

• If you had goals enabled and have legacy goal records, the setting will be set to Legacy goals
• If you did not have goals enabled but have existing goal records, the setting will be set to None
• If you do not have any goal records the setting will be set to Totara goals
• For new installations the default setting is Totara goals

We recommend following this process when upgrading and switching to Totara goals:

1. You may want to prompt your teams and users to complete their old goals before the switch to Totara goals.
2. Identify and make a note of all performance activities that use legacy goals as a review element. 
3. Once you've enabled Totara goals, clone these performance activities and replace the legacy goal review element with the Totara goal review element.
4. Check the instance creation settings and the assigned audiences, then activate the performance activities.
5. Create any additional performance activities or clone and modify existing performance activities to include Create goals elements.
6. Check that your site's navigation (e.g. the main menu or quick-access menu) allows users to navigate to the new Goals page, and the Performance overview page (if required).
7. Create any reports you require for Totara goals.