AdvAccountForecastSet

Represents the forecast sets that define the forecast configurations for each business unit or different groups of accounts. With separate forecast sets at account or business unit level, you can focus on account-specific data and manage configuration updates for one business unit without impacting any other business unit’s data.

Parent Type 

This type extends Metadata and inherits its fields.

File Suffix and Directory Location 

AdvAccountForecastSet components have the suffix .advAccountForecastSet and are stored in the AdvAccountForecastSet folder.

Version 

Introduced in API version 53.0.

Special Access Rules 

The advanced account forecasting feature setting for Manufacturing Cloud is required to create an advanced account forecast set.

Fields 

accountFieldName 

  • Type: string
  • Required: No
  • Description: The field name for the account in the advanced account forecast fact record.

calculationFrequency 

  • Type: AdvAcctFcstCalcFrequency (enumeration of type string)
  • Required: No
  • Description: The frequency at which the forecast set is recalculated automatically.
  • Possible values:
    • Monthly
    • Quarterly
    • Weekly
    • Yearly

description 

  • Type: string
  • Required: No
  • Description: The description of the advanced account forecast set record.

dimensions 

  • Type: AdvAcctForecastDimension[]
  • Required: No
  • Description: The dimensions selected for an advanced account forecast set to categorize the forecast data.

displayGroups 

  • Type: AdvAcctFrcstDisplayGroup[]
  • Required: No
  • Description: The information about the groups for the advanced account forecast set measures or dimensions.

forecastAdjPeriods 

  • Type: AdvAcctForecastAdjPeriod[]
  • Required: No
  • Description: The details about the adjustment period of the advanced account forecast values.

forecastFactObjectName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The API name of the object that contains the advanced forecast fact records.

forecastFormulas 

forecastPeriodGroupName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The name of the advanced account forecast period group record.

forecastQuantityFieldName 

  • Type: string
  • Required: No
  • Description: The field name for the forecast quantity in the advanced account forecast fact record.

forecastRevenueFieldName 

  • Type: string
  • Required: No
  • Description: The field name for the forecast revenue in the advanced account forecast record.

forecastSetFieldName 

  • Type: string
  • Required: No
  • Description: The field name for the Forecast Set ID in the advanced account forecast fact record.

forecastSetName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The name of the advanced account forecast set record.

forecastStatusFieldName 

  • Type: string
  • Required: No
  • Description: The field name for the status in the advanced account forecast fact record.

generationDpeDefName 

  • Type: string
  • Required: No
  • Description: The name of the data processing engine (DPE) definition that’s used to generate advanced account forecast fact records.

measureDefinitions 

  • Type: AdvAcctForecastMeasureDef[]
  • Required: No
  • Description: The measures to display in the advanced account forecasts grid for the forecast set.

periodFieldName 

  • Type: string
  • Required: No
  • Description: The field name for the period in the advanced account forecast fact record.

recalculateDpeDefName 

  • Type: string
  • Required: No
  • Description: The name of the data processing engine definition that’s used to recalculate the advanced account forecast fact records.

regenerationDpeDefName 

  • Type: string
  • Required: No
  • Description: The name of the data processing engine definition that’s used to regenerate the advanced account forecast fact records.

rolloverDpeDefName 

  • Type: string
  • Required: No
  • Description: The data processing engine definition that’s used to generate the rollover advanced account forecast fact records.

rolloverFrequency 

  • Type: AdvAcctFcstCalcFrequency (enumeration of type string)
  • Required: No
  • Description: The frequency of rollover of the advanced account forecast records.
  • Possible values:
    • Monthly
    • Quarterly
    • Weekly
    • Yearly

status 

  • Type: AdvAccForecastSetStatus (enumeration of type string)

  • Required: Yes

  • Description: Required.

    The status of the advanced account forecast set.

  • Possible values:

    • Active
    • Inactive

AdvAccountForecastFormula Type 

Represents the formulas that are used to calculate forecast values in real time after applying the DPE calculations. For example, processing forecast rollover for all accounts at the start of a month.

Fields 

endPeriod 

  • Type: int

  • Required: Yes

  • Description: Required.

    The period until when the forecast formula is applicable.

