Versions Compared

Key

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

This page covers:

Table of Contents
minLevel1
maxLevel3
7
style
typeflat

Overview

The purpose of this guide is to help consultants set up a Salesforce Digital Experience with Amp Impact functionality. These steps will set up Digital Experience Users with access to Add Results, Performance Graphs, and Project records, but not to Manage Framework, Manage Indicators, Set Targets, or Manage Disbursements. For any additional customised functionality and/or access in Digital Experience, additional configuration may be required.

Create Permission Set for Community Users

InfoThis permission set is an example to provide Customer Community
circle

Amp Impact in Salesforce Digital Experiences

Salesforce’s Experience Cloud enables organizations to create digital experience sites to provide access to specific sections of Amp Impact for Implementation Partners, Funders, Grantees, and other stakeholders who require periodic access to a subset of data.

The functional areas typically exposed to these external stakeholders include elements of the Project Setup functionality, AddResults pages, and Performance Graphs.

Info

Designing and configuring a digital experience site requires thorough planning and design and user adoption is often better with an iterative configuration and testing approach. This guide provides a high-level overview of the steps and some guidelines for Amp Impact-specific set up but we always recommend working with an Architect with experience in digital experiences.

Generally, setting up a digital experience site requires the following steps:

Panel
panelIconId31-20e3
panelIcon:one:
panelIconText1️⃣
bgColor#F4F5F7

General User, Access & Permissions Set Up & Configuration

Organizations often start by defining the user groups and their access and permissions. There are many ways to set this up and we’ve shared a few guidelines and examples.

Panel
panelIconId32-20e3
panelIcon:two:
panelIconText2️⃣
bgColor#F4F5F7

Set Up the Lightning Digital Experience Site

Next, you’ll choose a template and create the site, reviewing a few settings that pertain to Amp Impact.

Panel
panelIconId33-20e3
panelIcon:three:
panelIconText3️⃣
bgColor#F4F5F7

Navigate the Experience Builder

Once the site is created, you’ll use the Experience Builder to configure the relevant pages for the audiences that will access the site. We share a few examples of Amp Impact features that organizations typically expose in their site.


General User, Access & Permissions Set Up & Configuration

Create Permission Set for Digital Experience Users

The first step is to create a permission set for the Digital Experience Users.

Info

The permission set table below is an example to provide Digital Experience Users with access to all Project records and the , Activity Tracking, Add Results, and Performance Graphs pages. Permissions should be customised to an organisation’s organization’s use case. Here is a comprehensive matrix of user permissions required for various user actions.

Note: Permission Sets will vary based on the user license. Not all object level permissions are available for all user licenses.

Go
  1. Navigate to

Setup
  1. the setup interface.

  2. Type “Permission Sets” in Quick Find

and click the result
  1. .

  2. Find “Amp Impact Admin” and click “Clone”. Set the following:

    1. Label: Amp Impact Community

    2. API Name: Amp_Impact_Community

  3. Click “Assigned Apps”. In the page that loads, click “Edit”.

  4. Move ampi.Amp Impact (ampi__Amp_Impact) and ampi.Amp Impact (ampi__Amp_Impact_Lightning) from the “Enabled Apps” list to the “Available Apps” list and click “Save”.

    1. Assigned Apps are not allowed for some Community User licenses.

  5. Open

