1

6
Advanced DM Training

Launch Management

Copyright © 2015, Oracle and/or its affiliates. All rights reserved.

Objectives

After completing this lesson, you should be able to:

• Configure Launch Management for DM and PTP
• Introduce new products based on existing products in
Demantra
• Copy history from source products to generate forecast
• Configure series used for NPI
• Configure workflows to run NPI
• Do performance tuning for Launch Management
• Understand implementation best practices for Launch
Management

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-2
Agenda

• Introduction
• Process Flow
• Setup
• Implementation Tips and Best Practices

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-3
Agenda

• Introduction
• Process Flow
• Setup
• Implementation Tips and Best Practices

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-4
Launch Management

Introduction

• Introduce a new product (target) based on an existing

similar product (source)
• Quickly and easily link a new product to a given site,
account, retailer, store based on an existing product
• Use source product’s sales history to generate forecast
for the target

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-5
Launch Management

Introduction

• Promotions copied from source get promotion status

‘Fictive’
• User also has the option to copy promotional causals
• Series to be copied can be specified in the
NPI_SERIES_DATA table

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-6
Agenda

• Introduction
• Process Flow
• Setup
• Implementation Tips and Best Practices

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-7
Launch Management
Process Flow
PROCESS STEPS

Open New Product Generate Forecast for

Launch Worksheet New Product

Define New Product Review New Product

Launch Details Forecast

Review New Product

Launch Details

Review New Product

Copied History &
Promotion Causals

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-8
Launch Management
Process Step 1
Open ‘New Product
Launch Management’
worksheet

Click New Product

Launch Icon

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1-9
Launch Management
Process Step 2

Enter Request Name

Click Edit to specify details
of source product

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 10

Launch Management
Process Step 2 contd.

Click Edit to specify details of

target product

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 11

Launch Management
Process Step 2 contd.
Product Launch Date:
• Date new product will be available at
selected location
• Once reached system will stop copying
data to target

Copy Data: Copy historical data from source

to target. Options available are:
• Yes
• Yes include Promotion History
Promotions copied from source to
target have promotion status FICTIVE
• No

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 12

Launch Management

Process Step 2 contd.

Copy Percentage: Scales
historical data during copy

Copy Start Date – History:

User can specify the from
date to copy data

Copy End Date – Forecast:

User can specify the until date
to copy data

Launch Mode: Now, or Batch

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 13

Launch Management
Process Step 3
Review details of
product launch in
worksheet tables:
• New Product
Launch Status
• New Product
Launch
Attributes

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 14

Launch Management
Process Step 4-6
• After creating the new product, generate a forecast
using simulation
• Review/modify forecast using Demantra worksheet
‘Demand Analysis Item/Org’

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 15

Agenda

• Introduction
• Process Flow
• Setup
• Implementation Tips and Best Practices

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 16

Launch Management

Setup Flow

SETUP

Review ‘copy’ series settings in the

Review ‘Launch Copy’ attribute setup
table ‘NPI_SERIES_DATA’

Modify ‘copy’ series settings in the

Modify ‘Launch Copy’ attribute setup
table ‘NPI_SERIES_DATA’
(optional)
(optional)

If the NPI_SERIES_DATA table is If the attribute is modified

updated execute the workflow execute the procedure
“Create – Launch Management Views” “APPPROC_CDP_LAUNCH_MGMT_VIEWS”

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 17

Launch Management
Setup Flow

Review NPI_SERIES_DATA table for source and target series

setup

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 18

Launch Management
Setup Flow

• Execute workflow “Create - Launch Management Views”

• Workflow validates NPI_SERIES_DATA definitions
• Error_Message is populated with the appropriate error msg:
– Source and Target Series should have same data table definition
– Same Target Series cannot be listed twice
– Either Source or Target series computed name definition is Invalid
ERROR_ APPLY_COPY
SOURCE_SERIES TARGET_SERIES STATUS MESSAGE _PERC LAST_UPDATE_DATE
salesplus pseudo VALID 1 3/17/2014 13:53
prop_changes prop_changes VALID 0 3/17/2014 13:53
ebs_bh_book_qty_bd ebs_bh_book_qty_bd VALID 1 3/17/2014 13:53
ebs_bh_book_qty_rd ebs_bh_book_qty_rd VALID 1 3/17/2014 13:53
ebs_bh_req_qty_bd ebs_bh_req_qty_bd VALID 1 3/17/2014 13:53
ebs_bh_req_qty_rd ebs_bh_req_qty_rd VALID 1 3/17/2014 13:53

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 19

