6

1
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 products 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

Launch Worksheet

Define New Product

Launch Details

Generate Forecast for

New Product

Review New Product

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

table NPI_SERIES_DATA

Review Launch Copy attribute setup

Modify copy series settings in the

table NPI_SERIES_DATA
(optional)

Modify Launch Copy attribute setup

(optional)

If the NPI_SERIES_DATA table is

updated execute the workflow
Create Launch Management Views

If the attribute is modified

execute the procedure
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
SOURCE_SERIES TARGET_SERIES
salesplus
pseudo
prop_changes
prop_changes
ebs_bh_book_qty_bd ebs_bh_book_qty_bd
ebs_bh_book_qty_rd ebs_bh_book_qty_rd
ebs_bh_req_qty_bd ebs_bh_req_qty_bd
ebs_bh_req_qty_rd ebs_bh_req_qty_rd

ERROR_ APPLY_COPY
STATUS MESSAGE _PERC
LAST_UPDATE_DATE
VALID
1
3/17/2014 13:53
VALID
0
3/17/2014 13:53
VALID
1
3/17/2014 13:53
VALID
1
3/17/2014 13:53
VALID
1
3/17/2014 13:53
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

Promotion_Stat

101
501
201
301

1
3
4
2

401
601
1
0

5
6
None
Default

Display Only
Frequent Shopper
Feature Only
Feature & Display
Temporary Price
Reduction
National TV
No Promotion Type
Default

1
1
1
1
1

PROMOTION_STAT PROMOTION_STAT_ PROMOTION_STAT_ LAUNCH_

_ID
CODE
DESC
COPY

8
0
1
2
3
4
5
6
7

Fictive
Default
1
2
3
4
5
6
7

Fictive
Default Status
a. Unplanned
b. Planned
c. Approved
d. Committed
e. Partial Paid
f. Paid
g. Closed

1
1
1
1
1
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 doesnt purge the target product combinations records

from the base tables (mdp_matrix, sales_data)
Launch request cant 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