Pre-Upgrade Information

The instructions provided in this section relate to upgrading the Base Application, SuMo, from v5.56.x to 6.24.x and the Motivate Extension Package from Version 1.12 to 2.0. Installations on any SuMo version below v5.56.x, must first upgrade to the latest v5 release (see Note below for specific version details) before starting the upgrade process. Failure to do so may result in an incomplete or incorrectly configured installation.

...

Pre-Upgrade checks

Ensure that all Targeted Competitions have Finished before beginning the upgrade process. Finished and Declared competitions will be set to Archived (note that the competitors' scores and rank positions will be retained and reward records will not be deleted, but they will not benefit from the new v6 features which associates Rewards earned with the Competition from which they were derived).

...

Batch Assessment Achievements are being deprecated in this release. Therefore, Achievements set to "Every time the Object's Batch Assessment is run" should be replaced with Scheduled Achievements before upgrading.

Automated Upgrade

Upgrade the Base Application

To upgrade the Motivate base app from version 5 to version 6, there are two phases prior to continuing with the Post-Upgrade Steps: Upgrade to v6.24.12 followed by Upgrade to the Version 6 Release 4 package.

...

1. Select the Install for Admins Only radio button
2. If you would like to see the full details, click on the View Components and API Access links at the bottom of the screen.
3. Click the Upgrade button:
   
   The upgrade usually takes several minutes to complete, and you will typically see a message indicating this. In these circumstances you will receive an email notification message once the upgrade has completed.
4. Repeat the above steps in order to upgrade to the SuMo for Salesforce Version 6 Release 4 package.

Upgrade Motivate

You should have already been provided with a URL for upgrading the Motivate extension package. Please contact NewVoiceMedia if you have not received this.

...

Once the upgrade has completed, you will be able to continue with the Post-Upgrade Steps.

Post-Upgrade Steps

Prior to using the product, it is necessary for a System Administrator to customise certain aspects of the application that cannot be done automatically during the package upgrade. The steps are necessary due to the changes that have been introduced in this version.

Automated Setup

To automatically set up items that cannot be carried out by the Salesforce update process:

...

Update Seed Data

The Seed Data has been modified for Version 2, and the Version 1 Seed Data will need to be overwritten to benefit from new functionality introduced.

...

Motivate App tabs

If any of the Motivation Designers have customised their own Motivate Application tabs, they will not see the tab updates that were deployed by the Automated Setup routine (performed above). As a consequence they will not see either the Competitions or Experience Tabs and will instead see a Collectives tab. We therefore recommend that the following steps to overwrite their custom tabs should be performed; each user will then need to customise their tabs again, if required.

1. Within the sidebar select Build | Create | Apps
2. Click Edit next to Motivate
3. Select the Overwrite Users' Personal Custom App Customizations checkbox:
   
4. Select which Profiles the tabs should be assigned to
5. Click Save

Anchor
_customtabs _customtabs

Custom Tabs

Follow these steps to update the tab styles used within the Motivate app, as they cannot be updated during the upgrade process. Updating the tab styles will ensure that the tabs display correctly in both the Salesforce Classic UI and the Lightning Experience user interface.

Custom Object Tabs

1. Within the sidebar select Build | Create | Tabs
2. Under the Custom Object Tabs section, click Del in the Action column to delete the Challenges and Competition Performance tabs
   
3. Click Edit next to Base Behaviours
4. Next to Tab Style click the Lookup button
5. Click on the style Star
6. Click Save
7. Repeat steps 3-6 for the remaining tab styles as follows:
   • Collectives - change to style Hexagon
   • Graphics - change to style Camera
   • Player Performance - change to style Measuring Tape
   • Rewards - change to style Ticket
8. The Custom Object Tabs section should now be as follows:
   

Web Tabs

1. Under the Web Tabs section, click Edit next to Gallery
2. On the next screen, leave the 2 columns with salesforce.com sidebar option selected, click Next
3.  From the Tab Style lookup, select Jewel
4. Click Next
5. Click Save
   

Visualforce Tabs

1. Under the Visualforce Tabs section, click Delete next to Objectives
2. As within the Custom Object Tabs section above, edit the following 4 styles:
   • Administration - change to Wrench
   • Launch Inspire - change to TV Widescreen
   • Motivate (the second one in the list) - change to People
   • Motivate1 - change to People
3. The Visualforce Tabs section should now be as follows:
   

Motivation Designer - Supplementary Permission Set

The "Motivation Designer (Supplementary)" permission set requires one additional record type permission that cannot be assigned automatically during the Upgrade process.

1. In the Salesforce Setup, within the sidebar navigate to Administer | Manage Users | Permission Sets
2. Click on the Permission Set name Motivation Designer (Supplementary)
3. Click on the Object Settings link
4. Click on the Collectives object name
5. Click Edit and, under Collective: Record Type Assignments add Template to the assigned record types (Competition and Experience Group should already be assigned; if they aren't, then please also assign these now):
   
6. De-select the Objective record type (this is no longer required)
7. Click the Save button

Object Page Layouts & Assignment

Collectives page layout

1. In Salesforce Setup, within the sidebar select Build | Create | Objects
2. Click on the Collective link
3. Go to the Page Layouts section and click the Page Layout Assignment button
4. Click the Edit Assignment button
5. Select all the items in the Experience Group column:
   
6. Select Experience Group Layout from the Page Layout To Use picklist
7. Click Save

Behaviours Page Layout

To prevent saving Behaviour records without a linked Base Behaviour (which will ensure data integrity):

1. Within the sidebar select Build | Create | Objects
2. Click on the Behaviour link
3. Go to the Page Layouts section and click Edit next to the Team Achievement Layout page layout
4. Click the Properties icon (spanner) beside the Base Behaviour field and select the "Required" checkbox
   
5. Click OK
6. Click Save

Base Behaviour Page Layout

1. Within the sidebar select Build | Create | Objects
2. Click on the Base Behaviour link
3. Go to the Field Sets section and click Edit next to the Information field set name
4. Move the Undesirable field from the end of the list, to between Channel and Experience Group and move Comments to the end of the list as shown in the screenshot below
   
5. If the Promoted field is within this Field Set, we suggest removing it. The Promoted value is best set on the Behaviour itself (with the default always starting as un-promoted).
6. Click Save

Player Performance page layout

1. Within the sidebar select Build | Create | Objects
2. Click on the Player Performance link
3. Go to the Page Layouts section and click the Page Layout Assignment button
4. Click the Edit Assignment button
5. Select all the items in the Page Layout column:
   
6. Select Performance Layout from the Page Layout To Use picklist
7. Click Save

User page layout

1. Within the sidebar select Build | Customize | Users | Page Layouts
2. In the User Page Layouts section, click on the Edit link next to the Page Layout Name for the layout assigned to Users that have been set up as Motivate Users
3. Scroll down to the Motivate section
4. Remove any of the Deprecated fields that are on the page, ie:
   • Level - DEPRECATED
   • Experience - DEPRECATED
   • Last Game Reset - DEPRECATED
   • Set Id - DEPRECATED (this may not be on the page layout
5. Repeat steps 2-4 for any other User Page Layouts, if required

Subtab App

1. Within the sidebar select Build | Create | Apps
2. Under the Subtab Apps section, click Edit next to Profile (Self)
3. In the Selected Tabs list, select Challenges and remove it (so that it appears in the Available Tabs list)
   
4. Click the Save button to complete the task and save your changes

Post-Upgrade configuration

Leaderboard Trends & Performance History

If "Leaderboard Trends" were enabled in version 1, they will need to be re-enabled following the upgrade. A new combined function ("History & Trend Frequency" available on the Administration Tab) now also records each Player's score in order to populate their Performance History Chart with historical performance data. This function was performed separately in version 1, but has now been incorporated into a single function in version 2 for simplicity and ease of management.

Inspire sample Channel "Motivation"

Due to the change in architecture, the sample Inspire Channel "Motivation" contains several Leaderboards that will no longer operate as they did in v1. To compensate for this version 2 includes a replacement "Performance" Channel. If the Motivation Channel was not being used, it should now be deleted as the Performance Channel provides leaderboards configured for the new architecture. If the Motivation Channel was in use then the Leaderboard configurations will need to be modified to reflect the architectural enhancements made in v2. Alternatively, our recommended approach is to re-implement any customisations into the new Performance Channel.
 
That completes the Post-Upgrade Steps for Motivate, so you're ready to go!