Versions Compared

Key

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

...

Info

The Aggregated Indicators functionality may be impacted if your organization runs multiple Salesforce packages and apps, as the API names may conflict and interfere with aggregation queries. To prevent this, speak to your System Administrator to ensure that your organization’s custom objects have unique API names.

Here are the steps to create an Aggregated Indicator in Amp Impact:

...

  1. Click on “Save and Next”.

    Image Removed
  2. Image Added

    On the next screen, the “Customize Aggregation Criteria” popup is where the criteria are set for aggregating results. You have the option to hit cancel and return to setting the aggregation criteria at a later stage.

  3. To define the aggregation criteria, populate the following fields on the “Customize Aggregation Criteria” popup:

Popup Field

Required?

Description

Source Object

Yes

Object in Salesforce that contains the individual-level data to be aggregated.

Info

When using Aggregated Indicators in the Non Profit Cloud and the Program Management setting is turned off, the Non Profit Cloud objects will still be displayed in the “Source Object” dropdown.

How to Aggregate
(Operator)

Yes

How the data will be aggregated, i.e. Sum, Average, Count, Maximum, Minimum.

Info

When creating an aggregated Project Indicator that averages, ensure that the “Number of Decimal Points Allowed” field for that Project Indicator has been set to either 1 or 2.

Do you want to filter records?

No

Create custom filters by selecting “Some Records” to display this interface. Select fields on the Source Object in the first picklist and the filter operator in the second picklist. Type directly into the input cell to set the criteria. If multiple filters are used, select the filter logic (AND or OR) in the Specify Filter Logic’ dropdown.

  • If multiple filters are created, the user will be prompted to select filter logic

  • The following field types are not currently supported:

    • Date/Time

  • The following field types are available to use as filter criteria:

    • Record Type

    • Checkbox

    • Currency (displays according to user locale)

    • Date (displays according to user locale)

    • Formula

    • Relationship (lookup or master-detail) - criteria must use the record Id

    • Number

    • Percent

    • Picklist (single or multi-select)

    • Text

Do you need to de-duplicate?

No

This feature allows the user to choose whether multiple records with the same value in a specified field are considered individually or together when aggregating.

Reporting Period based on

Yes

The date field on the Source Object that determines which Reporting Period an individual record will be aggregated to.

Geographic Area based on

Yes

The field on the Source Object (or any of its parent objects) that determines which Geographic Area an individual record will be aggregated to.

Active

No

This checkbox controls whether the criteria is active and creates or updates Results when the batch is run.

...

  1. Select the field that sex is based on. This field may sit on an immediate parent record.

  2. Map the possible values in the field selected in a. to Amp Impact’s sex disaggregation values
    (Male, Female). As depicted below, the Amp Impact sex disaggregation values are listed to the left
    of the input boxes. For each sex disaggregation value, enter the corresponding field value to be
    mapped to that disaggregation (e.g. M for Male).

    1. Multiple values can be mapped to the Male and Female sex disaggregation values. For
      example: “Man”, “M”, and “Male” can all map to the Male sex disaggregation value when
      specifying aggregation criteria for an Aggregated Indicator.

      Image RemovedImage Added
    2. Any source records that do not match the “Male” or “Female” mapped values are
      automatically mapped to the “Unknown” disaggregation. Upon refreshing the Aggregated Project Indicator, the result values for the “Unknown” column will be populated on the AddResults
      table for the corresponding Geographic Area and Reporting Period.

...

  1. Select the field that the disaggregation is based on. This field may sit on an immediate parent record.

    Image RemovedImage Added
  2. Map the possible values in the field selected in “A” “Small (1-4)” to the custom Disaggregation Values. Multiple field values may be mapped to each custom Disaggregation Value by using commas to separate the field values.

...

  1. On the Managed Indicator page, click on the dropdown icon next to the indicator and click “Update Results”. Note that this option will only be shown if the Project Indicator is calculated or aggregated.

  2. A popup will open with the date and time of any previously run aggregations displayed.

    1. If no aggregations have been run previously, then the date and time field will be blank.

    2. If any aggregations have been run previously, the date and time are displayed in the user’s locale.

      Image Removed

      Image Added

Info

The header, body text, and button labels in the popup are controlled by custom labels. Reach out to your System Administrator to know more.

  1. While the result(s) are being updated, users cannot edit, delete or deactivate the aggregated Project Indicator. The following buttons are greyed out on the Manage Indicator page:

    1. The dropdown menu button next to the calculated indicator

    2. “Update Results” button

    3. It is also recommended to refrain from using the “Update Results” or “Submit Results” button on the Add Results while the results are being updated.

  2. The results will populate on the Add Results page only if all of the data required has been entered:

    1. Aggregation criteria have been correctly set up.

    2. Records for the Source Object exist.

  3. Refresh the Add Results page to see the most accurate results. The “Last Aggregation Date” field will also be updated.