“ Object Settings”.
  • For each object in the table below, set the following permissions by clicking each object and then clicking “Edit”.

    1. “Object Settings” and navigate to the relevant objects to update the permissions.

    2. Here is an example of how organizations would typically define access to Amp Impact objects:

    Object

    Read

    Create

    Edit

    Delete

    View All

    Modify All

    Activities

    X

    X

    X

    X

    Budgets

    No access

    Disaggregated Indicators

    No access

    Disaggregated Project Indicators

    X

    X

    X

    X

    Disaggregation Groups

    X

    X

    X

    X

    Disaggregation Values

    X

    X

    X

    X

    X

    X

    Object (continued)

    Read

    Create

    Edit

    Delete

    View All

    Modify All

    Disbursements

    No access

    Financials

    No access

    Geographic Areas

    X

    IATI Policies

    No access

    IATI Sectors

    No access

    Implementation Plans

    X

    X

    X

    Indicators

    X

    X

    X

    Indicator Thematic Areas

    No access

    Objectives

    X

    Organization Roles

    X

    Project Geographic Areas

    No access

    Project IATI Policies

    No access

    Project IATI Sectors

    No access

    Project Indicator Geographic Areas

    X

    X

    X

    X

    Project Indicator Objectives

    No access

    Project Indicator Reporting Periods

    X

    X

    X

    X

    Project Indicators

    X

    X

    X

    X

    Project Indicator Thematic Areas

    No access

    Project Objectives

    X

    Project Roles

    X

    Projects

    X

    X

    X

    Project Thematic Areas

    No access

    Questions

    No access

    Object (continued)

    Read

    Create

    Edit

    Delete

    View All

    Modify All

    Reporting Periods

    X

    X

    X

    X

    Results

    X

    X

    X

    X

    X

    X

    Sections

    No access

    Submissions

    No access

    Thematic Areas

    X

    Visualforce Updates

    X

    X

    Create a Digital Experience Profile

    Info

    These steps are Here is an example using for creating a profile with the Customer Community Login User license. If you already have a digital experience user profile that you plan to use in a digital experience with Amp Impact, assign the permission set to those users. Otherwise, use the steps below as guidelines to a profile for digital experience users, and customise customize to the organisation’s organization’s use case as needed.

    Go
    1. Navigate to

    Setup
    1. the setup interface.

    2. Type “Profiles” in Quick Find and click the result.

    3. Click “New Profile”.

      1. For the Existing User picklist, select “Customer Community Login User”. 

      2. The User License should display “Customer Community Login”.

      3. For the Name field, enter “Amp Impact Community User”.

    4. Click “Save”.

    5. Click “Edit”.

    6. Scroll to Administrative Permissions and make sure the checkbox next to “API Enabled” is selected.

    7. Click “Save”.

    8. Navigate to Visualforce Page Access. Add “ampi.AddResults” and “ampi.PerformanceGraph” to the Enabled Visualforce Pages list. Click “Save”.

    Create a Sharing Set with Read/Write Access for Project Indicator

    Info

    These steps are an example to create a sharing set for the profile created in the previous step - Create Digital Experience Profile, enabling users with that profile to have read/write access to Project Indicators of which they are owner. Please read here for more information about Sharing Sets. Sharing Rules can also be used to provide this level of access, depending on the organisation’s organization’s use case.

    Go
    1. Navigate to

    Setup
    1. the setup interface.

    2. Type “Digital Experiences” in Quick Find and click “Settings” under the result.

    3. In the Sharing Sets related list, click “New”.

      1. Label: Amp Impact Community User

      2. API Name: Amp_Impact_Community_User

      3. Selected Profiles: Amp Impact Community User

      4. Selected Objects: Project Indicator

    4. Click Set Up in the Configure Access table.

      1. Grant access where the User.Contact matches Target Project Indicator.Owner.Contact

      2. Access Level: Read/Write

    5. Click Update.

    6. Click Save.

    Create Digital Experience Users

    Once the permissions and profile are in place, you are ready to create users and assign the appropriate permissions to them.

    Salesforce has detailed documentation on creating Experience Cloud Site users.

    As you create the user(s), ensure that you select the appropriate license,

    1. Open a Contact record detail.

    Info
    1. The Contact record must have a parent Account in order to be able to follow the next steps listed below.

    2.
    1. Enable the Contact as a Customer user by:

    a.
      1. (Classic) Click “Manage External User” at the top of the record. Select “Enable Customer User” from the dropdown.

    b.
      1. (Lightning) Click “Enable Customer User” button.

    3.
    1. In the User record page, select User License as “Customer Community Login” and Profile as “Amp Impact Community User” (or the Profile created in the earlier section on

    Create
    1. “Create Digital Experience

    Profiles
    1. Profiles”).

    Image Removed
    1. Image Added
    4.
    1. Click “Save”. 

    5.
    1. Scroll down the User record page to the first related list (Permission Set Assignments). Click “Edit Assignments”.

    Image Removed
    1. Image Added
    6.
    1. Add “Amp Impact Community” and “Submission Response” in the multi-select picklist. Click “Save”.

    Add Members to the Digital Experience

    This step can be completed once the Experience Site is set up and ready to be tested.

    1. In “Administration”, click “Members”. Add the “Amp Impact Community Profile” to the multi-select picklist. Click “Save”.

      Image Added
    2. Click the icon in the top left corner to bring down the sidebar. Click “Settings”, and click “Activate Digital Experience”.

      Image Added

    Set Up Lightning Digital Experience

    InfoThese

    The following steps will

    walk you through how to set

    guide you in setting up a Lightning Digital Experience with Projects (as

    shown below under

    indicated in the "Set Up Projects" section below) and Submissions (as

    shown below under

    indicated in the "Set Up Submissions" section below). Depending on your specific use case, certain steps can be

    skipped

    omitted or

    modified

    adjusted accordingly.

    In Setup

    Enable Digital Experiences

    1. Open

    Setup
    1. the setup interface.

    2. If Digital Experiences are not yet enabled, enable Digital Experience.

      1. Type “Digital Experiences” in Quick Find and then select “All Sites”.

      2. Select “Enable Digital Experiences”.

    3. Click the “New” Digital Experience button.

    Set Up CSP Trusted Site Record

    Experience Builder sites use utilize Content Security Policy (CSP) to secure our sites from enhance security by safeguarding against malicious resources and component vulnerabilities. Please add following CSP trusted site record to allow user to To enable users to export media for the ampi__Project_Indicator__c object via through the Performance Graph page in communities, please follow these steps to add the following CSP trusted site record:

    Navigate
    1. Go to

    CSP Trusted Sites within Setup
    1. “CSP Trusted Sites” in the setup interface.

    2. Click on the "New Trusted Site

    button 
    1. " button.

    Add Enter the value for ‘Trusted Site URL’ as ‘
    1. Provide the following information:

  • Enter ‘Trusted Site Name’ as ‘Highcharts’

      1. Set the "Trusted Site Name" as "Highcharts."

      2. Set the "Trusted Site URL" value as https://export.highcharts.com

      1. .

      2. Enter

    ‘Description’ as ‘This allows exporting media
      1. a brief "Description" such as "Enables media export of Project Indicators

    from
      1. within the Performance Graph tab in communities.

      1. "

    Leave
      1. Ensure the

    ‘Active’ checkbox as checkedUnder
      1. "Active" checkbox is selected.

    1. In the CSP Directives section

    mark the ‘Allow
    1. , check the box for "Allow site for

    img
    1. frame-

    src’ option as checkedImage Removed
    1. src" option.

    By following these steps, you will establish the necessary CSP trusted site configuration to facilitate media export for Project Indicators through the Performance Graph tab in Experience Sites.

    Image Added

    In Lightning Bolt Page:

    1. Select “Customer Service”.

    2. Click “Get Started”.

    3. Name your community and (optional) set a URL. Click “Create”. You will be taken to the Digital Experience Workspace.

    In Digital Experience Builder

    Experience Builder

    Salesforce has comprehensive documentation on their Experience Builder. Below, we share some guidelines on how to set up specific Amp Impact features in the Experience Builder.

    Set Up Amp Impact Projects

    Info

    Read more about Project Setup & Modifications here.

    1. Select “Builder”. You will be taken to the interactive builder.

      Image Modified
    2.
    1. Click on the Navigation Menu. A popup will appear on the top right.

      Image Modified
    3.
    1. Click on the “Navigation Menu” button

    . Another
    1. and another popup will appear.

    4.
    1. Click “+ Add Menu Item” button. 

    5.
    1. Name Menu Item as “Projects”, select Type as “Salesforce Object”, and select Object Type as “Project”. You can leave the Default List View at “Default”. Click “Save Menu”.

      Image Modified
    Info

    The following 6 steps (6-11) on setting up tabs should only be followed if your organization is not using the Nav Bar for digital experience users. If your organization would still like to use the Nav Bar in digital experience, please skip to the next section.

    6.
    1. Create a Project record page in the

    Community
    1. Experience Builder. 

    a.
      1. Click the dropdown in the top left corner. A picklist will appear.

        Image Modified
    b.
      1. Scroll to the bottom of the Picklist and click the “+ New Page” button. A pop-up will appear.

    Image Removed
      1. Image Added
    c.
      1. Select “Object Pages”.

    d.
      1. Find and select “Project” in the list of Objects.

    e.
      1. Click “Create”. You will be navigated to the new Project Detail Page template.

    7.
    1. Click into the Tab component. Click “Add” and customize the labels of the Visualforce pages or Lightning

    Component
    1. Web Components you want to make available in the digital experience.

    Image Removed
    1. Image Added
    8.
    1. Click into a tab (e.g. Add Results). From the Components menu on the left, drag the relevant Lightning Component (i.e. Visualforce Page for AddResults or the custom ActivityChart Lightning Component for Activity Tracking) into the tab’s space. 

    Image Removed
    1. Image Added
    9.
    1. If a Visualforce Page was added in the previous step, a popup will appear in the top right. In the popup, select the Visualforce page to display in the tab. Customize as needed the Height (in pixels) field. Leave Record ID at the default value.

    Image RemovedImage Added
    Image RemovedImage Added
    10.
    1. Repeat Steps 7-9 for each Visualforce page that needs to be made available to

    community
    1. digital experience users.

    11.
    1. To add the custom manageIndicators Lightning Web Component, the Record ID property must be manually set. Input {!recordId} into the text field under Record ID so that the component will render properly.

    a.
      1. Note this value is case-sensitive and must be entered exactly as shown below.

        Image Modified
    12.
    1. Click “Publish”.

    Set Up Amp Impact Submissions

    Info

    Read more about Amp Impact Submissions here.

    Info

    The steps in this section are only required if digital experience users will be filling out Submissions. If this is not required for your use case, please skip to the next section. If digital experience users will be using Submissions in another manner (i.e. reviewing submissions), please refer to the Amp Impact Installation Guide to understand how to customise the pages for that use case.

    1. Click on the Navigation Menu. A popup will appear on the top right.

    Image Removed
    1. Image Added
    2.
    1. Click “Navigation Menu” button. Another popup will appear.

    3.
    1. Click “+ Add Menu Item” button. 

    4.
    1. Name Menu Item as “Submissions”, select Type as “Salesforce Object”, and select Object Type as “Submission”. You can leave the Default List View at “Default”. Click “Save Menu”.

      Image Modified
    5.
    1. Create a Submission record page in the Digital Experience Builder. 

    a.
      1. Click the dropdown in the top left corner. A picklist will appear.

        Image Modified
    b.
      1. Scroll to the bottom of the Picklist and click the “+ New Page” button. A pop-up will appear.

    Image Removed
      1. Image Added
    c.
      1. Select “Object Pages”.

    d.
      1. Find and select “Submission” in the list of Objects.

    e.
      1. Click “Create”. You will be navigated to the new Submission Detail Page template.

    6.
    1. Add the SubmissionResponseForm component to the Submission Detail Page.

    a.
      1. Expand the Lightning Components Menu on the left side of the builder.

    Image Removed
      1. Image Added
    b.
      1. Find the SubmissionResponseForm component in the Custom Components section of the list.

    c.
      1. Drag and drop the SubmissionResponseForm below the Record Detail component.

    7.
    1. Click “Publish”.

    Set Up Multi-Language Capability - Optional

    This step is intended for users and systems that utilize the multi-language capability with of Amp Impact. To ensure multi-language compatibility of that Lightning Web Components for users are compatible with non-English user locales, it is necessary to enable Languages within the Digital Experience must have Languages enabled. This enables multi-language support and ensures compatibility for users with non-English user locales.

    1. Click on the Gear icon to access Settings from Community Builder.

    2. Under Settings, click “Languages”.

      Image Modified
    3.
    1. Click “Add Languages”.

    Image Removed
    1. Image Added
    4.
    1. Select language(s) from the available languages list and add it to the community languages list.

    Image Removed

    In Digital Experience Workspace

    1. In “Administration”, click “Members”. Add the “Amp Impact Community Profile” to the multi-select picklist. Click “Save”.

    Image Removed

    2. Click the icon in the top left corner to bring down the sidebar. Click “Settings”, and click “Activate Digital Experience”.

    Image Removed
    1. Image Added