Set Targets for Project Indicators using the Lightning Web Component Interface

Set Targets for Project Indicators using the Lightning Web Component Interface


This page covers:


Overview of Targets in Amp Impact

Targets are anticipated values for a Project Indicator. Typically, organizations compare their Results against Targets to evaluate their performance or progress toward their goals. 

Depending on an organization's impact measurement processes, they can set Targets by Project Indicator for different timeframes (Reporting Periods) and locations (Geographic Areas). Organizations often set Targets for all of their Project Indicators across multiple timeframes (even through the life of the project) to plan out the intended progress of Project Indicators over time*.

*Lightning Web Component The Lightning Web Component Set Targets interface allows users to set Targets for multiple Reporting Periods simultaneously, making it easier to plan out goals for a longer period.


Set Target Page Options: Visualforce Page vs. Lightning Web Component

As with Frameworks and Indicator pages, Amp Impact comes with two options for Setting Targets for Indicators: Visualforce and Lightning Web Component. Depending on which option your organization uses, you would need to navigate to different sections of this guide to ensure the steps outlined here corresponds with what you’ll see in your system. Check with your System Administrator if you’re unsure which option you are using.

Description

Visualforce Page

Lightning Web Component

Description

Visualforce Page

Lightning Web Component

Set Targets for multiple Reporting Periods on the same page

Set Baseline Values for a Project Indicator before entering Result data over time.

Set Targets for Picklist Indicators.

Display deactivated Reporting Periods on the Set Targets page. 

Upload/Download Targets from/onto an Excel Sheet.

Configurable Comment Pop-up

Set Targets for Numerator/Denominator Indicators


Set Targets for Project Indicators using the Lightning Web Component Lightning Web Component

Before you can set Targets for your Project Indicators, there are a couple of Project setup-related tasks to complete:

  1. Set project-specific Reporting Periods

  2. Create Geographic Area records

  3. Set up Project Indicators

If any of these elements are missing, you’ll get a message saying: “The Project is not linked to at least one Project Indicator for a Reporting Period and Geographic Area.”

Here is a screenshot of what you’ll see if the data setup is done correctly. When the Set Targets table is loaded, the “Target Frequency” and “Geographic Area” dropdowns have default values selected. The Project Indicators corresponding to these selections are displayed on the Set Targets table.

  1. Select a value from the “Target Frequency” dropdown - It shows all the frequencies for which Reporting Periods and related Project Indicators exist in the Project. For example, an organization might set targets for annual, quarterly, and monthly timeframes and have Reporting Period records for four years to cover those timeframes (e.g. Annual = 2022, 2023, 2024, 2025; Quarterly = Q1 2022, Q2 2022, up to Q4 2025, etc.) The first Target Frequency is selected by default so remember to check and update the value if you’re setting targets for another period.

On selecting a particular Target Frequency (eg, Quarterly), all Reporting Periods with that frequency (eg, Q1 2022, Q2 2022 etc) are displayed on the Set Targets table.

  1. The Lightning Web Component allows you to set Targets for multiple Reporting Periods in one go.

  2. The Set Targets table will only display the Project Indicators for the Target Frequency that you selected.

Note: The two fields that determine the frequency of Target data of a Project Indicator are the “Target Frequency” and “Reporting Frequency” fields. If the Target Frequency field is empty, then the Reporting Frequency will be referenced in the dropdown.
For more information, refer to Create & Manage Indicators | Create Project Indicators from the Indicator Catalog

2. Select a value from the “Geographic Area” dropdown - It shows all the active Geographic Areas that exist in the Project. On selecting a value, all Project Indicators for the Geographic Area that you selected will be displayed on the Set Targets table.

  1. Targets can only be set for one Geographic Area at a time.

  2. Remember to check and update the Geographic Area value in the dropdown, if you’re setting Targets for any other Geographic Area than the one that is shown by default when the page is loaded.

