Post-Upgrade Steps for Motivate

Prior to using Motivate, 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

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Installed Packages
3. Click on Configure next to the Motivate package name
4. On the Application Configuration page, expand the Installation & Upgrade section
5. Click Run next to Automated Setup and wait for the "COMPLETED" message before continuing.
   

Scheduled Jobs

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Installed Packages
3. Click on Configure next to the SuMo package name
4. On the Application Configuration page, click on the Configuration section
5. Under Scheduled Jobs, click the Run button next to Async Runner:
   

Update Apex Classes

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Develop | Apex Classes
3. Find any Apex Classes whose name starts with 'SuMo' and that was created using the Trigger Deployment Tool
4. Click the Edit button next to the Apex Class
5. After the highlighted line in the screenshot below, add the text:
   success__Status__c = 'Active',
   
6. Delete the following lines in the screenshot below:
   
7. Replace the highlighted text in the screenshot below, with the text:
   success__Behaviour_Observation__c
   

Update List Views

Base Behaviours

1. Go to Base Behaviours tab and open the All list view
2. Click Edit next to the list view
3. Select the following fields as shown in the screenshot below:
   
4. Go to Base Behaviours tab and open the Accounts list view
5. Click Edit next to the list view
6. Select the following fields as shown in the screenshot below, and then repeat for all other list views except those that start 'All'
   
7. Enter Setup by clicking on the Setup link at the top of the screen
8. Within the sidebar select Build | Objects | Base Behaviours
9. Under Search Layouts, click Edit next to Search Layouts
10. Select the following fields as shown in the screenshot below, and then repeat for the Base Behaviours Tab search layout
    

Collectives

1. Go to Collectives tab and open the All list view
2. Click Edit next to the list view
3. Remove the DEPRECATE - Members field from the 'Selected Fields' list as shown below, and then click the Save button to save your changes.
   
4. Repeat these steps for the Experience Groups and Templates list views

Rewards

1. Go to the Reward tab and open the All list view
2. Click Edit next to the list view
3. Remove the DEPRECATE - Status field from the 'Selected Fields' list, and then add the Status field from the 'Available Fields' list, as shown below:
   
4. Click the Save button to save your changes.

Update Page Layouts and Related Lists

Collectives

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Objects | Collective
3. Under Page Layouts, click Edit next to Experience Group Layout
4. Remove the 'DEPRECATE - Members' field from the layout and click Quick Save
5. Ensure that the following fields are displayed in the Behaviours related list on the page:
   
6. Repeat these steps for Targeted Layout and Team Layout

Behaviours

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Objects | Behaviours
3. Under Page Layouts, click Edit next to Team Achievement Layout
4. Ensure that the following fields are displayed on the page:
   
5. Ensure that the following fields are displayed in the Rewards related list on the page:
   

Members

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Objects | Member
3. Under Page Layouts, click Edit next to Team Role Layout
4. Ensure that the following fields are displayed in the Rewards related list on the page:
   

Rewards

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Objects | Reward
3. Under Page Layouts, click Edit next to Reward Layout
4. Ensure that the following fields are displayed on the page:
   

Update Search Layouts

Collectives

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Create | Objects | Collective
3. Under Search Layouts, click Edit next to Collectives Tab
4. Remove the DEPRECATE - Members field from the 'Selected Fields' list
5. Click the Save button to save your changes.

Base Behaviours

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Create | Objects | Base Behaviour
3. Under Search Layouts, click Edit next to Search Results
4. Remove the DEPRECATE - Points field from the 'Selected Fields' list, and then add the Status field from the 'Available Fields' list
5. Click the Save button to save your changes.
6. Repeat these steps for the Base Behaviours Tab search layout.

Rewards

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Create | Objects | Reward
3. Under Search Layouts, click Edit next to Search Results
4. Remove the DEPRECATE - Status field from the 'Selected Fields' list, and then add the Status field from the 'Available Fields' list
5. Click the Save button to save your changes.
6. Repeat these steps for the Rewards Tab search layout.

Insight Migration

Running the Insight Migration process will enable Insight record generation and create Insight records from Rewards that were generated in collectives that had 'Insight & Predict' enabled. These Insight records will then be used in Opportunity Insight instead of Reward records, and any Insights subsequently generated will be surfaced in Opportunity Insight and used to drive predictions. Having run the Insight Migration process, Competitions and Experience Groups can no longer be configured for 'Insight & Predict'.

1. Enter Setup by clicking on the Setup link at the top of the screen
2. Within the sidebar select Build | Installed Packages
3. Click on Configure next to the SuMo package name
4. On the Application Configuration page, click on the Insight & Predict section
5. Under Insight Migration, click the Run button

Set up Player UI for Salesforce Classic
Set up Player UI for Salesforce Lightning
Set up Manual Rewarding for Salesforce Classic
Set up Manual Rewarding for Salesforce Lightning

The Motivate Upgrade is now complete!