Launch Management

Setup Flow

Mark Promotion Status, Type, and Scenario

• Identify which statuses, types, and scenarios of promotion
to be copied from source to the target product
• Update column Launch_Copy=1 in the following tables for
the members that needs to be copied
• Promotion_Stat
• Scenario
• Promotion_Type

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 20

Launch Management

Setup Flow

Recommendations
• Set Launch_Copy to 1 only for promotion types which are
going to be forecasted for Incremental Lift by the engine
• Set Launch_Copy to 0 for “Sand Box” scenario and
“Unplanned”/”Draft” status promotions

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 21

Launch Management
Setup Flow PROMOTION PROMOTION_TYPE PROMOTION_TYPE_ LAUNCH_COPY
_TYPE_ID _CODE DESC
• Promotion_Type 101 1 Display Only 1
501 3 Frequent Shopper 1
201 4 Feature Only 1
301 2 Feature & Display 1
Temporary Price
401 5 Reduction 1
601 6 National TV
1 None No Promotion Type
0 Default Default
• Promotion_Stat
PROMOTION_STAT PROMOTION_STAT_ PROMOTION_STAT_ LAUNCH_
_ID CODE DESC COPY
8 Fictive Fictive
0 Default Default Status
1 1 a. Unplanned
2 2 b. Planned 1
3 3 c. Approved 1
4 4 d. Committed 1
5 5 e. Partial Paid 1
6 6 f. Paid 1
7 7 g. Closed 1

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 22

Edit Launch Request

Following launch definitions can be modified through “Edit

Product Launch” method
• Product Launch Date
• Copy Data
• Launch Mode
• Copy End Date - Forecast

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 23

Cancel Launch Request

• Cancel launch request method will null out the copied

data and purge the copied promotion history

• It doesn’t purge the target product combinations records

from the base tables (mdp_matrix, sales_data)
• Launch request can’t be cancelled if
• Launch status is “Processing” or “Completed”
• Launch status is “Valid” and Launch Mode is “Now”

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 24

Launch Request

Batch Mode

• Execute workflow “Launch

Request Batch” as part of
nightly batch process to
process request submitted
with launch mode set to
“Batch”

• Launch Request Block Size

value was defaulted to 5
• Processes 5 valid launch
request simultaneously

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 25

Launch Request
Ongoing Copy

• Execute workflow “Launch Management Ongoing” as part of

nightly/weekly batch process
• Launch management ongoing copy process will copy only
historical DM, IMCDP series and promotion history
• Forecast, MDP_Matrix, T_EP_CDP_Matrix series will not
get copied during ongoing copy process
• “Launch Management Ongoing” should be called after
“Launch Request Batch” workflow

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 26

Launch Request

Ongoing Copy

• Number of periods of
data to copy is
defaulted to 1
• Can be modified

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 27

Launch Management
Performance
DB parallel hint parameters to tune launch management views
Modules PNAME PVAL DESCRIPTION
ALL DBHintLaunchBIIO_SAL + parallel(m,4) Used in Select of View
ES_DATA_V_Select parallel(branch_data,4) BIIO_SALES_DATA_V.
branch_data sales_data, m -
MDP_MATRIX, it - ITEMS, loc -
LOCATION
ALL DBHintLaunchBIIO_MD + parallel(m,4) Used in Select of View
P_MATRIX_V_Select BIIO_MDP_MATRIX_V. m -
MDP_MATRIX, it - ITEMS, loc -
LOCATION
ALL DBHintLaunchMgmtMer + parallel(s, 4) Used in Merge into Sales_Data
geSalesData SQL Statement in
Approc_Launch_Lowest_Lev_Inte
g procedure. s - Sales_Data
ALL DBHintLaunchMgmtMer + parallel(b, 4) full(b) Used in Merge into Sales_Data
geSalesDataSelect Select SQL Statement in
Approc_Launch_Lowest_Lev_Inte
g procedure. b - biio temp table

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 28

Launch Management

Performance

• Execute APPPROC_CDP_LAUNCH_MGMT_VIEWS, if
parallel hint parameters used in the views are modified
• This program will recreate the views with the updated
parallel hints

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 29

Agenda

• Introduction
• Process Flow
• Setup
• Implementation Tips and Best Practices

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 30

Launch Management

Implementation Tips and Best Practices

• Use the icons on the Launch Management toolbar to

perform tasks in the launch management worksheet

• When creating multiple product launches, set Launch Mode

to Batch
• Launch management is a new GL, it should not be
modified

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 31