In the table:

  • Each Project Indicator is hyperlinked to its record. Clicking on it will open the Project Indicator record in a new tab.

  • Each Project Indicator also has an Information icon in the Project Indicator column. When you hover over the icon, a pop-over displays the additional information stored on the Project Indicator record. Read more about the Information Popup here.

Note: There are numerous ways to define the order of the Project Indicators on this page. Contact your System Administrator if you have specific requirements for the ordering of Project Indicators or visit this section learn more about Project Indicator ordering.

Enter Target Values For Project Indicators Lightning Web Component

Once your Project Indicator and related Project data setup are done, you’re ready to start setting targets. Typically, there are two kinds of Project Indicators to set targets for:

Non-Disaggregated Project Indicators

These are exactly what they say: Project Indicators that are not disaggregated by sex or by a disaggregation group. Typically, these are a bit more straight-forward when it comes to data entry and management. Just enter the values in the input field depending on the Data Type of the Indicator.

Disaggregated Project Indicators

These Project Indicators are either disaggregated by sex or by a disaggregation group or both.

As of the Phoenix Release (v1.45), they can also be disaggregated by multiple custom groups, and also cross disaggregated by sex additionally.

It takes a few more clicks when it comes to data entry and management. Be on the lookout of hyperlinks and plus signs as these might point to Project Indicators with Target Value Disaggregations.

Not sure if Target Values are Disaggregated?
A simple way to know if the Targets for a particular Indicator are disaggregated or not (on loading the page initially) is to look at the input field.

  • A rectangular input box indicates that the Target is not disaggregated.

  • A “+” icon denotes that a Target is disaggregated.

For both disaggregated and non-disaggregated Project Indicators, targets values need to be entered depending on the Data Type of the Indicator. This is defined on the Project Indicator level and summarized in the table below. These Target values are saved in the Result record.

Data Type 

Format of Input Field on Set Targets Table

Relevant Fields on Result Record

Data Type 

Format of Input Field on Set Targets Table

Relevant Fields on Result Record

Quantitative

(Number / Currency / Percent/ Numerator/Denominator)

 

The following is accepted as input in the input field:

  1. Numbers as represented in Salesforce supported locales. 

  2. Decimal symbols such as ‘.’ , ‘,’ etc depending on the locale

  3. The number of digits that can be entered after a decimal place for a quantitative Project Indicator can be set using the “Number of Decimal Places Allowed” field. It allows you to choose between 0-2 places after the decimal point. Depending on the selection, up to 16 digits can be entered before the decimal place, and 0-2 digits can be entered after the decimal place. 

Thousand separators will be added to the number, on clicking out of the input field after entering the value, depending on the user’s locale.

For Project Indicators with Data Type Currency, the input field will display the Project Indicator’s Reporting currency code to the right of the input field. 

For Project Indicators with Data Type Percent, the input field will display a percentage (%) sign to the right of the input field.

 Mira 1.37 onwards

For Project Indicators with Data Type Numerator/Denominator, separate Numerator and Denominator values cannot be entered while setting Targets or Baselines. Targets and Baselines for this data-type are set on an overall Indicator level.

A percentage (%) sign is displayed to the right of the input field when the Calculation Factor is set to 100.

Nashira v1.38 onwards
For Project Indicators with Data Type Numerator/Denominator, whenever the Calculation Factor is not set to 100, (for example it is set to 10000),then “per 10000” is displayed next to the input field following locale number representation.

quasar v1.47 onwards

For Project Indicators with Data Type Numerator/Denominator, separate Numerator and Denominator values can now be set for Baselines, learn more here. Targets will continue to support only final Percent value entry.

  • Target Value 

  • Female Target

  • Male Target

  • Unknown Target

Milestone

Input fields will display a dropdown with Yes and No as values. By default, the value “None” will be shown on the dropdown. 

  • Target Milestone Value 

  • Female Target Milestone

  • Male Target Milestone

  • Unknown Target Milestone

Picklist 

Input fields will display a dropdown with values as defined by the user while creating the Project Indicator. By default, the value “None” will be shown on the dropdown. 

