Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
minLevel2
maxLevel2
stylecircle

...

Overview of the Amp Impact Grant Management Plugin

The Amp Impact Grant Management Plugin is an extension to Amp Impact that enables the setup and configuration of functionality to manage the grant application and review process and, ultimately, the grant reporting process.

...

Info

Please note that Amp Impact Grant Applications and Reviews Module should be used as extension of the Amp Impact. Amp Impact (v1.25, Delphinus or beyond) should be installed in the org before installing Amp Impact Grant Applications and Reviews Module.

Visit the setup and customization section of the Knowledge Base to learn more about Amp Impact Installation.

...

Install Amp Impact Grant Applications and Reviews Module

The following installation and configuration instructions are updated as of June 2020 - covering all releases of Amp Impact.

...

Info

Admin Note:  

If ‘My Domain’ has already been set up, replace 'test' or 'login' in the installation links with the specific domain for the org.

...

System Administration and Setup

Info

Admin Note:  

‘Enabling Communities’ should be done prior to installing the Amp Impact Grant Management Plugin in a sandbox or production environment.

Enable

...

Digital Experiences (Required)

In order to use the Community Template for Grant Applicants, Communities will need to be enabled in system setup.

  1. Open ‘Setup’.

  2. Use the Quick Find search to find and open ‘Communities Settings’.

  3. Select the ‘Enable Communities’ checkbox.

  4. In the ‘Domain Name’ field enter your domain name.

  5. Click ‘Check Availability’.

  6. Click ‘Save’.

  7. Click ‘OK’ in the confirmation message.

Enable Path

For Lightning pages in the Amp Impact Grant Applications and Reviews Module to correctly display the Path component, Path must be enabled in the Salesforce org. System Admins can enable Path by following these steps:

...

Path Name

Object API Name

Picklist Field API Name

Lightning Record Page

Application Review Status

ampgm__xx_Application_Review__c

ampgm__Review_Status__c

Application_Review

Application Stage

ampi__Project__c

ampgm__Application_Stage__c

Application

Grant Status

ampi__Project__c

ampi__Project_Status__c

Grant

Call for Proposals

ampgm__xx_Call_For_Proposals__c

ampgm__Status__c

Call_for_Proposal_Record_Page

Concept Note Stage

ampgm__xx_Concept_Note__c

ampgm__Concept_Note_Stage__c

Concept_Note_Record

...

Basic User Administration and Permissions

Assign Permission Sets (Required)

Out of the box, the Grant Applications and Review Module includes two permission sets.

Assign the Amp Grant Management Admin Permission Set

This permission set is meant to be assigned to users who will be responsible for creating, assigning, reviewing, and approving/rejecting Call For Proposals, Concept Notes, and Applications. 

...

Info

Admin Note:  

The Amp Grant Management Admin permission set does not contain permissions to either the Project Role or Organization Role objects, as there is a Salesforce limitation in which permission sets in managed packages cannot provide access to custom objects that are 'detail' to standard Salesforce objects in a master-detail relationship.

To provide access to either of these objects, create a new permission set (or modify an existing unmanaged permission set) and add both the object and field permissions manually through Object Settings. Assign this new permission set to any users who require access to Project Role and Organization Role.

Assign the Amp Grant Management Community Permission Set

This permission set is meant to be assigned to the users who will fill out and submit Concept Notes or Applications to a Call for Proposals.

...

  1. Go to the Setup Quick Search box, and enter 'Permission Sets'.

  2. Click on the permission set labeled Amp Grant Management Community.

  3. Click on ‘Manage Assignments’.

  4. Click on ‘Add Assignments’.

  5. Select the user(s) for whom this permission set should be assigned and click on assign.

Create Custom Permission Sets

Info

Admin Note:  

This step is optional for any organization in which the previously mentioned permission sets are not sufficient for the business processes.

