Contents

Chapter 1

Introduction to the EPM Add-in.............................................................................................13

Chapter 2

Installation and Update.........................................................................................................15

2.1
2.2
2.3

Installation..............................................................................................................................15

Chapter 3

Log On and Connections......................................................................................................17

3.1
3.2
3.3
3.4
3.5
3.6

Log On and Log Off...............................................................................................................17

Chapter 4

Main Interface Areas.............................................................................................................23

Chapter 5

Features Available.................................................................................................................25

Chapter 6

Security on Data or Members...............................................................................................27

6.1

Security on Data (Planning and Consolidation, version for SAP NetWeaver)..........................27

Chapter 7

Open and Save a File............................................................................................................29

7.1
7.2
7.2.1
7.2.2
7.2.3
7.2.4
7.2.5

Open a File from a Web Portal ..............................................................................................29

Update...................................................................................................................................15
Re-activating the EPM Add-In ................................................................................................16

Connection Management.......................................................................................................17
Active Connection for the Current Sheet...............................................................................18
Types of Connections............................................................................................................19
Selecting Connections...........................................................................................................20
Selectively connecting or disconnecting one sheet/connection couples ................................21

Open and Save a File for Planning and Consolidation.............................................................30

Open and Save Connection ..................................................................................................30
Open Actions.........................................................................................................................31
Save Actions..........................................................................................................................32
Open and Save Dialog Box Description and Actions .............................................................33
Server Folder Structure..........................................................................................................33

2011-09-19

Contents

Chapter 8

Context..................................................................................................................................35

8.1

Context Display Options........................................................................................................36

Chapter 9

Report Layout Rules..............................................................................................................37

9.1
9.1.1
9.1.2
9.2
9.3
9.3.1
9.3.2
9.3.3
9.3.4
9.4
9.4.1
9.4.2
9.4.3
9.4.4
9.5
9.5.1

Overall Layout Rules .............................................................................................................37

Chapter 10

Report Creation ....................................................................................................................51

10.1
10.1.1
10.1.2
10.2
10.3
10.3.1
10.3.2
10.3.3
10.3.4
10.3.5
10.3.6
10.4
10.4.1
10.4.2
10.4.3
10.5

Member Identification and Properties.....................................................................................51

Basic Layout Rules................................................................................................................38

Dimension Layout Restrictions...............................................................................................39
Page Axis...............................................................................................................................40
Row Axis................................................................................................................................40
Simple Row Axis....................................................................................................................41
Multidimensional or Nested Row Axis....................................................................................41
Asymmetric Row Axis............................................................................................................43
Row Axis Restrictions............................................................................................................44
Column Axis...........................................................................................................................45
Simple Column Axis...............................................................................................................46
Multidimensional or Nested Column Axis ..............................................................................46
Asymmetric Column Axis ......................................................................................................47
Column Axis Restrictions ......................................................................................................48
Data Grid Considerations.......................................................................................................48
Data Grid Important Tips........................................................................................................50

Member Identification.............................................................................................................51
Member Properties................................................................................................................52
Report Creation using the EPM Pane.....................................................................................52
Report Creation using the Report Editor.................................................................................54
Report Editor's Layout Tab Presentation................................................................................55
Dimension Placement in the Report Editor.............................................................................56
Member Selection in the Report Editor...................................................................................57
Position of each Dimension in the Page Axis using the Report Editor.....................................57
Report Move in the Sheet using the Report Editor.................................................................58
Shift Insertion Between the Data Grid of the Report and its Row and Column Axis................58
Report Creation Directly in a Sheet........................................................................................59
Member Recognition..............................................................................................................59
Member Entry Using the Member Selector............................................................................63
Member Entry Using the Insert Members Dialog Box.............................................................71
Report Creation using Copy/Paste........................................................................................72

2011-09-19

Contents

Chapter 11

Asymmetric Report Creation ................................................................................................73

Chapter 12

Ownership-based Hierarchies...............................................................................................75

Chapter 13

Actions and Options Specific to the Current Report.............................................................77

13.1
13.1.1
13.1.2
13.1.3
13.2
13.2.1
13.2.2
13.2.3
13.3
13.4
13.4.1
13.4.2
13.5
13.6
13.7

Report Options......................................................................................................................77

Chapter 14

Several Reports in a Sheet ...................................................................................................91

14.1
14.2
14.3

Restrictions when Several Reports in a Sheet........................................................................92

Chapter 15

Report Refresh .....................................................................................................................95

15.1

Refreshing Reports................................................................................................................96

Chapter 16

User Options.........................................................................................................................97

Chapter 17

Sheet Options.......................................................................................................................99

17.1
17.1.1
17.1.2
17.1.3
17.1.4
17.1.5