If a Picklist Value is deleted on the Project Indicator record after entering Targets, the input dropdown for the particular Project Indicator will display “Select An Option”. 

  • Target Qualitative Value 

  • Female Target Qualitative

  • Male Target Qualitative

  • Unknown Target Qualitative

  • Picklist Target Numeric Value

  • Female Picklist Numeric Value

  • Male Picklist Numeric Value

  • Unknown Picklist Numeric Value

Qualitative

A plus icon will be displayed. When the plus icon is clicked, it opens a pop-up that accepts rich text input. Once Targets are entered, a pencil icon is displayed on the Set Targets table. Hovering over the icon will give a preview of the Target entered. 

  • Target Qualitative Value 

  • Female Target Qualitative

  • Male Target Qualitative

  • Unknown Target Qualitative

Enter Baseline Values for Project Indicators Lightning Web Component

Organizations often need a way to track an Indicator’s Baseline data prior to their interventions. Users can enter Baseline data on the Set Targets Lightning Web Component to both define the initial state of their stakeholders prior to their intervention and to set Targets according to the assumed change from the Baseline state.

  1. To set Baseline values for Project Indicators select Baseline from the “Target Frequency” dropdown. The Baseline frequency will only be displayed in the dropdown once Reporting Period for Baseline has been created. Visit this page to review instructions for creating Baseline Reporting Periods.

  2. When you select “Baseline” in the “Target Frequency” dropdown and a selection is made in the “Geographic Area” dropdown, all Project Indicators that have a baseline will be displayed in the Set Targets table. 

Ensure that the “Has Baseline?” checkbox field is marked as TRUE while creating/editing the indicator on the Manage Indicators page, to set a Baseline value for a Project Indicator. 

  1. Baseline values for Project Indicators (for the Baseline Target Frequency) can be entered for multiple Reporting Periods periods similarly to Targets.

  2. Baseline data can also be compared and viewed against Result data. Read more about it here. 

If a Project Indicator has

  1. “Cross-Disaggregation by Sex” selected or if the “Disaggregation Group” field populated;

  2. “Targets are Disaggregated?” is selected;

  3. “Has Baseline?” is selected;

then, the Baseline values will be disaggregated but the Target values will not be disaggregated.

Tracking Numerator and Denominator values for Baseline:  quasar (v1.47) onwards

When the “Track Numerator Denominator for Baselines” checkbox is selected for a Numerator/Denominator type indicator, the Baseline input popup displays separate Numerator and Denominator fields. The Baseline value is then automatically calculated using the formula: (Numerator ÷ Denominator) × Calculation Factor.

Enter num den data for Baseline.gif

The final resultant Baseline value after the calculation is displayed with 0 decimal places by default. This value is controlled using the “Number of Decimal for Resultant Value” field. Users can show upto 2 decimal places.
Amp Impact supports upto 15 characters for the Resultant Baseline Value for Numerator/Denominator indicators.

The entered numerator/denominator Baseline data can then be compared with Results on the addResults LWC popups.

Compare num den breakdown for Baselines on AR.gif

If the “Track Numerator Denominator for Baselines” checkbox is not checked during the creation of a Project Indicator, users can manually enter only the final Baseline Percent value, rather than separate Numerator and Denominator values:

Track num den FALSE.gif

Enter Target Values & Comments for Non-Disaggregated Project Indicators Lightning Web Component

 Enter the Target values next to the relevant Project Indicator for the relevant Reporting Period. For non-disaggregated Project Indicators, Target data is auto-saved for each input field after you enter a value and click out from the data input cell. Target data is not deleted by simply removing values from this table. Target data has to be manually deleted from the Results object. Contact your System Administrator if you require support with this.

Additionally, each Project Indicator row on the Set Targets table has a Comment icon. A comment pop-up is displayed when you click on this icon to add or edit any additional qualitative information about that Target value. Hover over the comment icon to display a preview of the comment after entering its target(s).

