Add complex goal criteria
Applies to Dynamics 365 for Customer Engagement apps version 9.x
If you want to add complex rollup criteria for a goal, you can use a rollup query (
GoalRollupQuery) entity. For example, you can specify revenue for a particular product line or revenue generated in a specific territory.
A rollup query can be used by different goals. However, a rollup query associated with a particular goal, applies only to that goal. A rollup query specified for a parent goal does not propagate to the child goal. A child goal can use the same query or a different query. A rollup query should use the same entity types that are specified in the rollup field records associated with the goal. If the goal tracks the sales order revenues, but the associated query uses the opportunity entity, an exception is thrown when you create or update the goal record.
The maximum number of records that can be returned in a goal rollup query is 5000.
To specify query criteria, use the
GoalRollupQuery.FetchXml attribute. To specify the entity type for the query, use the
The entities that can be specified in the
GoalRollupQuery.QueryEntityType attribute must have the following
EntityMetadata attributes set to
CanCreateAttributes. The following entities cannot be specified in this attribute:
Depending on the goal metric type, you can use the queries to filter actual, in-progress, and custom amount or count data. The following table shows the goal metric types and the goal entity attributes that you can use to specify the queries for each type.
|Goal metric type||Rollup query attributes|
|Amount (integer) or Count||
The query for the goal's participating records for a given rollup attribute should include the following clauses:
A FetchXML expression specified in
Date range (
RollupField.DateAttribute), state and status specified in the respective rollup field for the referenced goal metric.
Preventing Double Counting and Other Erroneous Results
Queries are very effective in filtering the results of a rollup. However, if not used carefully, they can introduce the “double counting” or other erroneous results. The following examples demonstrate how queries may contribute in unwanted results:
You are tracking the sales orders for a particular salesperson. However, the rollup did not return any sales orders. This can happen if the query that you used filtered out the territories where the salesperson has customers.
You set two goals for a salesperson. One goal tracks the opportunities for a particular product and another goal tracks the opportunities in a particular territory. If the opportunity includes selling the specified product in the specified territory, the revenue from this opportunity is included in both goals. If the goals have the same parent goal, their totals are added to the parent goal, resulting in double counting.
You can prevent double counting and other incorrect results by following these guidelines:
trueto use only the records owned by the goal owner.
Do not assign multiple goals to a sales person for the same time period.
Do not use a query if you are not sure it will provide the results that you expect.