...

  1. Navigate to Setup > Permission Sets.

  2. Clone the packaged permission set.

  3. Based on the user profile, edit the permission set by removing any permissions that are unnecessary for the user to use the Amp Impact Grant Managements Module or adding permissions to custom objects/fields.

  4. Once the permission set has been customized per the user profile, assign the permission set to the relevant user(s) by clicking 'Manage Assignments'. 

  5. If specific permission requirements are determined during configuration (e.g., restriction of certain edit privileges), System Admin may need to modify/clone this permission set or modify user permissions on an individual profile level to achieve these requirements.

  6. Additionally, certain permission and sharing setups (i.e., restricting 'create' access for certain objects for some user groups, make individual tabs available but not the entire app) may require the System Admin to make additional changes to existing user permissions & record sharing setup leveraging the standard Salesforce platform security & sharing features. 

Assign Record Types to Profiles (Required)

The Grant Application and Reviews Module introduces two record types to the ampi__Project__c object:

...

Info

Admin Note:  

The Amp Impact main package also contains record types on the ampi__Question__c and ampi__Submission__c objects. Refer to the Submissions: Customization Options page for more details.

...

Customize User Interface

Relabel Project Object

Out of the box, object ampi__Project__c is labelled as ‘Project’, rename this to ‘Application/Grant’ to be  relevant. 

Info

Admin Note:  

For more details on how to customize labels and tabs in Amp Impact, visit the Terminology and Labels page.

Update Page Layouts

Update Call for Proposals Page Layout per Business Process (Required)

Additionally, depending on whether your organization is using a one- or two-stage application process to Calls for Proposals, the Quick Actions on the ampgm__xx_Call_For_Proposals__c should be added to the page layout to reflect that process:

  • ampgm__Start_Application: Add this to the page layout if a one-stage application process is followed (i.e. applicants are immediately invited to submit a full application that includes the narrative application, proposed budget, proposed implementation plan, et al.).

  • ampgm__Start_Concept_Note: Add this to the page layout if a two-stage application process is followed (i.e. applicants must first provide some initial narrative information before being invited to submit the full application).

Update Standard Salesforce or Amp Impact Object Page Layouts

Page layouts for standard Salesforce objects and packaged Amp Impact objects cannot be updated by the Grant Applications and Reviews Module. The following page layout updates must be made manually:

Object API Name

Update

Account

Add ampgm__Stakeholder_Type__c to the page layout

Contact

Add ampgm__Designated_Reviewer__c to the page layout

ampi__Organization_Role__c

Add ampgm__Stakeholder_Role__c to the page layout

Assign Page Layouts to Record Types (Required)

Due to the two record types introduced in this module on the ampi__Project__c object, multiple page layouts (in addition to the Amp Impact Project Layout) have been created so that the correct data is displayed and editable depending on the record type:

...

Info

Admin Note:  

The Amp Impact main package also contains page layouts for the ampi__Question__c and ampi__Submission__c objects, which need to be assigned to record types. Refer to the Submissions: Customization Options page for more details.

Activate Lightning Pages (Required)

The Amp Impact Grant Applications and Reviews Module includes several Lightning pages in the package: 

...

Info

Admin Note:  

The Amp Impact main package also contains several Lightning Pages for ampi__Submission__c, which are required to use the Grant Applications and Reviews Module. To see guidelines on assigning those Lightning Pages to record types and profiles, please review Submissions: Customization Options section.

...

Customize Reports

Report Charts for Review Scores

Info

This step is optional and only required if the grant coordinator has created review templates with number type questions that collect any other information than review or section scores.

...

  • Navigate to the ‘Reports’ object tab.

  • Edit the reports ‘Review Scores by Concept Note’ and ‘Review Scores by Application’ as per the review templates.

  • Save the reports.

Filter the Report Charts for the current record

Info

Admin Note:  

Due to a Salesforce limitation, Report Charts are not filtered to the current record out of the box. The system administrator needs to configure the filter for each report to show only data associated with the current record.

...

  1. Navigate to the ‘Call For Proposal’ record.

  2. Click on the ‘Review Status’ tab.

  3. Click on 'Edit Page' option in the Setup.

  4. Click on the Report Chart component in the Lightning App Builder.

  5. Click on the 'Filter By' to specify the current Call For Proposal record.

  6. Repeat this process for Report Charts on the Review Score tabs on Concept Note record and Application record.

...

Customize Email Automation

Email Templates

