xP&A CX Commercial Planning - Add a new Driver
This tutorial provides a detailed instruction on how to add a new driver and embed it into the relevant stories.
Overview
You will learn
- How to add a new driver. This includes…
- …creating a new member in the driver dimension
- …adding relevant calculated measures to the data model
- …adjusting all affected data actions
- …embedding the driver into the stories
Prerequisites
Prerequisites
- You have an SAP Analytics Cloud tenant. If this is not the case, get started by requesting a free SAP Analytics Cloud trial tenant.
- You have installed the SAP CX Commercial Planning content in an SAP Analytics Cloud tenant. Reference: Business Content Installation Guide, Content Package User Guide
- You have finished both introduction tutorials xP&A Commercial Planning - Get to know the Portfolio Planning module and xP&A Commercial Planning - Get to know the Marketing Planning module
- You have finished the tutorial xP&A Commercial Planning - Understanding the technical structure of stories and understand the architectural design of each app
- You have finished the tutorial xP&A Commercial Planning - Introduction to the data model and understand the concept of the data model
Steps
Intro
Now that you have successfully gone through the introduction tutorials and know how to use the content package like an expert, you may want to start customizing it and adjusting it according to your own business needs.
Here you will learn how to add a new driver and how to embed it into the relevant stories.
In case you have any questions or require further support, please use the SAP Question Form.
If you have a specific request to our team in regards to the business content, you may also submit a request using the SAP Influence Platform.
If you are interested in more xP&A topics, related business content packages, or videos showing the content in action, feel free to check out our community page Extended Planning & Analysis Business Content.
First you need to create a new dimension member in the Driver dimension.
Open the
Marketing Planningdata modelSAP_MKT_IM_MarketingPlanningand click on theDriverdimension in the dimension list on the left-hand side.
xp&A Commercial Planning Add a new member ID to the dimension and save your changes.
- In this example, we will create a new driver to be able to plan season based fluctuations. We will call this driver
Seasonal Impactand provide the member IDseasonalImpact. - Save your changes afterwards.

xp&A Commercial Planning - In this example, we will create a new driver to be able to plan season based fluctuations. We will call this driver
Navigate back to the main menu of the data model and enter the Calculation Management section.

xp&A Commercial Planning
Add a new calculated measure representing the incremental quantity coming from the new driver
Click on the
+icon on the top to create a new calculated measureProvide a fitting Name and Description in the Properties panel on the right-hand side
Add the formula according to the screenshot

xp&A Commercial Planning CodeLOOKUP([QUANTITY], [d/Driver]="" AND [d/SAP_MKT_MarketingActivity]="#" AND [d/SAP_MKT_MarketingCampaign]="#" AND[d/SpendType]="#", [d/t.S:SAP_ALL_PLANT] )Save your changes
Enter the Data Action
SAP_MKT_IM_MarketingPlanning_PopulateImpactPercentageINFORMATION:
This data action is executed on initialization of the Marketing Demand Planning story and populates all relevant records with booked values, i.e. zeroes for all relevant measures.
In step 1
Populate Quantities with booked Values, add a new line according to the screenshot
xp&A Commercial Planning CodeDATA.APPEND([d/Driver]="seasonalImpact")=(RESULTLOOKUP()/RESULTLOOKUP())-1In step 2
Populate Revenues with booked Values, add a new line according to the screenshot
xp&A Commercial Planning CodeDATA.APPEND([d/Driver]="seasonalImpact")=(RESULTLOOKUP([d/Measures]="QUANTITY")/RESULTLOOKUP([d/Measures]="QUANTITY"))-1In step 3
Populate Quantity Impact (%) with booked Values, add a new line according to the screenshot
xp&A Commercial Planning CodeDATA.APPEND([d/Driver]="seasonalImpact",[d/t.S:SAP_ALL_PLANT]="#")=(RESULTLOOKUP([d/Measures]="QUANTITY")/RESULTLOOKUP([d/Measures]="QUANTITY"))-1Save the Data Action
Open the story Marketing Demand Planning (
SAP_MKT_MarketingDemandPlanning) in edit modeOpen the Left Side Panel, go to the Outline tab, look for the object called
tbl_DriversTable, click on it and open the Right Side Panel to enter the Builder panel.
xp&A Commercial Planning Add the new driver member to the filter of the table widget.

xp&A Commercial Planning Save your story.
Open your story in view mode to initialize the data for the new driver. Your tables should now contain the new driver with booked values.
Congratulations! You have finished the tutorial and are now able to add additional drivers to your data model!
If you want to learn more about the modules of this content package, check out the following tutorials:
- xP&A Commercial Planning - Get to know the Sales Planning module
- xP&A Commercial Planning - Get to know the Portfolio Planning module
- xP&A Commercial Planning - Get to know the Marketing Planning module
If you want to customize the content and adjust it according to your own business requirements, the following resources might be helpful:
- xP&A Commercial Planning - Introduction to the Data Model
- xP&A Commercial Planning - Data Integration
- xP&A Commercial Planning - Manage data loads
- xP&A Commercial Planning - Understanding the technical structure of Stories
- xP&A Commercial Planning - Add additional sections to a story
- xP&A Commercial Planning - Add an additional story to the Navigation Menu
- xP&A Commercial Planning - Customize Default Settings
- xP&A Commercial Planning - Customize Table Settings Dialogue
- xP&A Commercial Planning (Marketing) - Add a new Version
- xP&A Commercial Planning (Marketing) - Extend activity spend dates
- xP&A Commercial Planning (Sales) - Add a new Version
- xP&A Commercial Planning (Sales) - Add a new Tactic
- xP&A Commercial Planning (Sales) - Add a new Spend Type
If you want to get an overview of the entire xP&A Commercial Planning content package, make sure to check out the Mission.
Interested in more xP&A topics and related business content packages? Visit our community page Extended Planning & Analysis Business Content.
Resources
Discussion
Share feedback on this tutorial or join the conversation in SAP Community.