Info

If an existing aggregated indicator is marked as not active then results will not be updated. The Add Results page will show the last aggregated result from when indicator was active.

...

There are two ways to initiate a batch update for all Aggregated and Calculated Project Indicators: From the Manage Indicators table and from the Add Results page.

...

Info

Choose where to update Results: If you update Results from the Manage Indicators Table all the Project Indicators across Geographic Areas and Reporting Periods will be updated. However, if you initiate the update from the Add Results Page, only the Project Indicators for the selected Geographic Areas and Reporting Periods will be updated.

Update Results from the Manage Indicators Table
  1. Navigate to the Manage Indicators page and click on the “Update Results”button to run a batch update for all the Aggregated and Calculated Indicators.

    Image RemovedImage Added
Info

Note, this button will not display if there are no aggregated or calculated indicators in the Selected Indicators table.

  1. A popup will display to confirm the batch. Click “Confirm” to run the batch.

Info

The header, body text, and button labels in the popup are controlled by custom labels. Reach out to your System Administrator to know more.

  1. On confirmation, the batch runs for all Calculated and Aggregated Indicators in the project.

  2. While the batch is processing, users cannot edit or delete the Calculated and Aggregated Project Indicators. The following buttons are greyed out:

    • The dropdown menu buttons next to all Calculated and Aggregated Indicators;

    • “Update Results” button on the Manage Indicator page.

  3. The user is notified via email when the batch is complete and the results are updated.

  4. When the batch is complete, the buttons will display again. Results for the corresponding Calculated and Aggregated Project Indicators will be populated on the Add Results page. Refresh the Add Results page to see the most accurate results. The “Last Aggregation Date” will also be updated.

Info

Time to wait: We recommend that users don’t update results or submit results via the AddResults page while the batch is running. Users can navigate away from the ManageIndicators page until the batch is completed.

...

  1. Navigate to the Add Results page and click on the drop-down on the right.

  2. In the dropdown, select the option to “Update Results”.

  3. A confirmation popup will be displayed to confirm that the Calculated and Aggregated Project Indicator results will be updated for the current Geographic Area and Reporting Period.

    While the batch is processing, users will not be able to
Info

The header, body text, and button labels in the popup are controlled by custom labels. Reach out to your System Administrator to know more.

  1. While the batch is processing, users will not be able to submit or update the results for these indicators. The “Submit Results” and “Update Results” buttons will be greyed out and inactive.

  2. A clock icon will be displayed next to theAggregated and Calculated Indicators to display that they are being updated.

...

  1. Image Added
Info

We recommend users to refrain from editing indicators and updating their results vai via the Maange Manage Indicator page while the the batch is running.

  1. The user is notified via email when the batch is complete and results are updated.

  2. A success message is displayed once the batch is updated. The buttons will display again and users can refresh the Add Results page to see the most accurate results. The “Last Aggregation Date” field will also be updated.
    <<add screenshot>>the Add Results page to see the most accurate results. The “Last Aggregation Date” field will also be updated.

Stop Aggregating Data

If data is no longer being collected for an Aggregated Indicator or the aggregation no longer needs to be calculated, the user can deactivate the Aggregation.

  1. Click on the dropdown next to the indicator and click edit.

  2. On the Customize Project Indicator popup, scroll to the bottom and uncheck the Active checkbox field.

  3. Click Save.

...

Once the Active checkbox is false, when a user clicks on the Refresh icon to aggregate data, the aggregation will not run on click of Confirm in the popup.

...

Create & Manage Aggregated Indicators
Status
colourGreen
titleVisualforce page

...

  1. The “Add New Custom Indicator” and “Aggregation Criteria” popups have a slightly different interface.

    Image Removed

    popups have a slightly different interface.

    Image Added

  2. To edit an Aggregated Indicator from the Visualforce page, user can click on the “wrench” icon next to the corresponding indicator

  3. To update results for a single Aggregated Indicator from the Visualforce page, users can click on the wrench refresh icon next to the corresponding aggregated indicator.

  4. Users can also update results for all Aggregated and Calculated Indicators using the “Refresh Indicators” button from the Manage Indicators page.

    Image RemovedImage Added
  5. On the pop-up select “Aggregated” to update results for only Aggregated Indicators

Stop Aggregating Data

If data is no longer being collected for an Aggregated Indicator or the aggregation no longer needs to be calculated, the user can deactivate the AggregationSimilar to LWC the user can stop aggregating data on an Indicator by doing the following steps.

  1. Click the Wrench icon to open the Aggregation Criteria popup.

  2. Scroll to the bottom and uncheck the Active checkbox field.

  3. Click Save.

...