Indus (v1.31) | Upgrade Instructions | December 2022
Our upgrade instructions provide guidance on new features that require manual updates in order not to conflict with any org-specific customization. Detailed information on Set-up, Configuration and Feature Information is available in the Installation Guide and User Guide for each release.
Contact support@verasolutions.org to share feedback.
- 1 Upgrading Amp Impact to Indus - v1.31
- 2 Packaging Changes
- 3 Update Profiles and Custom Permission Sets for New Objects and Fields
- 4 Update the Indicator Object to use Picklist Indicators and Read Only Results
- 5 Update the Project Indicator Object to use Read Only Results
- 6 Update the Result Object to use the Baseline functionality
- 7 Update the Project Indicator Reporting Period Object to use the Baseline functionality
- 8 Add Translations for New Values
- 9 Update Custom Settings
- 10 Update the Reporting Period Object
- 11 Update Field Help Text for IATI Reporting
- 12 Update Field Sets
- 13 Add Set Targets and Add Results Lightning Web Components to the Project Lightning Page
- 14 Start Using Amp Impact in Spanish
- 15 Set Up Named Credential for IATI XML Validation
Upgrading Amp Impact to Indus - v1.31
Note:
A Salesforce environment with Amp installed can be directly upgraded to the latest version of Amp as long as the current version is v1.17.1 or later. If the version of Amp is an earlier version, you must first upgrade to v1.17.1 before upgrading to v1.31 (Indus). When upgrading to this version and skipping previous upgrades, please be sure to follow the Upgrade Instructions for every intermediate release as well to ensure the app continues working as expected.
To upgrade to the latest release of Amp Impact, log into your Sandbox environment and use the installation link.
Vera Employees can navigate to this page to access the link.
Partners & customers, please get in touch with your Vera point of contact to access the link.
Information will be displayed confirming that you have an earlier version installed and it can be upgraded while preserving existing data.
Select which users you wish to install the package for (learn more here).
Click "Upgrade".
Refer to the release notes document and learn about the new features and bug fixes for this release.
After reviewing the release notes, follow the steps outlined below.
Perform your current use cases in the sandbox and if you are using any of the new features from this release, ensure that they are operating as expected.
When you are ready to deploy to Production, use this installation link.
Update any changes you make, for example to custom settings, in Production as these will not "carry over" from your sandbox.
Note:
If My Domain has already been set up, replace “test” or “login” in the installation links with the specific domain appended by .my. for the org. See below for an example of a customized installation link: https://customdomain.my.salesforce.com/packaging/installPackage.apexp?p0=04t4o000002FIf5&isdtp=p1
Packaging Changes
Certain changes to the configuration will be automatically updated on installation of the upgrade, while others will need to be manually updated (in order not to conflict with any org-specific customization). For full details on what Salesforce supports when upgrading managed packages, refer to the Editing Components and Attributes After Installation and Special Behavior of Components in Packages pages.
Change | Automatic Update? | Manual Update Location | Example from Indus Release |
Updated custom setting | Yes |
| New field ampi__Disable_Geographic_Area_Hierarchy__c has been added to ampi__SetTargets__c custom setting |
New custom label | Yes |
| New custom label ADD_DISAGG_COMMENT_MESSAGE has been created. |
Updated custom label | Yes |
| Updated Categories to Targets, Results, Upload, Popup, Button, Excel, Spreadsheet, Template, Amp Impact
|
New field | Yes |
| New checkbox field ampi__xx_Has_Baseline__c has been added to object ampi__Indicator__c |
Updated field | Yes |
| Field label for ampi__IATI_Organization_Type_Code__c on Account updated to “IATI Organisation Type Code” |
New record type | Yes |
| New record type Baseline on ampi__Reporting_Period__c |
New page layout | Yes |
| New page layout Baseline Layout was created |
New validation rule
| Yes |
| New validation rule IATI_Transaction_Organisation_Role_Check has been added to field ampi__IATI_Organization_Role__c |
Updated flow | Yes |
| Updated Schedule_Reporting_Periods flow to include the following changes:
|
New email template | Yes |
| Added email template IATI_XML_Generated_Not_Validated
|
Updated email template | Yes |
| Updated email template IATI_Activity_XML_Generation_Failure
|
Updated field set | Yes |
| Added field ampi__xx_Reporting_Picklist_Values__c to ampi__ADD_NEW_INDICATOR_POPUP field set. |
New picklist value | No | Object → Fields and Relationships → Field | New picklist value “Picklist” added to the ampi__Data_Type__c field on ampi__Indicator__c |
Updated page layout | No | Object → Page Layouts | ampi__xx_Has_Baseline__c added the following fields to the Project Indicator Layout |
Update Profiles and Custom Permission Sets for New Objects and Fields
While permission sets in the package are automatically updated to provide access to these new fields (New field ampi__xx_Has_Baseline__c on object ampi__Indicator__c), profiles and custom permission sets must be manually updated to include these new artifacts if the relevant user(s) requires access to them. Refer to the Packaging Changes section in the release notes to determine which objects and fields need to be added to any custom profiles or permission sets.
Update the Indicator Object to use Picklist Indicators and Read Only Results
Salesforce does not support the update of picklist values in a field while upgrading a managed package. This needs to be manually done in order to use the new functionality. When upgrading to Indus, you need to make the following updates to the ampi__Indicator__c object:
1. Add ‘Picklist’ picklist value within the Data Type (ampi__Data_Type__c) field
2. Add ‘Read Only’ picklist value within Type of Results (ampi__Type_of_Results__c) field
Please follow the steps mentioned below to complete the setup of the Indicator object.
Add “Picklist” picklist value within the Data Type Field
You can add ‘Picklist’ as a picklist value within the Data Type (ampi__Data_Type__c) field by following the steps mentioned below:
Navigate to Salesforce Settings
Click on Object Manager
Search for and click on the Indicator object
Click on the Fields & Relationships tab
Search and click on the Data Type field (ampi__Data_Type__c)
Navigate to the Values section and click on New
Type ‘Picklist’ in the input text box field.
Click on Save.
Add “Read Only” picklist value within Type of Results Field
You can add the ‘Read Only’’ picklist value within the Type of Results (ampi__Type_of_Results__c) field by following the steps mentioned below:
Navigate to Salesforce Settings
Click on Object Manager
Search for and click on the Indicator object
Click on the Fields & Relationships tab
Search and click on the Type Of Results field (ampi__Type_of_Results__c)
Navigate to the Values section and click on New
Type ‘Read Only’ in the input text box field.
Click on Save
Update the Project Indicator Object to use Read Only Results
Salesforce does not support the update of picklist values in a field while upgrading a managed package. This needs to be manually done in order to use the new functionality. When upgrading to Indus, you need to make the following updates to the ampi__Project_Indicator__c object:
Add ‘Read Only’ picklist value within the Type of Results (ampi__Type_of_Results__c) field.
Add ‘Read Only’ option to Type of Results field
This step is required in order to use the Read Only Type of Result on the Project Indicator Object. You can add the ‘Read Only’’ option within the Type of Results (ampi__Type_of_Results__c) field by following the steps mentioned below:
Navigate to Salesforce Settings
Click on Object Manager
Search for and click on the Project Indicator object
Click on the Fields & Relationships tab
Search and click on the Type Of Results field (ampi__Type_of_Results__c)
Navigate to the Values section and click on New
Type ‘Read Only’ in the input text box field.
Click on Save
Update the Result Object to use the Baseline functionality
Salesforce does not support the update of picklist values in a field while upgrading a managed package. This needs to be manually done in order to use the new functionality. When upgrading to Indus, you need to make the following updates to the < > object:
Add ‘Baseline’ picklist value within the Data Tracked (ampi__Data_Tracked__c) field
Edit the label for ‘Both’ picklist value within the Data Tracked (ampi__Data_Tracked__c) field
Add ‘Baseline’ picklist value to Data Tracked picklist field on Result Object
This step is required in order to use the Indicator Baseline functionality. You can add the ‘Baseline’ option within the Data Tracked (ampi__Data_Tracked__c) field by following the steps mentioned below:
Navigate to Salesforce Settings
Click on Object Manager
Search for and click on the Result object
Click on the Fields & Relationships tab
Search and click on the Data Tracked field (ampi__Data_Tracked__c)
Navigate to the Values section and click on New
Type ‘Baseline’ in the input text box field.
Click on Save.
Edit the label for ‘Both’ picklist value within the Data Tracked field
Navigate to Salesforce Settings
Click on Object Manager
Search for and click on the Result object
Click on the Fields & Relationships tab
Search and click on the Data Tracked field (ampi__Data_Tracked__c)
Navigate to the Values section and click on Edit next to the ‘Both’ value
7. Change the Label to ‘Target and Result’
8. Click ‘Save’
Update the Project Indicator Reporting Period Object to use the Baseline functionality
Salesforce does not support the update of picklist values in a field while upgrading a managed package. This needs to be manually done in order to use the new functionality. When upgrading to Indus, you need to make the following updates to the ampi__Project_Indicator_Reporting_Period__c object:
Add ‘Baseline’ picklist value within the Data Tracked (ampi__Data_Tracked__c) field
Edit the label for ‘Both’ picklist value within the Data Tracked (ampi__Data_Tracked__c) field
Add ‘Baseline’ picklist value to Data Tracked picklist field on Project Indicator Reporting Period Object
This step is required in order to use the Indicator Baseline functionality. You can add the ‘Baseline’ option within the Data Tracked (ampi__Data_Tracked__c) field by following the steps mentioned below:
Navigate to Salesforce Settings
Click on Object Manager
Search for and click on the Project Indicator Reporting Period object
Click on the Fields & Relationships tab
Search and click on the Data Tracked field (ampi__Data_Tracked__c)
Navigate to the Values section and click on New
Type ‘Baseline’ in the input text box field.
Click on Save.
Edit the label for ‘Both’ picklist value within the Data Tracked field
Navigate to Salesforce Settings
Click on Object Manager
Search for and click on the Project Indicator Reporting Period object
Click on the Fields & Relationships tab
Search and click on the Data Tracked field (ampi__Data_Tracked__c)
Navigate to the Values section and click on Edit next to the ‘Both’ value
Change the Label to ‘Target and Result’
Click ‘Save’
Add Translations for New Values
After following the previous steps and updating the concerned objects to use the new functionality, you can also leverage Salesforce’s translation feature by adding translations for each picklist value or field label. Please refer to this document to learn how to add or update translations for the Picklist Values and Field Labels referred to earlier.
Update Custom Settings
Disable Geographic Area Hierarchy in the dropdown on Set Targets and Add Results Visualforce pages
A new field Disable Geographic Area Hierarchy (ampi__Disable_Geographic_Area_Hierarchy__c) has been created within the Custom Setting for Set Targets (ampi__SetTargets__c). This field controls the display of geographic areas in the dropdown on Set Targets and Add Results Visualforce pages and allows users to toggle the structure of Geographic Areas between hierarchical and non-hierarchical.
By default, Geographic Areas will be displayed hierarchically in the dropdown on Set Targets and Add Results. To disable the hierarchy in the dropdown, follow the steps:
Navigate to Salesforce Settings
Search for and click on Custom Settings
Under the Label column, click on Set Targets (ampi__SetTargets__c)
Click on Manage at the top of the page
Click on Edit at the top of the page
Check the box next to Disable Geographic Area Hierarchy
Update the Reporting Period Object
Page layout changes made to the ampi__Reporting_Period__c object will not be reflected when you upgrade to Indus. This is to ensure that any customizations made by users are not overridden. In order to meet the modifications made to the Reporting Period lightning record page, you need to modify the Reporting Period page layout assignments.
Update Page Layout for the Reporting Period Object
Navigate to Salesforce settings
Click on Object Manager
Search for and click on the Reporting Period Object
Click on the Page Layouts tab
Click on the Page Layouts Assignment button
Click on the Edit Assignment button
Click on the Baseline column. It will turn purple to indicate it has been selected
Click on the Page Layout to Use picklist and select Baseline Layout
Click on Save
Update Field Help Text for IATI Reporting
Help text has been updated for several IATI-related fields on the objects mentioned below in order to support the end user entering data for IATI reporting. These are not automatically updated. Refer to this sheet to access the fields and the suggested help text.
Budget__c 9. Organization_Role__c
Project_IATI_Sector__c 10. IATI_Policy__c
Project__c 11. Project_Indicator__c
Account 12. Objective__c
Disbursement__c 13. Project_IATI_Policy__c
IATI_Sector__c 14. ContentVersion
Project_Geographic_Area__c 15. Allocation__c
Financial__c
Update Field Sets
In this release, we have added new fields to certain field sets, as mentioned in the table given below. The new field is placed at the end of the upgraded field set in whichever column it was added to. Fields can also be added/removed/re-ordered based on the organization’s preferences.
Object API Name | Field Set API Name | Update(s) |
ampi__Indicator__c | ampi__ADD_NEW_INDICATOR_POPUP | The following fields have been added to the field set:
|
ampi__Project_Indicator__c | ampi__EDIT_PROJECT_INDICATOR_POPUP | The following fields have been added to the field set:
|
ampi__Project_Indicator__c | ampi__ADD_RESULTS_INFO_POPOVER | The following fields have been added to the field set:
|
ampi__Project_Indicator__c | ampi__SET_TARGETS_INFO_POPOVER | The following fields have been added to the field set:
|
Add Set Targets and Add Results Lightning Web Components to the Project Lightning Page
To preserve existing functionality on the Project Lightning Record Page, the new Lightning Web Components (setTargets and addResults) have not been immediately added to the page. If your organization wishes to switch to this new interface (Please refer to User Guide) follow the below steps:
Create a clone of the Project Lightning Record Page.
In Lightning App Builder, click on the tabs to open up the Tab component editor on the right-hand pane.
Remove the Visualforce pages from the respective tabs:
SetTargets Visualforce page from the “Targets“ tab
AddResults Visualforce page from the “Results“ tab
On the left-hand pane, scroll down to Custom-Managed Components.
Drag each Lightning Web Component from the pane and drop it into the respective tabs:
setTargets Lightning Web Component into the “Targets“ tab
addResults Lightning Web Component into the “Results“ tab
Click “Save”.
Click “Activation” and activate the Lightning Record Page according to your organization’s use case.
Start Using Amp Impact in Spanish
Amp Impact now contains Spanish (language code “es”) translations for many of its features. To start using Amp Impact in Spanish, Translation Workbench must be enabled and Spanish must be activated. If these are not already in place, follow the steps below:
Open Setup and go to Translation Settings.
Click Enable.
Click Add in the Supported Languages menu.
Select Spanish and leave Active as checked.
(Optional) Add a translator for the language.
Click Save.
To set Spanish as the default language for all users in the org:
Open Setup and go to Company Information.
Click Edit.
Set Default Language as Spanish.
Click Save.
To set Spanish as the default language for a specific user:
Open Setup and go to Users.
Click Edit next to the User who will be using Amp in Spanish.
Set Language to Spanish.
Click Save.
Set Up Named Credential for IATI XML Validation
In order to validate the IATI Organisation or Activity XML while it is being generated, a Named Credential record will need to be created in order to connect an Amp Impact environment with the IATI Validator. Before you can create this, you will first need to obtain an IATI Gateway API Key.
Create IATI Gateway API Keys
Navigate to https://developer.iatistandard.org
Click “Sign Up”.
Follow the sign up process and confirm your account from an email link.
Sign In to the API Gateway developer portal (same URL as above).
Click Subscriptions > “Exploratory”/“Full Access” (as per requirement).
Enter a Subscription Name (this can be anything you want) in the box.
Check the box to agree to the Terms of Use.
Click the Subscribe Button.
Copy your Primary or Secondary Key from your Profile on the API Gateway webpage.
Create Named Credential Record in Salesforce
With the primary and secondary keys copied from the previous section, you are now ready to create a Named Credential record to connect Salesforce and Amp Impact to the IATI Public Validator.
Go to setup and search for “Named Credentials”.
Click on “External Credentials” and then click on “New”.
Fill in the following details and click Save.
Label: IATI VALIDATOR EXTERNAL CREDS
Name: IATI_VALIDATOR_EXTERNAL_CREDS
Authentication Protocol: Custom
Create a Permission Set Mapping for the External Credential. This Permission Set Mapping will help to authorize users such that users assigned to this permission set will only be allowed to utilize a specific OcpApimSubscriptionKey provided by the IATI.
Input the OcpApimSubscriptionKey (Primary or Secondary Key) provided by the API Gateway in the value field of Parameter 1 and click Save.
Create a custom header with the following inputs.
Name: Ocp-Apim-Subscription-Key
{!$Credential.IATI_VALIDATOR_EXTERNAL_CREDS.OcpApimSubscriptionKey}
Sequence Number: 1
7. Now, create a Named Credential, with the following parameters.
a. Label: IATI VALIDATOR
b. Name: IATI_VALIDATOR
c. URL: https://api.iatistandard.org
d. External Credential: IATI VALIDATOR EXTERNAL CREDS
e. Allowed Namespaces: ampi
8. Create a new custom header within the Named Credential with the following parameters:
Name: Content-Type
Value: text/plain
Sequence Number: 1