Classic Email Templates

  • ampgm__Application_Review_Review_not_submitted

  • ampgm__Disbursement_Initiation_Notification

Import Lightning Email Templates

Due to a Salesforce limitation on deploying Lightning Email Templates, these are not provided out of the box in the Grant Applications and Reviews Module. However, these can be imported via Data Loader. Download this spreadsheet as a CSV and use it to insert the Lightning Email Templates. The spreadsheet contains the following Lightning Email Templates:

...

Note that any customizations to these templates can be made directly in the CSV or in the system.

Email Alerts

To send each of the Classic Email Templates, two Email Alerts have been created:

Email Alert API Name

Function

Customization Required

ampgm__Application_Review_submission_reminder

This email alert sends an email to the Reviewer Contact on the Application review record using email template ampgm__Application_Review_Review_not_submitted. It is called by the process ampgm__Notify_Reviewer_to_Submit

N/A

ampgm__Notify_Accounting_Team_to_Initiate_Disbursement

This email alert sends an email to the accounting team using email template ampgm__Disbursement_Initiation_Notification. It is called by the process ampgm__Disbursement_Send_Email_To_Accounting_Team

Create a public group 'Accounting Team' consisting of Users/ Roles belonging to the accounting team and add that group to the Selected Recipients.

...

Customize Process Automation

Flows

The following flows are included in the module:

...

The flows have been enabled as a template, and hence if you want to edit it to meet your organization’s specific use case, you can clone the flow, make the required changes in the cloned flow, and activate the cloned flow.

Process Builder

The following processes are included in the module:

...

Info

Please note that processes ampgm__Auto_Setup_Application and ampgm__Concept_Note_Auto_Setup_Concept_Note require the grant applicant to have an associated contact and account (this requirement is fulfilled by all community users). If you want users without an associated contact and account to launch these processes, clone and edit these processes as per your requirement.

Quick Actions

The following Quick Actions are included in the module:

...

Since these actions are packaged, they cannot be directly updated. To customize these actions, first copy the action (note that Salesforce does not allow for cloning Actions, so this must be done manually by creating a new action), make the required changes in the new action, and replace the packaged action on the relevant page layout(s) with the new action.

...

Setup Submissions

Info

Also refer to the Submissions: Customization Options page for more details.

Create Custom Setting Records 

The Grant Applications and Reviews Module introduces three out-of-the-box relationship fields on the ampi__Submission__c object.  In order to use the SubmissionResponseForm that has been added to the Lightning Pages of those parent objects, Submission Relationship Custom Setting records for each of these relationships need to be created:

...

  1. Go to Custom Settings in Setup.

  2. Click 'Manage' next to Submission Relationship.

  3. Click the 'New' button.

  4. Fill out the ‘Name’ field with the API name of the parent object.

  5. Fill out the Child Relationship Field Name field with the API name of the relationship field on ampi__Submission__c.

...

Setup Grantee Portal (Experience Site)

Once a new Digital Experience has been created, follow the steps below at a minimum to set up the Application and Review module.

Setup Navigation Menu

  1. Click on  Navigation Menu 

  2. Click on the Edit Default Navigation

    1. Add a Menu Item with the Name as 'My Accounts'

      1. Specify the Type as 'Salesforce Object'

      2. Specify the Object Type as 'Accounts'

    2. Add a Menu Item with the Name as 'My Call For Proposals'

      1. Specify the Type as 'Salesforce Object'

      2. Specify the Object Type as 'Call For Proposal'

    3. Add a Menu Item with the Name as 'My Concept Notes'

      1. Specify the Type as 'Salesforce Object'

      2. Specify the Object Type as 'Concept Note'

    4. Add a Menu Item with the Name as 'My Applications'

      1. Specify the Type as 'Salesforce Object'

      2. Specify the Object Type as 'Application/Grant'

      3. Choose the default list view as 'My Applications'

    5. Add a Menu Item with the Name as 'Grant Reports'

      1. Specify the Type as 'Salesforce Object'

      2. Specify the Object Type as 'Application/Grant'

      3. Choose the default list view as 'My Grants'

  3. Save the Menu

Info

