Pre-Upgrade Information for Motivate

The instructions provided in this section relate to upgrades from the Motivate Base app Version 7 (v7.27) to Version 8 (v8.x).

The majority of the upgrade process is automated and instructions on how to initiate this process are included on the Automated Upgrade page. Once the automated upgrade process has successfully completed you should follow the Post-Upgrade Steps that need to be performed in order complete the upgrade process.

Upgradeable Environments

Within Sandbox environments, the upgrade process will vary for Sandbox types that do not copy Production content. The Motivate base application is comprised of code, metadata and content (specific data records that are essential for Motivate to function correctly). Certain Sandbox types do not copy any content (i.e. Developer and Developer Pro Sandboxes) and those environments will, therefore, contain an incomplete Motivate application configuration which is unsuitable for testing as it will not be fully functional and cannot be upgraded. A Partial Copy Sandbox could be templated to include the necessary Motivate base app content that would then enable it to be tested and upgraded. However, if this has not been configured, then a Partial Copy Sandbox should be treated the same as Developer Sandboxes (described below).

Within Developer and Developer Pro Sandboxes the Motivate application and the base application will need to be uninstalled and re-installed (following the standard Installation process) before continuing; this is to populate the content that is omitted by the standard Salesforce.com Sandbox copy process. This will have no bearing on the final Motivate base app version that will be installed. Please review the Salesforce Sandbox information pages or contact Salesforce.com if you require any further information on the Sandbox types available for the force.com platform.

Review Base Behaviours and Behaviours

1. When upgrading to Version 8 all Base Behaviours that have the Archived field set to 'False', will have their Status set to 'Active' after upgrading. When a Base Behaviour has a status of 'Active' in Version 8, Observation records will be created, as well as Rewards if the Base Behaviour is being used in running Competitions and Experience Groups. Therefore, if users do not wish Base Behaviours to be 'Active' after upgrading, it is recommended that the Archived field is set to 'True' prior to upgrading.
2. Behaviours in Competitions and Experience Groups that have different aggregate function values to those inherited from their associated Base Behaviours should be identified, as in Version 8, these aggregate function fields can no longer be overridden on Behaviours. Therefore when upgrading to Version 8, these Behaviours will use the aggregate function values on their associated Base Behaviours which may produce unintended results. The recommendation is to identify any such scenarios and to create new Base Behaviours using those required aggregate function values and then use these Behaviours within Competitions and Experience Groups, instead of the existing overridden Behaviours.
3. Behaviours in Competitions and Experience Groups that use Points formula that reference object fields, e.g. 'Opportunity.Amount*0.002', are no longer supported in Version 8 and therefore will need to be amended either prior, or after upgrading to Version 8. If these Points formula are not amended, Rewards that are created after upgrading will have a null Points value. The recommendation is either to use a static Points value instead of a formula, or after upgrading to Version 8, use the 'Tracked Field' field on the associated Base Behaviours to replicate the previous functionality. In the previous Points formula example, the associated Base Behaviour that is on Opportunity, would have the 'Tracked Field' field set to Amount, and the Behaviour would have a Points formula of success__Behaviour_Observation__c.success__Tracked_Field_Value__c*0.002
4. Aggregate Scheduled Behaviours (i.e. Scheduled Base Behaviours on the Metric object) will no longer support Behaviour Criteria in Version 8. As part of the upgrade process, any Behaviour Criteria in the format shown below that are found on Aggregate Scheduled Behaviours, will automatically be converted into a 'HAVING' clause within the Query. However, any other Behaviour Criteria that is found will not be converted, and will therefore will need to be included as part of the Query where possible.

Continue to Automated Upgrade