General Sheet Options..........................................................................................................99

Freeze Data Refresh..............................................................................................................78

Display only Base Level Data.................................................................................................78
Do not Store Connection and Do not Store Environment in the Connection...........................78
Data Sorting, Ranking and Filtering .......................................................................................79
Data Sorting ..........................................................................................................................79
Data Filtering .........................................................................................................................81
Data Ranking.........................................................................................................................83
Read-only Data......................................................................................................................84
Local Members......................................................................................................................84
Local Member Automatically Detected...................................................................................85
Local Member Creation..........................................................................................................87
Renaming Members...............................................................................................................88
Excluding Members................................................................................................................89
Member Insertion Filtering......................................................................................................89

Report Highlight ....................................................................................................................92

Delete Reports .....................................................................................................................93

Expand Options......................................................................................................................99
Use as Input Form................................................................................................................100
Member Recognition Activation...........................................................................................100
EPM Worksheet...................................................................................................................100
Totals Placement .................................................................................................................101

2011-09-19

Contents

17.1.6
17.1.7
17.2
17.2.1
17.2.2
17.2.3
17.2.4
17.2.5
17.2.6
17.3
17.3.1
17.3.2
17.3.3
17.3.4
17.3.5

Empty Row and Column Behavior........................................................................................103

Chapter 18

Report Navigation...............................................................................................................111

18.1
18.2
18.3
18.3.1
18.4
18.4.1
18.5
18.6
18.7

Going Back in the Navigation Actions..................................................................................111

Chapter 19

Drill-Through.......................................................................................................................123

Chapter 20

Quick Links.........................................................................................................................127

20.1
20.2

Creating Quick Links............................................................................................................128

Chapter 21

Custom Members................................................................................................................129

21.1
21.2
21.3
21.4
21.5
21.6

Creating custom members...................................................................................................130

Show as Microsoft Excel Comments....................................................................................104

Formatting Sheet Options....................................................................................................105
Row Header Indentation ......................................................................................................105
Display Name.......................................................................................................................105
Auto Fit Column Width.........................................................................................................106
Repeat Row Headers and Repeat Column Headers.............................................................106
Empty Cell Default Value .....................................................................................................107
Apply Dynamic Formatting...................................................................................................107
Refresh Sheet Options.........................................................................................................108
Keep Formula on Data and Show Source Data in Comments ..............................................108
Calculate Parents in Hierarchies...........................................................................................109
Refresh Data on the Whole File when Opening it.................................................................110
Clear Data on the Whole File when Saving it........................................................................110
Show Unauthorized Cell Text ..............................................................................................110

Row and Column Axes Switch.............................................................................................112

Expand.................................................................................................................................112
Expand on Nested Axis........................................................................................................113
Collapse...............................................................................................................................116
Collapse on Nested Axis......................................................................................................117
Keep Member......................................................................................................................119
Exclude Member..................................................................................................................120
Double-Click Actions............................................................................................................121

Deleting Quick Links............................................................................................................128

Custom Members Order......................................................................................................131

Modifying Custom Members................................................................................................133
Enabling or Disabling all the Custom Members Defined for a Sheet/Connection .................133
Deleting Custom Members .................................................................................................133
Custom Members Export.....................................................................................................134

2011-09-19

Contents

21.6.1
21.7
21.7.1

Exporting Custom Members.................................................................................................134

Chapter 22

Flash Objects......................................................................................................................137

22.1
22.1.1
22.1.2
22.1.3
22.1.4
22.1.5
22.1.6
22.1.7
22.1.8
22.1.9
22.1.10
22.1.11
22.1.12
22.2

Flash Object Creation, using EPM Connector......................................................................137

Chapter 23

Dynamic Charts .................................................................................................................153

Chapter 24

Dynamic Formatting............................................................................................................155

24.1
24.1.1
24.2
24.2.1
24.2.2

Dynamic Formatting Template Definition..............................................................................155

Chapter 25

Workbook Sheets' Automatic Generation...........................................................................161

Chapter 26

Offline Mode.......................................................................................................................163

Chapter 27

Worksheet Protection.........................................................................................................165

Chapter 28

Collaboration.......................................................................................................................167

28.1
28.2
28.2.1

Report Publication to a Web Portal.......................................................................................167

Custom Members Import.....................................................................................................135

Importing Custom Members ................................................................................................136

Connections and Operations................................................................................................138

