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 |
---|---|---|
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. |
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:
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.
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.The LIGHTNING WEB COMPONENT allows you to set Targets for multiple Reporting Periods in one go.
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 https://verasolutions.atlassian.net/wiki/spaces/AIEP/pages/3733192705/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.
Targets can only be set for one Geographic Area at a time.
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.
There is a Search and Filter box at the top of the table that can be used to find specific Project Indicators to add Targets for. Use “From End Date” and “To End Date” to define a date range and filter specific reporting periods for the selected Target Frequency. This will help reduce loading time on the page when there are a lot of reporting periods for a particular frequency.
Refer to this section if you want to make changes to this interface or filter functionality.
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. By default, Objectives, Guidelines, Disaggregation Groups, and Cross-Disaggregated by Sex are shown.
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 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.
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.
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.
Baseline values for Project Indicators (for the Baseline Target Frequency) can be entered for multiple Reporting Periods periods similarly to Targets.
Baseline data can also be compared and viewed against Result data. Read more about it here.
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. 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 |
---|---|---|
Quantitative (Number / Currency / Percent) | The following is accepted as input in the input field:
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. |
|
Milestone | Input fields will display a dropdown with Yes and No as values. By default, the value “None” will be shown on the dropdown. |
|
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”. |
|
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. |
|
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 controlled by a fieldset. Read more about it here
Enter Target Values & Comments for Disaggregated Project Indicators LIGHTNING WEB COMPONENT
There are a few clicks to enter disaggregated Target values for a particular Reporting Period:
Click on the plus (+) icon displayed.
A pop-up will appear where the number and format of input fields vary based on the “Data Type”, “Disaggregation Group”, “Cross-Disaggregated By Sex?”, and the “Calculate Total” fields. The pop-up header displays the “Indicator Definition” field, selected Geographic Area, and the Reporting Period for which Targets are being entered in that order. To see more details about a Project Indicator, simply hover over the information icon.
In the pop-up, the input field formats for each Data Type are followed.
If the Project Indicator is Cross-Disaggregated by Sex, input fields are displayed in the Male, Female, and Unknown columns.
If the Project Indicator has a Disaggregation Group, input fields are displayed in the rows of the disaggregated values.
If the value of “Calculate Total” field is set as Sum Total, an additional column and row for the Total value is displayed.
Scroll horizontally or vertically within the pop to view all input fields.
Enter the Targets in the pop-up. Target data entered in the pop-up will only be saved when the “Save” button is clicked.
Once Targets have been added, the plus (+) icon will either be replaced by
A hyperlinked numerical value (for Quantitative Indicators that have Calculate Total set to Sum Total), or
A pencil icon (for all Qualitative Indicators and those Quantitative Indicators that have Calculate Total equal to Don’t Sum Total).
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.
For disaggregated Project Indicators, the Comment icons will be shown inside the Disaggregation pop-up.
For Project Indicators that are Disaggregated by Sex, one comment icon is entered across the Male, Female, and Unknown Targets.
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.
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.
Click on the “Submit” button.
Select the Reporting Periods for which the Targets need to be submitted.
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. Disaggregated target data or qualitative targets can still be viewed by clicking into the hyperlinked total value or eye icon, which will open a read-only version of the disaggregated data entry popup.
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.
Set Targets for Project Indicators using the Visualforce Page VISUALFORCE PAGE
Before you can set Targets for your Project Indicators, there are a couple of Project setup-related tasks to complete:
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 “Reporting Period” and “Geographic Area” dropdowns have default values selected. The Project Indicators corresponding to these selections are displayed on the Set Targets table.
Select a “Reporting Period” that you want to enter Target values for. Only Reporting Periods that are related to Project Indicators will be displayed in this list. The first Reporting Period is selected by default so remember to check and update the Reporting Period value if you’re setting targets for another period.
Select a “Geographic Area” that you want to enter Target values for. Only Geographic Areas that are marked as “Active” will be available. Targets can only be set for one location at a time. The first value in the list of Geographic Areas is selected by default so remember to check and update the Geographic Area value if you’re setting targets for another area.
The list of available Project Indicators that are related to the selected Reporting Periods and Geographic Areas will be displayed in the table with the option to add Target values.
Note: A default Target Reporting Period can be selected for the Project which controls the Reporting Period displayed on the filter above when any user first navigates to the Set Target page. Deactivated Reporting Periods will be displayed on the Set Targets Visualforce page.
4. By default, the Project Indicator Definition (or the translated value if applicable) is displayed on the left side of the table.
5. 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.
6. There is a Search and Filter box at the top of the table that can be used to find specific Project Indicators to add Targets for.
7. Each Project Indicator row has a comments icon. When clicked, a Comments pop-up window displays to track any notes/guidelines the user wants to track. These are saved to the Comments field on the Result object.
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 page to learn more about Project Indicator ordering.
Enter Target Values For Project Indicators VISUALFORCE PAGE
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 without disaggregation groups defined. 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. It takes a few more clicks when it comes to data entry and management.
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 |
---|---|---|
Quantitative (Number / Currency / Percent) | The following is accepted as input in the input field:
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. |
|
Milestone | Input fields will display a dropdown with Yes and No as values. By default, the value “None” will be shown on the dropdown. |
|
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. |
|
If the Target value is disaggregated, the Disaggregation Groups will be displayed below that Project Indicator and you’ll have the option to enter Target values for each of the Disaggregation Groups.
Consider the following when entering Target values:
Target data is auto-saved for each input field after the user enters a value and clicks 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.
Target values and Result values can be reported on for different Reporting Periods (e.g. you’d set Targets annually but report on Results quarterly). This is defined on the Project Indicator level.
Target Values & Validation Ranges VISUALFORCE PAGE
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 VISUALFORCE PAGE
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.
Users are able to submit Targets for multiple Reporting_Period__c records, if applicable. For example, a user may need to submit Targets for Chile for quarter 2 and the semi-annual report. They can go to the relevant Reporting Periods, enter data, and then submit.
Users have the option to create workflows that trigger certain actions with the click of the “Submit” button. For example, clicking on the Submit button can set a specific Status and generate an email notification. OnClick of “Submit’ on the SetTargets page, Target_Status__c = Submitted, thus making the SetTargets page uneditable. To make the page uneditable when any other status is selected, the The Target_Status__c field can also be configured through a workflow to edit the Targets_Locked__c field which can lock the target input fields for that Reporting Period and Geographic Area un-editable so that users can no longer make any changes to the data entered.
On the SetTargets page, the Results display as output fields when
The field Target_Locked__c = TRUE for a Reporting Period, OR
Target_Status__c = Submitted
When the Results appear as output fields, the user cannot edit the Targets entered. Project Indicators with Data Type = Qualitative will display a “View” icon.
Once the user clicks the “Submit” button, the “Upload” button is greyed out to prevent any additional Targets from being uploaded.