To follow the steps above, please make sure that the list views ‘My Applications’ and ‘My Grants’ exist for Application/Grant (ampi__Project__c) object.

Setup Pages for Application and Grant Record Type

  1. .Navigate to the ‘Pages’ section in the top bar.

  2. Navigate to the Application/Grant object page.

  3. Navigate to the Page Properties of Custom Object Record Detail/ ApplicationGrant Record Detail.

    Image RemovedImage Added
  4. Add a Page variation for the Application Record page.

    1. Navigate to the Page Variation tab.

    2. Click on ‘New Page Variation’ button.

    3. Select ApplicationGrant Detail_Application.

    4. Click on 'Next’

    5. Enter Application in Name Field.

    6. Click on 'Create'.

  5. Repeat the process to create page variation for the Grant Record page

    1. Navigate to the Page Properties of Custom Object Record Detail/ ApplicationGrant Record Detail

    2. Navigate to the Page Variation tab

    3. Click on ‘New Page Variation’ button

    4. Select ApplicationGrant Detail_Grant

    5. Click on Next

    6. Enter Grant in Name Field

    7. Click on Create

  6. Assign page variation ‘Application’ to Record Type ‘Application’ 

    1. Navigate to the Page Variation tab

    2. Click on  list menu dropdown next to Application page variation, and click on Assign

    3. Click on ‘New Audience’ button

    4. Specify the Audience name as ‘Application Record Type’

    5. Expand the Advanced chevron

    6. Select the Record Type as ‘Application/Grant’, Operator as ‘Equals’, and Value as ‘Application’

    7. Click on ‘Save & Assign’ button

  7. Repeat the process to assign page variation ‘Grant’ to Record Type ‘Grant’

    1. Navigate to the Page Variation tab

    2. Click on  list menu dropdown next to Grant page variation, and click on Assign

    3. Click on ‘New Audience’ button

    4. Specify the Audience name as ‘Grant Record Type’

    5. Expand the Advanced chevron

    6. Select the Record Type as ‘Application/Grant’, Operator as ‘Equals’, and Value as ‘Grant’

    7. Click on ‘Save & Assign’ button

Info

The concept note detail page should be setup out of the box, but If the correct lightning community page is not being displayed for Concept Notes, please follow the same process as for Application/Grants to create a new page variation based on lightning community page ‘Concept Note Applicant Concept Note’ and assign it as the default page variation for Custom Object Record Detail/ Concept Note Detail page.

Assign Community Members

  1. Navigate to the ‘Administration’ workspace

  2. Navigate to ‘Members

  3. Add the Grant Applicant Profile from Available Profiles to Selected Profiles OR

  4. Add the Amp Grant Management Community Permission Set from Available Permission Sets to Selected Permission Sets

  5. Click on the ‘Save’ button

Create Sharing Sets

Info

These steps are an example to create a sharing set for the Grant Applicant profile, enabling users with that profile to have read/write access to Concept Notes, and Applications, Grants on which they are the primary contact. Please read here for more information about Sharing Sets. Sharing Rules can also be used to provide this level of access, depending on the organization’s use case.

  1. Go to Setup.

  2. Type 'Communities Settings' in Quick Find and click the result.

  3. In the Sharing Sets related list, click 'New'.

    1. Label: Amp Impact Grant Applicant

    2. API Name: Amp_Impact_Grant_Applicant

    3. Selected Profiles: [Select the Profile created for Grant Applicants]

    4. Selected Objects: Concept Note

  4. Click Set Up in the Configure Access table.

    1. Grant access where the User.Contact matches Target Concept Note.ampgm__Grant_Applicant_Primary_Contact__c

    2. Access Level: Read/Write

  5. Click Update.

  6. Click Save.

  7. Repeat the process for Application/Grant

...

Import Geographic Areas

When an Application record is created, a related Project Geographic Area is also created based on the selection made in the Country picklist by the grant applicant while creating the Application/Concept Note. If a Geographic Area with the same name doesn’t exist in the org, then a new Geographic Area record is created too. To avoid duplicate data to be created, review the guidelines for creating Geographic Area records in bulk. It contains the Geographic Area records corresponding to the Country picklist on the Application/Grant object. 

...