formulaExpression 

  • Type: string

  • Required: Yes

  • Description: Required.

    The formula based on which forecast values are calculated.

formulaType 

  • Type: AdvAcctFcstFormulaType (enumeration of type string)

  • Required: Yes

  • Description: Required.

    Specifies the calculation type for the formula.

  • Possible values:

    • QUANTITY
    • REVENUE

startPeriod 

  • Type: int

  • Required: Yes

  • Description: Required.

    The period from when the forecast formula is applicable.

AdvAcctForecastAdjPeriod Type 

Represents details about the adjustment period of the advanced account forecast values.

Fields 

adjustmentDayCount 

  • Type: int

  • Required: Yes

  • Description: Required.

    The number of days during which you can make forecast adjustments.

frequency 

  • Type: PeriodTypes (enumeration of type string)

  • Required: Yes

  • Description: Required.

    The frequency that’s applicable to make any forecast adjustments.

  • Possible values:

    • Month
    • Quarter
    • Week
    • Year

profileName 

  • Type: string
  • Required: No
  • Description: The name of the profile with which you can adjust the forecast set.

startDay 

  • Type: int

  • Required: Yes

  • Description: Required.

    The start date for forecast adjustments.

AdvAcctForecastDimension Type 

Represents the dimensions selected for an advanced account forecast set to categorize the data. For example, a business unit requires forecast data for each account aggregated by product and ship-from location.

Fields 

advAcctForecastDimName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The name of the advanced account forecast dimension.

dimensionFieldName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The API name of the field for the dimension in the custom object that contains the generated advanced account forecast records.

dimensionSourceName 

  • Type: string
  • Required: No
  • Description: The name of the dimension source associated with the advanced account forecast set dimension record.

hierarchySequenceNumber 

  • Type: int

  • Required: Yes

  • Description: Required.

    The sequence number of the dimension source associated with the forecast set.

AdvAcctForecastMeasureDef Type 

Represents information about the measures to display in the advanced account forecasts grid for the forecast set.

Fields 

advAcctForecastMeasureDefName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The name of the definition for the advanced account forecast measure.

aggregationType 

  • Type: AdvAcctFcstAggregationType (enumeration of type string)

  • Required: No

  • Description: Required.

    The type of aggregation that’s used for calculating the advanced account forecast values.

  • Possible values:

    • AVERAGE
    • MAXIMUM
    • MINIMUM
    • SUM

computationMethod 

  • Type: AdvAcctFcstComputationMethod (enumeration of type string)

  • Required: No

  • Description: Required.

    The method that’s used for calculating the advanced account forecast values.

    Values are:

  • Possible values:

    • CUSTOM
    • DATA_PROCESSING_ENGINE_DEFINITION
    • FORMULA

forecastDataMeasureName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The field of the facts object used for the advanced account forecast measure.

forecastMeasureName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The name for the advanced account forecast measure to show on UI.

forecastMeasureType 

  • Type: AdvAcctFcstMeasureType (enumeration of type string)

  • Required: Yes

  • Description: Required.

    The measure type that’s used for the generated advanced forecast values.

  • Possible values:

    • QUANTITY
    • REVENUE

isAdjustmentTracked 

  • Type: boolean
  • Required: No
  • Description: Indicates whether the adjustments made to the advanced account forecast values for this metric are tracked (true) or not (false).

AdvAcctFrcstDisplayGroup Type 

Represents information about the groups for the advanced account forecast set measures or dimensions.

Fields 

advAcctFrcstDisplayGroupName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The name of the advanced account forecast display group.

displayGroupItems 

  • Type: AdvAcctFrcstDplyGroupItem[]
  • Required: No
  • Description: The items associated with a display group for an advanced account forecast set.

displayGroupType 

  • Type: AdvAcctFrcstDisplayGroupType (enumeration of type string)

  • Required: No

  • Description: The category of the display group.

    Possible value is:

  • Possible values:

    • MEASURE

isDefault 

  • Type: boolean
  • Required: No
  • Description: Indicates whether the display group is the default group (true) or not (false).

userProfileName 

  • Type: string
  • Required: No
  • Description: The name of the profile for which the display group is applicable.

AdvAcctFrcstDplyGroupItem Type 

Represents information about the items associated with a display group for an advanced account forecast set.