Creating a Connection in Dashboard Design........................................................................139
Retrieve Data Using a Report...............................................................................................140
Retrieve Databases/Environments/InfoAreas ......................................................................141
Retrieve Cubes/Models/InfoProviders ................................................................................142
Retrieve Dimensions ...........................................................................................................143
Retrieve Dimension Members/Characteristic Values ..........................................................144
Input Data............................................................................................................................145
Retrieve Business Process Flows........................................................................................146
Retrieve Context..................................................................................................................147
Retrieve Text From Documents View...................................................................................148
Retrieve Members Property Values.....................................................................................149
Flash Object Insertion..........................................................................................................150

Defining a Dynamic Formatting Template ............................................................................157

Dynamic Formatting Applied to a Worksheet or to a Specific Report...................................158
Applying a Default Dynamic Formatting Template to the Worksheet....................................158
Applying a Default Dynamic Formatting Template to a report...............................................159

Publication and Distribution Connection...............................................................................168

Book Publication .................................................................................................................168

2011-09-19

Contents

28.2.2

Distribution and Data Collection...........................................................................................178

Chapter 29

EPM Functions....................................................................................................................187

29.1
29.2
29.3
29.4
29.5
29.6
29.7
29.7.1
29.7.2
29.7.3
29.7.4
29.7.5
29.7.6
29.7.7
29.8
29.9
29.10
29.11
29.12
29.13
29.14
29.15
29.16
29.17
29.18
29.19
29.20
29.21
29.22
29.23
29.24
29.25
29.26
29.27
29.28
29.29
29.30
29.31

EPMUser.............................................................................................................................188
EPMServer..........................................................................................................................188
EPMEnvDatabaseDesc........................................................................................................188
EPMEnvDatabaseID.............................................................................................................189
EPMModelCubeID...............................................................................................................189
EPMModelCubeDesc..........................................................................................................189
Functions on Reports...........................................................................................................190
EPMDimensionOverride.......................................................................................................190
EPMAxisOverride.................................................................................................................192
EPMCopyRange...................................................................................................................193
EPMInsertCellsBeforeAfterBlock.........................................................................................194
EPMMemberID....................................................................................................................195
EPMReportOptions..............................................................................................................195
EPMMemberSortingOverride...............................................................................................197
EPMReportID.......................................................................................................................198
EPMFullContext...................................................................................................................198
EPMContextMember...........................................................................................................199
EPMDimensionProperty.......................................................................................................199
EPMMemberDesc................................................................................................................200
EPMMemberProperty..........................................................................................................200
EPMMemberOffset..............................................................................................................201
EPMSelectMember..............................................................................................................201
EPMCellRanges...................................................................................................................202
EPMRefreshTime.................................................................................................................202
EPMScaleData.....................................................................................................................202
EPMRetrieveData................................................................................................................203
EPMDimensionList...............................................................................................................203
EPMSaveComment..............................................................................................................204
EPMSaveData......................................................................................................................204
EPMWorkStatus..................................................................................................................205
EPMComparison..................................................................................................................205
EPMDimensionType.............................................................................................................206
EPMCommentFullContext....................................................................................................207
EPMCommentPartialContext................................................................................................207
EPMURL..............................................................................................................................208
EPMBook.............................................................................................................................210
EPMLink..............................................................................................................................211
EPMDocumentList...............................................................................................................212

2011-09-19

Contents

29.32
29.33

EPMDocument.....................................................................................................................213

Chapter 30

Data Input and Save............................................................................................................215

30.1
30.2
30.2.1
30.2.2
30.2.3
30.3
30.3.1
30.3.2
30.3.3
30.4
30.5
30.6

Data Input............................................................................................................................215

Chapter 31

Accessing Journals.............................................................................................................225

Chapter 32

Business Process Flows.....................................................................................................227

Chapter 33

Report and Input Form Templates.......................................................................................229

Chapter 34

Other Features....................................................................................................................231

34.1
34.2
34.3
34.4

Metadata Cache..................................................................................................................231

Chapter 35

EPM Add-in for Microsoft Office Word and PowerPoint.....................................................233

35.1
35.2
35.3

Common Features to the Add-in for Microsoft Office Excel, Word and PowerPoint .............233

Chapter 36

Data Manager.....................................................................................................................237

36.1
36.1.1
36.2
36.2.1

About Data Manager............................................................................................................237

EPMExecuteAPI...................................................................................................................213

Planning Features.................................................................................................................216
Spread.................................................................................................................................217
Trend...................................................................................................................................217
Weight.................................................................................................................................218
Comments...........................................................................................................................218
Comment Creation and Modification....................................................................................219
Comment Display in a Cell...................................................................................................220
Comment Search.................................................................................................................221
Data Save............................................................................................................................221
Data Validation.....................................................................................................................222
Work Status.........................................................................................................................223

Log File................................................................................................................................231
Information on Cubes ..........................................................................................................232
MDX Display........................................................................................................................232