Launch Management

Implementation Tips and Best Practices

• Review workflow Launch Management Realtime

• This workflow should run continuously in the background
• Validates launch request and populates the interface staging
tables, executing the interfaces and Proport

• Workflow is configured to process one valid request at a time

• Set Launch Request Block Size to increase concurrency

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 32

Launch Management
Implementation Tips and Best Practices

• Modify “Launch Request Block Size” (Optional)

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 33

Launch Management
Troubleshooting Tips

• Ensure Launch Management View workflows are run if

changes are made to NPI_SERIES_DATA table
• Ensure Launch Request Block Size parameter is set
correctly
• New product launch is supported only at the following
levels:
• Item/Site
• Item/Site Group
• Item/Account
• Item/Retailer
• Select a single Source and Target Item

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 34

Launch Management – Start at the Beginning
Before initiating the silent installer for the first time ensure the following are
correct:
• Ensure that the end user machine has enough privileges to install applications
• Ensure that the AppserverURL parameter (Business Modeler --> System
Parameter --> System) is correct and reflects the first part of your login http address.
• Review the win_installer.properties file from the
..Collaborator\demantra\tools\desktopInstaller folder (found on the machine hosting
the webserver).
• In it the DBA_SERVER parameter should match DB_HOST parameter so that both have FULL
machine name where the Database is located (ex. use the full name WYSIW.mycompany.com
instead of just WYSIW).
• Note that if you had the Oracle client installed on your machine, that while the silent
installer will still download the other parts of the application, a new tnsnames.ora
entry, to the database, will need to be made manually.
• Please remember to use the full database machine name as the name of the new
tnsnames entry.
• If you received Cannot connect to DBMS or DBMS is not supported in your current
installation message and you have confirmed that you have the Demantra
application and Oracle client installed then re-boot your machine and try the link one
more time.
Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 35
Launch Management – Start at the Beginning
SQL*Net, TNSName and ServerName
The APS_PARAMS parameter named "TNSName" is used starting with Demantra
version 7.3.1.2. The previous parameter name was "ServerName".
• The parameter's value should be the DB name, per the tnsnames.ora file, to be
used by the Demantra application instance to connect to the matching Demantra
schema.
• First, find your correct service_name:
• In the tnsnames.ora you will something similar to:
ORCL=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=TEST-
DEMANTRA.oracle.com)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATE
D)(SERVICE_NAME=ORCL)))
TEST-DEMANTRA.oracle.com = ORCL
• Here, ORCL is the DB name or service_name
• You can use tnsping to verify the correct settings:
• tnsping <service_name>
• Or establish a sqlplus connection successfully on both linux and
windows.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 36

Launch Management – Start at the Beginning
Further Troubleshooting Steps:
When a user clicks on the Member Management, Chaining or Business Modeler link
for the first time the following applications should get installed on the end user
machine:
1) Oracle Client is installed and the correct TNSNAMES.ora entry is added.
2) A Demantra Application Folder containing the Desktop and Security Management
folders is installed.
The location of this folder on the end user machine is based on the
• USER_INSTALL_DIR value found in the win_installer.properties file (ex.
USER_INSTALL_DIR=C:/Program Files/Oracle Demantra Spectrum)
3) Necessary Environment Variables and Registry Entries.
• Go into Business Modeler manually by double clicking the modeler.exe executable
under the Desktop folder found under C:/Program Files/Oracle Demantra
Spectrum.
• This will often point to a further error or at least gives us another clue in the
troubleshooting process.
• If this folder does not exist then that also points to a potential privilege issue and/or
win_installer.properties setup problem.

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 37

Launch Management – Not available after 12.2.4.1 Platform Upgrade from 12.2.3
• Please note that you need to do an Application and Platform upgrade to
receive this functionality of Launch Management.
• You need to roll back and then do Application and Platform upgrade
• Please refer to the following doc to help you decide which upgrade best
suits your environment
• Demantra Platform or Application Upgrading - Program Manager
Recommendations, Demand Management DM S&OP PTP TPO SPF CTO IMCDP
(Doc ID 1609763.1)
• How can you tell if the client performed an Platform and Application Type upgrade
instead of a Platform only Upgrade? (Doc ID 1347770.1)

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 38

Summary

In this lesson, you should have learned how to:

• Configure Launch Management in DM and PTP
• Run Launch Management in Batch Mode
• Configure series used for NPI
• Configure workflows to run NPI
• Do performance tuning for Launch Management
• Understand implementation best practices for Launch
Management

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. 1 - 39