Fields 

advAcctFrcstDplyGroupItemName 

  • Type: string

  • Required: Yes

  • Description: Required.

    The name of the advanced account forecast display group that’s associated with the group item.

displayOrder 

  • Type: int

  • Required: Yes

  • Description: Required.

    The display order of the display group item.

measureReferenceName 

  • Type: string
  • Required: No
  • Description: The ID of the measure associated with the display group item.

Declarative Metadata Sample Definition 

The following is an example of an AdvAccountForecastSet component.

1<?xml version="1.0" encoding="UTF-8"?>
2<AdvAccountForecastSet xmlns="http://soap.sforce.com/2006/04/metadata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
3    <calculationFrequency>Quarterly</calculationFrequency>
4    <forecastAdjPeriods>
5        <adjustmentDayCount>5</adjustmentDayCount>
6        <frequency>Quarter</frequency>
7        <profileName xsi:nil="true"/>
8        <startDay>1</startDay>
9    </forecastAdjPeriods>
10    <forecastFormulas>
11        <endPeriod>12</endPeriod>
12        <formulaExpression>6</formulaExpression>
13        <startPeriod>2</startPeriod>
14        <formulaType>QUANTITY</formulaType>
15    </forecastFormulas>
16    <forecastPeriodGroupName>PeriodGroup1</forecastPeriodGroupName>
17    <accountFieldName>Account</accountFieldName>
18    <periodFieldName>Period</periodFieldName>
19    <forecastQuantityFieldName>ForecastedQuantity</forecastQuantityFieldName>
20    <forecastRevenueFieldName>ForecastedRevenue</forecastRevenueFieldName>
21    <forecastFactObjectName>AdvAccountForecastFact</forecastFactObjectName>
22    <forecastSetFieldName>AdvAcctForecastSetPartner</forecastSetFieldName>
23    <rolloverFrequency>Monthly</rolloverFrequency>
24    <forecastStatusFieldName>Status</forecastStatusFieldName>
25    <description>sample forecast set</description>
26    <regenerationDpeDefName xsi:nil="true"/>
27    <rolloverDpeDefName xsi:nil="true"/>
28    <recalculateDpeDefName xsi:nil="true"/>
29    <generationDpeDefName xsi:nil="true"/>
30    <status>Inactive</status>
31    <forecastSetName>Forecast Set 1</forecastSetName>
32    <dimensions>
33        <dimensionFieldName>Account</dimensionFieldName>
34        <dimensionSourceName>DimSource1</dimensionSourceName>
35        <hierarchySequenceNumber>1</hierarchySequenceNumber>
36        <advAcctForecastDimName>DimensionName</advAcctForecastDimName>
37    </dimensions>
38    <measureDefinitions>
39        <forecastDataMeasureName>MeasureName</forecastDataMeasureName>
40        <advAcctForecastMeasureDefName>Sample Def Name</advAcctForecastMeasureDefName>
41        <isAdjustmentTracked>true</isAdjustmentTracked>
42        <forecastMeasureName>Samplemeasure name</forecastMeasureName>
43        <aggregationType>MINIMUM</aggregationType>
44        <computationMethod>DATA_PROCESSING_ENGINE_DEFINITION</computationMethod>
45        <forecastMeasureType>QUANTITY</forecastMeasureType>
46    </measureDefinitions>
47    <displayGroups>
48        <advAcctFrcstDisplayGroupName>Sample Measure Group</advAcctFrcstDisplayGroupName>
49        <displayGroupType>MEASURE</displayGroupType>
50        <isDefault>false</isDefault>
51        <userProfileName xsi:nil="true"/>
52        <displayGroupItems>
53            <advAcctFrcstDplyGroupItemName>Sample Quantity</advAcctFrcstDplyGroupItemName>
54            <measureReferenceName>Sample Def Name</measureReferenceName>
55            <displayOrder>1</displayOrder>
56        </displayGroupItems>
57    </displayGroups>
58</AdvAccountForecastSet>

The following is an example package.xml that references the previous definition.

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4       <members>*</members>
5       <name>AdvAccountForecastSet</name>
6    </types>
7   <version>68.0</version>
8</Package>

Wildcard Support in the Manifest File 

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.