Note: With the Libertas (v1.35) Release, users can add images, links and other rich text in comments since it is controlled by a field set. Read more about it here

Enter Target Values & Comments for Disaggregated Project Indicators Lightning Web Component

The Set Targets table also allows you to capture Targets for Project Indicators that are Disaggregated by Sex, Age, Income, etc. The fields that control disaggregation of Target data on the Set Targets table are:

  • Targets are Disaggregated?  

  • Cross-Disaggregation by Sex

  • Disaggregation Group(s)

  • Disaggregation Type (introduced in Phoenix 1.45)

These fields are populated while creating or editing a Project Indicator. 

Target values will be Disaggregated only when the “Targets are Disaggregated?” checkbox field is marked as TRUE while creating/editing an Indicator on the Manage Indicators page.

If the “Cross-Disaggregation by Sex” checkbox field is marked as TRUE or the “Disaggregation Group(s)” field has a value, but the “Targets are Disaggregated?” checkbox field is marked as FALSE, Results and Baseline will be Disaggregated, but Targets will not be disaggregated. 

There are a few clicks to enter disaggregated Target values for a particular Reporting Period: 

  1. Click on the plus (+) icon displayed. 

  2. A pop-up appears when entering Targets, with the number and format of input fields dynamically determined by the following fields:

    • Data Type

    • Disaggregation Group(s)

    • Cross-Disaggregated by Sex?

    • Calculate Total

    • Disaggregation Type (added in the Phoenix Release, v1.45)

    The pop-up header displays, in order:

    1. The Indicator Definition

    2. The selected Geographic Area

    3. The Reporting Period for which targets are being entered

    To view more details about a Project Indicator, hover over the information icon.

    The format of the input fields in the pop-up aligns with the selected “Data Type”. The layout of the pop-up adjusts based on the values selected for “Calculate Total”, “Disaggregation Group(s)”, and “Cross Disaggregation by Sex”. For more details refer to this page. If a Project Indicator is disaggregated by more than one group, the “Disaggregation Type” field (introduced in v1.45) also influences the display. You can scroll horizontally or vertically within the pop-up to view all input fields.

    1. Phoenix v1.45 Onwards If the “Disaggregation Type” is set to Nested, users will see the Disaggregation Groups displayed as columns in the pop-up.

      The order of these columns follows the sequence in which the groups were added in the Disaggregation Group(s) field when creating the Project Indicator:

      • The first group (primary group) appears as the leftmost column.

      • All subsequent groups are nested within it, displayed as columns to the right.

       

      For example, if the Disaggregation Group(s) field includes Age Group (Women) followed by Economic Activity Sector, the columns in the pop-up will reflect that order: Age Group (Women) on the left, and Economic Activity Sector nested within it to the right.

Phoenix v1.45 Onwards For Project Indicators disaggregated by multiple groups, where Disaggregation Type = Nested, users have the option to hide totals while entering or analyzing targets.
This applies to indicators with Number, Currency, data types where Calculate Total = Sum Total.

b. Phoenix v1.45 Onwards If the “Disaggregation Type” is set to Stacked, users will see Disaggregation Groups displayed as rows in the pop-up.

The order of these rows follows the sequence in which the groups were added in the Disaggregation Group(s) field when creating the Project Indicator:

  • The first group (primary group) appears at the top.

  • Its disaggregation values are listed as rows directly beneath it.

  • All subsequent groups are also stacked as rows below, with their group names highlighted in grey for clarity.

For example, if the Disaggregation Group(s) field includes Age Group (Women) followed by Economic Activity Sector, the rows in the pop-up will reflect that order from top to bottom: Age Group (Women) on top, and Economic Activity Sector stacked below it.

  1. Enter the targets in the pop-up. Target data will only be saved when the “Save” button is clicked.

    1. As of the Phoenix Release (v1.45), for Project Indicators disaggregated by multiple groups with Disaggregation Type = Stacked , a warning message will appear upon clicking “Save” if the totals across groups are not equal. In such cases, the total for the primary group will be highlighted with an orange border to help users quickly identify the mismatch. This is applicable to Data Types = Number, Currency with Calculate Total = Sum Total.

  2. On clicking the “Save” button and navigating back to the Set targets table, the plus (+) icon, will either be replaced by

    1. A hyperlinked numerical value (for Quantitative Indicators that have Calculate Total set to Sum Total), or

    2. A pencil icon (for all Qualitative Indicators and those Quantitative Indicators that have Calculate Total equal to Don’t Sum Total).  