Additional Features in the Add-in for Microsoft Office Word and PowerPoint ......................234
Options in the Add-in for Microsoft Office Word and PowerPoint ........................................234

About Data Manager............................................................................................................237

Standard Packages..............................................................................................................239
Standard Data Management Packages................................................................................239

2011-09-19

Contents

10

36.2.2
36.2.3
36.3
36.3.1
36.3.2
36.4
36.4.1
36.4.2
36.4.3
36.5
36.5.1
36.5.2
36.5.3
36.5.4
36.5.5
36.5.6
36.5.7
36.5.8
36.5.9
36.5.10
36.5.11
36.6
36.6.1
36.6.2
36.7
36.7.1

Financial Process Packages ................................................................................................245

Chapter 37

API.......................................................................................................................................303

37.1
37.1.1
37.1.2
37.1.3
37.1.4
37.1.5
37.1.6
37.1.7
37.1.8
37.1.9
37.2
37.2.1
37.2.2

Macros................................................................................................................................303

System Administration Packages.........................................................................................246

Additional Packages.............................................................................................................247
About Additional Packages...................................................................................................247
Importing Transaction Data from an Information Provider ....................................................253
Adding or Modifying Packages.............................................................................................254
Package Properties..............................................................................................................254
Logic Use in Packages.........................................................................................................273
Package Object Syntax .......................................................................................................274
Data Manager Tasks............................................................................................................274
Data Manager Tasks............................................................................................................274
Removing a Package from the List.......................................................................................275
Running Packages................................................................................................................275
Defining a Package Link.......................................................................................................277
Modifying the List of Selected Packages..............................................................................278
Viewing Package Status.......................................................................................................279
Viewing Package Schedule Status.......................................................................................279
Adding Multiple Process Chains to a Package......................................................................279
Importing and Exporting Data Having Multiple Key Figures...................................................280
Retracting Master Data and Transaction Data......................................................................280
About Delta Initialization.......................................................................................................281
Data Transformations and Conversions................................................................................283
About Data Transformations................................................................................................284
Data Conversions................................................................................................................297
Data Transfer and Preview...................................................................................................300
About Data Transfer and Preview.........................................................................................300

Connections.........................................................................................................................303
Reports................................................................................................................................306
GetMemberDimension ........................................................................................................320
GetMemberHierachy ...........................................................................................................321
GetDimensionList................................................................................................................322
GetHierarchyList..................................................................................................................323
GetHierarchyMembers ........................................................................................................323
Get MDX Request ..............................................................................................................324
Book Publication and Distribution.........................................................................................324
Macros used in EPMExecuteAPI function.............................................................................325
Connections.........................................................................................................................325
Excel....................................................................................................................................327

2011-09-19

Contents

11

37.2.3
37.2.4
37.2.5
37.2.6
37.2.7
37.2.8
37.2.9
37.2.10
37.2.11
37.2.12
37.2.13
37.2.14
37.2.15
37.2.16
37.2.17
37.2.18
37.2.19
37.3
37.4

Word and PowerPoint..........................................................................................................328

Chapter 38

Languages...........................................................................................................................349

Chapter 39

About the EPM Add-In.........................................................................................................351

Chapter 40

Migration.............................................................................................................................353

40.1
40.2
40.2.1
40.2.2
40.2.3
40.2.4
40.2.5
40.2.6
40.2.7
40.2.8
40.2.9
40.2.10

Extended Analytics Analyzer Report Migration.....................................................................353

Navigation............................................................................................................................329
Drill Through........................................................................................................................330
Context Members................................................................................................................331
Comments...........................................................................................................................332
Open/Save from Server.......................................................................................................333
OpenDimensionAndMemberSelector ..................................................................................334
OpenReportEditor................................................................................................................334
Options................................................................................................................................335
Refresh................................................................................................................................335
Save Data............................................................................................................................337
OpenWorkStatusEditor........................................................................................................338
Planning...............................................................................................................................338
Book Publication..................................................................................................................339
Distribution and Collection...................................................................................................340
OpenSpecificDocument.......................................................................................................342
Data Manager......................................................................................................................342
Assigning a Control Form to a Macro...................................................................................346
Custom VBA Functions (Events)..........................................................................................347

Planning and Consolidation EvDRE Migration.......................................................................353

EvDRE Formula....................................................................................................................354
KeysRange..........................................................................................................................354
Report Members and Axes..................................................................................................355
ExpansionsRange.................................................................................................................359
SortRange............................................................................................................................364
OptionRange........................................................................................................................364
Format Migration..................................................................................................................365
Migration Log.......................................................................................................................370
Launching the EvDRE Migration...........................................................................................371
After Migration.....................................................................................................................373

2011-09-19