c. Phoenix v1.45 Onwards When Disaggregation Type= Stacked and totals across groups do not match, the target of the primary group will be displayed on the Targets table.

If Targets/Baseline values have been added for a Project Indicator, the “Dissaggregation Group” field cannot be edited. We do not recommend editing the “Cross-Disaggregation by Sex” field after adding Results for a Project Indicator as it may cause the Add Results LWC to malfunction. 
As of the Phoenix release, editing Disaggregation Group(s) and Disaggregation Type field after adding result records leads to an error. Read more here

 

For disaggregated Project Indicators, the Comment icons will be shown inside the Disaggregation pop-up. 

  1. For Project Indicators that are Disaggregated by Sex, one comment icon is entered across the Male, Female, and Unknown Targets. 

  2. For Project Indicators that are Disaggregated by Group, one Comment can be entered for each Disaggregated value in the group. 

Click on the comment icon to display or add new comments. Hovering over the Comment icon displays a preview of the saved comment.

As of the Orion Release (v1.41), it possible to lock comments after submitting the targets and results through a design attribute.

As of the Phoenix Release (v1.45), the comments are displayed in the rightmost column on the popup.

Target Values & Validation Ranges Lightning Web Component

Validation ranges for Project Indicators facilitate better data quality. These are set at the Project Indicator level.

If the Target value entered is less than the value set in the “Validation Range Minimum” field or more than the value set in the “Validation Range Maximum” field on the Project Indicator, a warning message appears at the top of the page and the input field is highlighted with an orange border. The Target value will still be saved even if it falls outside of the Validation Range.

Submit Targets for Review Lightning Web Component

Some organizations have a process in place to submit, review, and lock Target data for editing once it is approved. If this feature is enabled, the “Submit” button can be used to lock the Targets. 

  1. Click on the “Submit” button.

  2. Select the Reporting Periods for which the Targets need to be submitted.

  3. A pop-up then confirms if Targets need to be submitted for the selected Reporting Period or not. Click  Submit to confirm. Click back to go to the previous step.  

The Targets are submitted once the user clicks the “Submit” button. If a Reporting Period has been submitted, its column will display as read-only, with a lock icon in the header. The “Upload” button is also greyed out to prevent any additional Targets from being uploaded. 

Disaggregated target data or qualitative targets can still be viewed by clicking on the hyperlinked total value or eye icon, which will open a read-only version of the disaggregated data entry popup.

When Targets/Baselines/Reporting Periods are locked via the “Submit and Lock Wizard” users will see the same interface as mentioned above. This Wizard is available from Mira Release (v1.37) onwards

System Admin Note:

  1. When the “Override Locked Targets” custom permission is assigned to a user they can make edits to targets even if Set Target LWC has been locked.

  2. When the “Override Locked Baselines ” custom permission is assigned to a user they can make edits to baseline values even if Set Target LWC has been locked.


Read more here

Multiple Users Making Updates Simultaneously: Refresh the Set Targets Component Lightning Web Component

Often, there are a number of users in the system, entering and managing data simultaneously. If another user makes and saves updates on a component or a related component (like the Framework or Project Indicators) while you’re working in the system, you’ll see a notification that alerts you that changes have been made. Click on the “Refresh” icon to load and reflect the latest data on the Set Targets component along with all the Targets that have been previously recorded. For example, if the Project Indicator Definition is edited or a Geographic Area is marked Inactive, these changes will be reflected once the Set Targets component is refreshed.