Cognos Planning(TM) Add-in for Excel User...

COGNOS(R)ENTERPISEPLANNING SERIESC O G N O S P L A N N I N G (TM)

ADD-IN FOR EXCEL USER GUIDE

THE NEXT LEVELOF PERFORMANCETM

ANALYST

DD-MM-YYYY

please update with product version as defined in Trakker

View the Readme

Cognos Planning - Analyst Add-in for Excel Help

Cognos Planning version 7.2

Version n.n

Add-in for Excel User Guide

Product InformationThis document applies to Cognos Planning version 7.2 and may also apply to subsequent releases. To check for newer versions of this document, visit the Cognos support Web site (http://support.cognos.com).

CopyrightCopyright (C) 2004 Cognos Incorporated

While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document.

This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to either the product or the document will be documented in subsequent editions.

U.S. Government Restricted Rights. The software and accompanying materials are provided with Restricted Rights. Use, duplication, or disclosure by the Government is subject to the restrictions in subparagraph (C)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (C) (1) and (2) of the Commercial Computer Software - Restricted Rights at 48CFR52.227-19, as applicable. The Contractor is Cognos Corporation, 15 Wayside Road, Burlington, MA 01803.

This software/documentation contains proprietary information of Cognos Incorporated. All rights are reserved. Reverse engineering of this software is prohibited. No part of this software/documentation may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos Incorporated.

Cognos and the Cognos logo are trademarks of Cognos Incorporated in the United States and/or other countries. All other names are trademarks or registered trademarks of their respective companies.

Information about Cognos Products and Accessibility can be found at www.Cognos.com

http://support.cognos.com

Table of Contents

Introduction 7

Additional Materials 9

Chapter 1: Connection Between Microsoft Excel and Cognos Planning - Analyst 11Log On 11Log Off 11

Chapter 2: Basic Cognos Planning - Analyst Add-in for Excel Features 13Breakback 13Custom Items 13D-Cube 13D-Link 14D-List 14Note in the Red Cell 14Inserting Rows/Columns as the First or Last Items in the List 16Laminated Dimensions 16

Ranges in Laminated Dimensions 16Restrictions in Laminated Dimensions 17Replicate Headings 17

Page Label Box 17Range Names 17

Example 18Sharing Pages 18

Chapter 3: Macros, Assigning Actions, D-Links 19Cognos Planning - Analyst Macro List 19Assign Action 19Assign Action: Get Write Access 20

Function 20Assign Action: Log Off 20

Function 20Assign Action: Log On 20

Function 20Assign Action: Print 20Assign Action: Recalculate 20

Function 21Assign Action: Refresh 21

Function 21Assign Action: Release Write Access 21

Function 21Assign Action: Run D-Link 21

Function 21Assign Action: Run Macro 21

Function 21Assign Action: Save 21

Function 22Drill-Down 22Run Macro 22Run D-Link 22Visual Basic Commands 22

Add-in for Excel User Guide 3

Chapter 4: Print and Formatting 25Page Setup 25Print Sheets 25Number and Date Formats 25

Scaling Format 25Percentage Format 25Number and Date Formats Set in Analyst 26Numeric Formats 26

Print Macros 26Batch Printing 26Create Sheets 27Detailed Selection 27Saved Selection 27Entire Cube 27

Chapter 5: Refreshing, Recalculating, Saving 29Partial Refresh 29Read Write Access 29Recalculate 30

Recalculate Selected View 30Recalculate All Views 30Rules For Recalculating 30

Refresh 30Refresh Views of D-Cube 31Refresh Selected View 31Refresh All Views 31

Reset D-Cube 31Save D-Cube 31

Chapter 6: Reselecting and Auditing 33Auditing 33

Check Active View for Blanks 33Check Active View for Errors 33Check Integrity of Views 33Check View for Renamed D-List Items 33Replace Object Names In All Definitions 34Show Precedents of Formula 34

Incomplete Totals 34Updating Your View 34

Pick Item From D-List 35Reselect View 35Update D-List Items 35

To Rename and Match Items 36

Chapter 7: Views 37Options 37

Analyst System Messages 37AutoFormat 37Dynamic Selections 38

Detailed Selection 38Entire D-List 38Saved Selection 38Entire Cube 38Select Existing Pages 38

View 38Define View 39New View 40Reselect View 40

4 Cognos Planning(TM) Analyst

Define Ranges in a View 41Define Rows Columns Pages 41Match Misspelled Items or Delete Unmatched Items 41Select Page Items 42Slice a View 42View Copy 42Delete View 42View Options 42View Paste D-List Items 42View Resize All Drop-downs To Fit Cells 43View Style 43

Normal 43Hierarchical 43Pivot Table 43

Format Options 44Auto Color - Foreground Data Cells 44Auto Color - Background Data Cells 44Auto Color - Foreground D-List Cells 44Auto Color - Background D-List Cells 44Replicate Headings 45Suppress Zero Rows on Refresh 45

Validity Checks 45Check for Unmatched Items 45Check for Incomplete Totals 45

Actions on Opening Workbook 46Refresh View on Loading 46Get Write Access on Loading 46

Advanced Options 46Treat Blanks as Zero on Recalculate 46Treat Errors as Zero on Recalculate 46Allow Breakback on Recalculate 47Allow Breakback from Excel Formulas 47Overwrite Excel Formula on Refresh 47Blank Invalid Cells if Note Present 47

Index 49



Introduction

This document is available as online help and as an online book. For information about related documents, see "Additional Materials" (p. 9).

Cognos Planning - AnalystAnalyst is a dedicated business planning system that overcomes many of the problems associated with spreadsheet systems.

Using Analyst, you can expect to dramatically shorten your budgeting and closing cycles, eliminate retyping and reformatting data, greatly improve your data accuracy, and produce ad hoc and variance analysis reports on demand.

Unlike spreadsheet-based budgeting systems, you can quickly build models to reflect your organizational structure and easily change the model to reflect restructuring.

Cognos Planning - Analyst Add-in for ExcelAnalyst Add-in for Excel is an add-in designed to run off the menu bar of a standard Microsoft(R) Excel spreadsheet in conjunction with Analyst.

Excel sits on top of Analyst as a means of displaying data held in D-Cubes. What you see in Excel is a file that can be treated like any other .xls file. The only difference is that when you want to refresh or recalculate the report using the underlying data and formulas, you need to link to Analyst.• Reporting capability. Using data held in Analyst, you can create professional reports, tables,

and graphs using all the formatting facilities provided by Excel. Data held centrally can be refreshed at the click of a mouse to bring it up to date in your custom report.

• Data entry into Analyst alternative. A typical use for this would be consolidating a budget for multiple divisions. Some divisional managers can access Analyst over a network, some have it installed on a stand-alone PC, and a few remote sites just have Excel and no access to Analyst. In all cases you can fill in an Excel spreadsheet and then send the data back to a central Analyst model.

• Front end possibility for the Analyst model builder. You can create text boxes, bitmaps, buttons, and arrows in Excel and link to these to run actions in Analyst. It is ideal as a quick and organized way of navigating around complex models.

What You Need to Know to Use the Analyst Add-in for Excel Effectively You should have a working knowledge of both Analyst and Microsoft Excel functionality.

Questions or Comments?For additional technical information about using Analyst, visit the Cognos support Web site (http://support.cognos.com).This document is available as a PDF book.


Introduction


Additional Materials

In this guide, we may refer to other documents. Their locations are listed below.

Integrating Cognos Enterprise Planning ProductsThe Cognos Enterprise Planning Integration Guide discusses how to create solutions such as integrating Cognos Consolidation with Cognos Planning - Analyst and integrating Cognos Analytic Applications with Analyst.

For information about how to use the Contributor extensions to create solutions with other Cognos products, see the Contributor Administration Guide.

FormatsOur documentation includes user guides, tutorial guides, reference books, and other materials in various formats, including PDF and HTML help to meet the needs of our varied audience.

Online HelpSome information is available in online help. Online help is available from the Help button in a Web browser or the Help menu and Help button in Windows products.

Books for PrintingCognos grants you a non-exclusive, non-transferable license to use, copy, and reproduce the copyright materials, in printed or electronic format, solely for the purpose of providing internal training on, operating, and maintaining the Cognos software.

Subject Document

Installing and configuring Cognos Planning products

Cognos Planning Installation Guide

Getting to Know Cognos Planning - Analyst

Analyst Tutorial

Using Cognos Planning - Analyst and Manager

Analyst and Manager Help

Getting to Know Cognos Planning - Analyst Add-in for Excel

Analyst Add-in for Excel Tutorial

Administration of Cognos Planning - Contributor

Contributor Administration Guide

Automation of Cognos Planning - Contributor administration

Contributor Automation Guide

Using the Cognos Planning - Contributor Web client

Contributor Browser Help

Extending the functionality of Cognos Planning - Contributor

Contributor Administration Guide

Enterprise Planning solutions Enterprise Planning Integration Guide


Additional Materials

You can read the product readme files, installation guides and product documentation directly from Cognos Planning product CDs.


Chapter 1: Connection Between Microsoft Excel and Cognos Planning - Analyst

Log OnLogging on to the Analyst Server forms the connection between the data held in Analyst and the view in Microsoft (R) Excel. Once you are logged on, you are able to refresh and recalculate the data using the formulas and data held in Analyst.

Steps1. From the Analyst menu, click Log On.

The Analyst Log On dialog box appears.

2. Enter a password if needed, and click OK.

Log OffLogging off the Analyst Server breaks the connection between Microsoft Excel and Analyst.

Steps• From the Analyst menu, click Log Off.

Note: Although you will still be able to make cosmetic changes to the Excel file, you will no longer be able to refresh or recalculate using the formulas and data held in Analyst.


Chapter 1: Connection Between Microsoft Excel and Cognos Planning - Analyst


Chapter 2: Basic Cognos Planning - Analyst Add-in for Excel Features

BreakbackBreakback answers what-if problems by changing the value of any number of variables to make a formula equal to a value you specify. With Breakback you set a target for a formula, and the variables that make up that formula are changed according to rules you specify.

By default, totals are split pro-rata according to the original values contained in the variables that make up the formula.

Zeros remain at zero with one exception - if all the variables in a formula are zero initially, the total is split equally down the hierarchy.

Custom ItemsA custom item is defined as a row or column label in Excel that does not match a D-List (p. 14) item.

Sub-headings, custom formulas, or extra row and column labels can all be entered in Microsoft Excel as custom items. Custom items will not be refreshed directly from data held in Cognos Planning - Analyst, although they can contain Excel formulas that refer to cells that are refreshed from Analyst.

You can tell which items are D-List items and which items are custom items by the presence or absence of a small red dot in the top right corner of the cell. D-List items will have this red dot, containing a note with the D-List name. Custom items will not have a red dot attached.

Custom items are converted to D-List items automatically if the spelling and case match a D-List item exactly, and they lie within the ranges defined for rows, columns, and pages. A note indicated by a red dot is attached to the label on conversion to a D-List item.

You will be warned if an old D-List item no longer matches a D-List item due to changes in the underlying D-List.

Upon clicking Reselect View from the Analyst menu, or Check view from the Auditing menu for renamed D-List Items, you will have three options:

1. Delete the item

2. Match the old item against the renamed item

3. Convert to a custom item

If you convert a row or a column to a custom item, the item will remain in the spreadsheet until you delete it. The note will be removed to show that it is no longer being refreshed from the data held in Analyst. Items that were once D-List items but have been converted to custom items appear in red. To delete such items, use the normal Excel commands for removing rows and columns. Pages that are no longer valid will be removed automatically.

D-CubeA D-Cube is a multi-page spreadsheet made up of two or more D-Lists. A D-Cube must contain at least two D-Lists (similar to a flat spreadsheet). Alternatively, a D-Cube can have three D-Lists, in which case it resembles a three-dimensional worksheet consisting of several flat sheets stacked behind one another.



Unlike a spreadsheet, D-Cubes can be sliced so that any pair of dimensions can comprise the rows and columns while additional dimensions comprise the pages.

A four or five-dimensional D-Cube can be considered the same as a cross between a three-dimensional spreadsheet and a set of query reports from a relational database. A typical four-dimensional D-Cube could contain D-Lists for Profit and Loss, Sales, Months, and Variance.

A D-Cube is particularly useful when you must allocate data into standard categories.

Analyst can handle any number of dimensions, the only practical limitation being the memory in your PC.

When you create a D-Cube, it is best to choose the D-Lists in a set order to overcome any priority conflicts on formulas at a later date. In general, select D-Lists with the most calculations first, particularly when the calculations use IF...Then...ELSE logical operators. Select the aggregation D-Lists next (divisions, customers, products) then the timescale D-Lists. Finish with the versions D-List. The default formula priority is given to the later D-List in a D-Cube, whereas format priority is given to the earlier D-List.

D-LinkA D-Link is an Analyst object used to copy information into and out of a D-Cube (p. 13). Whereas in a spreadsheet program you would generally use formulas to connect one worksheet to another, in Analyst, D-Links are used for the same purpose.

Each D-Link is given a source of information and a target. D-Links are generally used to connect one D-Cube to another, but they also can be used to import data from another program by connecting an ASCII file or text file to a D-Cube.

D-ListThink of a D-List as a field in a database. The items contained in a D-List should be related to each other so that their relationships can be placed into formulas that proceed down the rows or across the columns.

A D-List is a list of related items that can be put into formulas that proceed down the rows or across the columns of a D-Cube. Commonly used D-Lists include profit and loss items, months, divisions, products, customers, and cost centers. In addition to the items that make up the row, column, and page label, a D-List also contains formulas.

You can use letters, numbers, punctuation marks, and spaces in D-List item names. However, you should avoid using the following:• The semicolon (;) because it is used in special calculation formulas called built-in functions

(BiFs). • The at sign (@) and braces ({}) because these are used in formulas, built-in functions, and

macros. • The brackets ([]) because this naming convention is used to mark D-List formatted items,

which appear as virtual dimensions in the D-Link editor.

D-Lists that contain calculations can have those calculations force to zero. This means that if the calculation result is zero or if the result is nonsensical, then the cell displays blank. This option is particularly useful for D-Lists with multiple calculations.

Note in the Red CellThe key to Analyst Add-in for Excel is contained in the note in the red cell to the top left of the view.

For example, create a new view using TutorialGO library with the Americas Overheads D-Cube.

The note contains parameters defining how Microsoft Excel should display the data held in Analyst. To view the note, place your cursor over the cell.



You will see a set of parameters that define how the view is displayed. These contain the D-Cube (p. 13) name, library name, range names for the page, row, and column labels as well as the names of the D-List (p. 14) and other parameters. You may edit this note, provided the syntax you use is exact.

Analyst7 The version number of the note.

TYP=V The view type or style. V= normal view, H = hierarchical view, P = pivot table.

SVR= Server name.

LIB=TutorialGO Library name.

CBE=Americas Overheads

D-Cube name.

FGD=Y Y = Set the foreground data automatically. For information about foreground data, see "View Options" (p. 42).

BGD=Y Y = Set the background data color automatically.

FGL=Y Y = Set the foreground D-List item color automatically.

BGL=N Y = Set the background D-List item color automatically.

SUP=N Update state (No longer used).

BBF=N Y= Allow Breakback from Excel formulas.

NTS=Y Y= Display the notes (marked by red dots). N= hide the notes.

VAL=Y Y= Automatically check for invalid D-List items whenever you open or refresh the view. This checks all labels with notes that are within the defined ranges.

RHD=N Y= Replicate headings (applies to laminated dimensions only).

LCK=N Y= Get automatic Read Write Access (p. 29) on loading the workbook.

RFH=Y Y= Refresh automatically on opening.

BBK=Y Y= Allow Breakback (p. 13) on recalculate.

OVF=N Y= Overwrite Excel formulas on refresh.

IAB=N Y= Blank invalid cells if note present.

BAZ=N Y= Treat blanks as zeros on recalculate.

EAZ=N Y= Treat errors as zeros on recalculate.

R01=1 Overheads The first row label set comes from the 1 Overheads D-List.



The numbers are refreshed from the underlying D-Cube by referring to the labels on your spreadsheet and matching them character for character against items found in the D-List. The D-List to use is defined in the note. You cannot alter the labels even by a single character or the data will not be refreshed from the underlying D-Cube. However you are free to cut and paste rows and columns to move them in the spreadsheet. The absolute or relative positioning of a cell is irrelevant when it comes to refreshing from the underlying D-Cube, provided it is below and to the right of the cell note.

The note shows the name of the D-List associated with each label. If, on refreshing a view, a label within a row, column, or page range is found to be an exact match of a D-List item, then a note will be attached to the cell. If the label is not an exact match, then the note will have the word invalid in front of the D-List name and the data will not be refreshed.

Inserting Rows/Columns as the First or Last Items in the List

From the Analyst menu, click Reselect View (p. 35) to insert and reorder items.

However, if you decide to insert rows or columns manually, be sure not to insert items at the beginning or end of the list or you may inadvertently go outside the range where Analyst is looking to find the labels. It is a feature of Microsoft Excel that the range is amended if you insert a row or column in the middle, but not if you insert a row or column at the edges, just outside the existing range.

To amend the range, from the Insert menu, click Name, Define, and then select the range you wish to amend. Amend the range it refers to so that it includes all the row labels including the new label.

Now when you click Refresh, Selected View from the Analyst menu, the labels will be found and the data updated correctly.

Laminated DimensionsA laminated dimension is when you have combined two or more D-Lists (p. 14) to form a dimension. For example, you could have the rows, pages, or columns as a laminated dimension comprised of two or more D-List.

Ranges in Laminated DimensionsIf you have more than one row, column or page label (otherwise known as a laminated dimension), make sure that the range includes every cell that contains the labels.

C01=4 Months - Fiscal The first column label set comes from the 4 Months - Fiscal D-List.

RGR=analyst_row_1 The range name of the range containing the row labels.

RGC=analyst_col_1 The range name of the range containing the column labels.

RGD=analyst_data_1 The range name of the range containing the data.

VID=307340C4F550562C0

The view ID (dynamic).

CHK=-2105505917 The checksum (dynamic) used to check if the data in the current view has changed.



Restrictions in Laminated DimensionsThere are restrictions when it comes to inserting extra rows and columns in laminated dimensions. • You cannot insert a column between the two D-Lists that make up the laminated row labels.• You cannot insert a row between the two D-Lists that make up a laminated column heading. • The range for the page label text must be in the same row and must be a continuous range.

The range is occupied by the page label text underneath the drop-down menus that has this restriction. You are free to move the drop-down menus themselves to wherever you want on the worksheet.

• Where the first row label is shown as a subheading, do not type anything into the blank cells beneath it. The program takes the first non-blank cell above the current row label position as the subheading to use.

• Where the first column heading is shown as a subheading, do not type anything into the blank cell adjacent to it. The program takes the first non-blank cell to the left of the current column label position as the subheading to use.

Replicate HeadingsThe option to replicate the headings of a laminated dimension is available when you first create a view. To replicate headings on an existing view containing a laminated dimension.

Steps1. From the Analyst menu, click View, Options, Replicate Headings.

2. From the Analyst menu, click Reselect View (p. 35). The headings will only appear after you reselect the view.

Page Label BoxThe page label box to the top left of a table provides a drop-down menu listing all the pages in the current selection.

The drop-down menu can be sized or moved. Ctrl+Click on it so the handles appear round the edge. To size it, drag one of the handles. To move it, Click+Drag one of the edges.

This menu only provides a means of changing the text in the cell underneath it. It is the text written in the cell underneath that defines the page that is displayed, not the menu itself. This text is referred to by the range name analyst_page_1, contained in the note in the red Analyst cell.

Note: The Analyst cell exists in spreadsheets created with Analyst Add-in for Excel 2.4 or earlier. In post version 2.4, the name of the D-Cube is placed above the page labels by default.

It can be convenient to move the page label box to a different part of the screen so that formatting can be applied to the page text. It is this text and not the drop-down menu that is used when it comes to refreshing the table.

Range NamesThe range names in the Analyst note define where to look in the spreadsheet for the labels.

Steps1. From the Insert menu, click Name, Define.

2. Select a range name such as analyst_row_1.



ExampleIf you have a range name analyst_row_1 that happens to be defined as =$B$6:$B$14, Analyst will look within this range for labels that match exactly with items in the D-list (p. 14). It knows which D-Lists to look in from another part of the Analyst note in version 2.4 and earlier, and the D-Cube name in post version 2.4.

Since the cell references in range names are updated when you cut and paste cells, you may move the table around and insert rows and columns as needed.

If you have laminated dimensions (p. 16), such as a row label set consisting of two (or more) D-Lists, then the range covers both sets of labels.

Sharing PagesWhen you have two views, both with the same D-List (p. 14) as page labels, you can set them to scroll simultaneously by setting up a formula to set the page label text of one view to be equal to the page label text of the other.

You can easily share pages of views.

Steps1. Remove the drop-down menu of one of the views.

2. Ctrl+Click on the drop-down menu, and then press the DELETE key.

3. Set up a normal Microsoft Excel formula that refers to the page label text underneath the drop-down menu in the other view.

If there are two or more page labels, you can choose to set either one or both to scroll simultaneously, again using formulas to refer to the text underneath the drop-down menus.

You can choose to stop sharing pages too.

Steps• Move the cursor to the page label text of the view that does not have the drop-down menu

and remove the formula. • To insert a drop-down menu in its place, from the Analyst menu, click View, Define View

(p. 39). A new drop-down menu will be inserted in the position you choose for the page labels.


Chapter 3: Macros, Assigning Actions, D-Links

Cognos Planning - Analyst Macro ListIf you inspect the list of available Macros from within the VBA editor, you will see a large number of names. Most of these are internal macros which you can not safely use.

Note: Cognos does not guarantee that these macros will continue to exist in future releases of Cognos Planning - Analyst Add-in for Excel. You should only use macros described in the following list.

Important: If you have macros created from previous releases, the Adaytum Macros are still available for use, but only for backward compatibility purposes. Cognos does not guarantee that these macros will continue to exist in future releases of Analyst Add-in for Excel.

The following example shows a macro that runs the ProfitAndLoss>AmericasOverheads D-Link and then executes the Open Profit and Loss macro in Analyst. The name of the library containing the D-Link and the Analyst macro is TutorialGO. Sub Company_update() Application.Run "Analyst_DLinkExecute", "TutorialGO", "ProfitAndLoss>AmericasOverheads" Application.Run "Analyst_MacroExecute", "TutorialGO", "Open Profit and Loss" End Sub

To see which macro is assigned to an object, right-click the object and then click Assign Macro. The Assign Macro dialog box appears and displays the name of the macro referred to by the object.

If a macro does not run, check that the name of the library, D-Link, D-Cube, or Analyst macro has not changed since the macro was created. Names referred to in the macro are case sensitive.

Assign ActionButtons, text boxes, bitmaps, and arrows may be assigned actions such as refreshing, recalculating, getting write access, releasing write access, saving, printing, running macros or a D-Link (p. 14), or logging on and off. Macros and D-Links may be run directly.

Macro name Parameters Description

Analyst_CubeRefresh (Adaytum_CubeRefresh)

Refresh the current view

Analyst_CubeRefreshAll (Adaytum_CubeRefreshAll)

Refresh all views

Analyst_CubeUpdate (Adaytum_CubeUpdate)

Update the current view

Analyst_DLinkExecute (Adaytum_DLinkExecute)

Library name, D-Link name

Run a named D-Link (p. 14)

Analyst_MacroExecute Library name, Macro name

Run a named Analyst macro



To find the action assigned to an object, from the Insert menu, click Name, Define, and select the relevant range name. For text boxes, buttons, or any object with a text field, edit the text and scroll down, or click and drag the lower border of the text box. The name of the action is shown at the bottom.

Arrows can be dragged around a spreadsheet, but you will lose the assigned action if you use the Copy, Cut and Paste commands. Only buttons and objects with text fields can use the Copy, Cut and Paste commands and still keep their assigned actions.

Assign Action: Get Write AccessAssigns the Read Write Access (p. 29) action to an object such as a text box, button, or bitmap. If no object has been selected, then a text box will be created by default.

Select the red cell to the top left of the view for which you want to get write access.

FunctionGets write access for a selected D-Cube (p. 13) to prevent other users from writing to it while you are busy making changes.

Assign Action: Log OffAssigns the Log Off action to an object such as a text box, button, or bitmap. If no object has been selected then a text box will be created by default.

FunctionLogs you off Analyst.

Assign Action: Log OnAssigns the Log On action to an object such as a text box, button, or bitmap. If no object has been selected then a text box will be created by default.

FunctionLogs you on to Analyst.

Assign Action: PrintAssigns the Batch Printing (p. 26) action to an object such as a text box, button, or bitmap. If no object has been selected, then a text box will be created by default.

1. Select the red cell to the top left of the view you want to print.

2. Click on the text box or button to run the Create Sheets command to copy the selected view onto a new worksheet per page selected.

3. When you have finished creating the sheets, from the Analyst menu, click Batch Printing, Print Sheets, or from the File menu, click Print to print out selected sheets.

Assign Action: RecalculateAssigns the Recalculate (p. 30) action to an object such as a text box, button, or bitmap. If no object has been selected then a text box will be created by default.



Select the red cell to the top left of the view you want to recalculate. If there are unprocessed entries in another view of the same D-Cube (p. 13) in the workbook, you will be asked if you want to recalculate this view as well. It will refresh all views of the D-Cube after recalculating.

FunctionRecalculates the current view using formulas held in the D-List (p. 14).

Assign Action: RefreshAssigns the Refresh (p. 30) action to an object such as a text box, button or bitmap. If no object has been selected then a text box will be created.

Select the red cell to the top left of the view you want to refresh.

FunctionRefreshes selected view and any other views of the same D-Cube (p. 13).

Assign Action: Release Write AccessAssigns the Read Write Access (p. 29) action to an object such as a text box, button or bitmap. If no object has been selected then a text box will be created by default.

Select the red cell to the top left of the view for which you want to release write access.

FunctionReleases write access for a selected D-Cube. It is used primarily in multi-user systems to allow someone else to enter and save data into a D-Cube.

Assign Action: Run D-LinkAssigns the Run D-Link (p. 22) action to an object such as a text box, button, bitmap or arrow. If no object has been selected then a text box will be created by default.

FunctionRuns a specified Analyst D-Link (p. 14).

Assign Action: Run MacroAssigns the Run Macro (p. 22) action to an object such as a text box, button, bitmap or arrow. If no object has been selected, then a text box will be created by default.

FunctionRuns a specified Analyst macro, but not an Excel macro. Right-click on an object and select the Assign Macro command to run an Excel macro.

Assign Action: SaveAssigns the Save D-Cube (p. 31) action to an object such as a text box, button or bitmap. If no object has been selected then a text box will be created by default.

Select the red cell to the top left of the view you want to save.



FunctionSaves the data currently held in the underlying D-Cube (p. 13) that the view is using.

Drill-DownUse Drill-Down to analyze the contents of a cell. This will display all the D-Links targeting a D-Cube.

Steps1. From the Analyst menu, click Drill-Down.

2. Select one or more D-Links to drill back down to find the components (if any) that went into the target cell. You should only highlight one cell to drill-down from at a time. If you highlight a range, then only the first cell is considered.

Drill down will display these items in a normal view on a separate sheet. If there is no relevant D-Link, then there is nowhere to drill down to and no result will be displayed.

If the drill-down produces a result that is different from that displayed in the target cell, it usually means that the D-Link has not been run recently, or the cell was affected by breakback.

Drill-down can analyze several D-Links at a time, but cannot drill-down on links from sources outside Analyst.

Run MacroThe Run Macro command is available from the Analyst menu. You can run an Analyst macro but not a Microsoft Excel macro. Select one of the available macros that appear in the Select Macro box.

Run D-LinkThe Run D-Link command is also available from the Analyst menu. You can run an Analyst D-Link (p. 14) by selecting one of the available D-Links that appear in the Select D-Link box. The available D-Links target the D-Cube in the active View.

Visual Basic CommandsThe following Visual Basic commands can be used in Microsoft Excel macros. The exact syntax may vary depending on your version of Excel.

Example Description

Workbooks.Open "C:\Test\Test.xls" Open an Excel file

Sheets("Sheet1").Select Make Sheet1 the active sheet

Range("A1").Select Make A1 the active cell

ActiveCell.Value="99" Set the contents of the active cell to 99

For i = 1 to 3 Sheets(i).PrintOut Next i

Print sheets 1 to 3

For i = 3 To 1 Step -1 Sheets(i).PrintOut Next i

Print sheets 1 to 3 in reverse print order



You can continue long lines by ending them with a space and an underscore character. You can put comments in by preceding them with a single quote character.

Example of a macro to open another Excel file and print sheets 1 to 3 in reverse print order.

Macro1 Macro

Sub Macro1()Workbooks.Open "c:\test\test.xls"For i = 3 To 1 Step -1 Sheets(i).Select Sheets(i).PrintOutNext iEnd Sub




Chapter 4: Print and Formatting

Page Setup

Steps1. From the File menu, click Page Setup. From this screen, you can set portrait and landscape

orientation, fit-to-page settings, margin settings, header and footer information, and sheet settings for all sheets at once.

2. Click OK after all settings are made. For information about printing sheets, see Print Sheets (p. 25).

Print Sheets

Steps

1. From the Analyst menu, click Batch Printing, Print Sheets.

2. Click Zoom, Margins, or Page Break Preview to view more details of the current sheet.

3. Click Setup to change the portrait/landscape orientation and the fit-to-page settings for the individual sheet that is displayed. Note: Using Page Setup prior to printing the sheets allows you to set the portrait/landscape orientation and the fit-to-page settings for all sheets at once. Once you are in Print Preview mode, you can only change these settings a sheet at a time.

4. If all settings are correct, click Print.

Number and Date Formats

Scaling FormatIf you have scaled a number in Cognos Planning - Analyst, it is the underlying value that is pulled into Microsoft Excel, not the scaled number. So the number 1234 could be displayed in thousands as 1.2 in Analyst, but the underlying value would come through to Excel as 1234. If you want to format a cell in Excel so that it divides the underlying number by 1000, then from the Format menu, click Cells, Custom. In the Type box, enter 0.0, (zero point zero followed by a comma). This will display 1234 as 1.2

Percentage FormatIn Analyst, 10% is stored as 10, whereas in Excel it is stored as 0.1. You can format the number 10 so it displays as 10.0% in Excel.

Steps1. From the Format menu, click Cells, Custom.

2. In the Type box, enter 0.0"%" (zero point zero followed by the percent symbol in double quotes). This will display 10 as 10.0%.



Number and Date Formats Set in AnalystNumber and date formats set at D-List (p. 14) item level and D-Cube level in Analyst are not brought in automatically, but must be set in Excel using the Cells command from the Format menu. If you do not use a 4 digit year format, dates whose year component is less than 50 are assumed to refer to the new millennium. So 1/1/00 is the first of January in the year 2000.

Numeric FormatsIf you have set a numeric format in Analyst, then decimal formatting, blank if zero, thousand separators, and negative number formatting will all be respected in Excel, but prefixes and suffixes are stripped out. Once set, custom numeric formats do not get overwritten on refresh, which allows you to apply your own formatting directly in Excel. If the formatting is set to None in Analyst, then it uses the Analyst default (1,235). Any subsequent change to the numeric formatting in Analyst will not change an existing Excel view, even after a refresh, unless a cell has a general (non-specific) format applied in Excel.

Negative numbers: -1234.5 and (1234.5) are both allowed as negative number formats. The leading minus sign or a Close Bracket symbol immediately after the last digit indicates which format to use. Prefixes and suffixes are stripped out. So (£1234.56) displays as (1234.56) in Excel. (1234.56)FF displays as (1234.56) in Excel. However (1234.56FF) is displayed as -1234.56 because the close bracket symbol does not immediately follow the last digit.

Prefixes and Suffixes: Prefixes and suffixes set in Analyst are stripped out when displayed in Excel. To apply a prefix or suffix, use a custom numeric format in Excel. To return to the numeric format used in Analyst, excluding prefixes and suffixes, use a General numeric format in Excel.

Percentages: The percentage symbol is stripped out when displayed in Excel. For example, 17.5% in Analyst displays as 17.5 in Excel. The reason for this is that 17.5% is stored as 0.175 in Excel, 17.5 in Analyst. Therefore, to avoid confusion, the absolute number is brought through into Excel.

Note: The negative number format (17.5%) is displayed as -17.5.

Thousand separator: You may set the thousand separator in Analyst and this will appear in Excel. This is derived from the regional settings in Control Panel.

Decimals: The number of decimal places is set in Analyst. The decimal separator used in Analyst is derived from the regional settings in Control Panel.

Blank if zero: This can be set in Analyst and will display zeros as a blank cell.

Print MacrosFor more advanced users, you may wish to record and/or edit your own print macro. This will allow you to select precisely which pages to print by editing the page names in the macro.

Note: It is safer to use range names found in the Analyst note rather than cell references that may change as the table is moved around.

Batch Printing

Steps1. Create Sheets (p. 27) - Copy the current view onto a series of separate worksheets (one

page per worksheet). It will take a minute or two to create each new worksheet. Upon completion, the worksheets will remain grouped, so any formatting applied to the top sheet will apply to all the other worksheets.

2. Select print settings.

3. Print Sheets (p. 25) - Print the selected sheets.

Each new worksheet becomes a separate view of the same D-Cube. You have the choice of applying the formatting before (Page Setup) or after (Print Sheets) when creating the sheets. If you apply formatting before creating the sheets, it will take longer to produce, but will be easier to maintain. The pages remain on separate sheets after printing.



Create Sheets

Steps 1. From the Analyst menu, click Batch Printing, Create Sheets. The Analyst Batch Print 1 of

2 screen appears, allowing options for selecting the items in the pages, rows, and columns that you want to print.

2. Under Selection type, select Detailed Selection (p. 27), Saved Selection (p. 27), or Entire Cube (p. 27). Select the items you want to print.

3. Click Next to go to the Analyst Batch Print 2 of 2 screen.

4. The Analyst Batch Print 2 of 2 screen lets you choose which pages to be omitted and which pages to be created.

5. Click Select existing pages to highlight all pages previously selected. The Select existing pages button allows you to highlight all existing pages of views of that D-Cube. This avoids recreating sheets that were previously inserted in a batch print.

6. Click the left arrow to move the highlighted page(s) to the Pages to be omitted column. This leaves only the new pages included in the Pages to be created column.

7. Select the Save workbook after creating every 100 sheets check box to set the automatic save function, which will automatically save the workbook after every 100 sheets are created.

8. Click Finish.Note: If you want to abort the creation of batch sheets, press and hold the ESCAPE key. Excel displays the Microsoft Visual Basic code interrupt dialog box. Click End to abort the create sheets process.For information about printing and formatting, see "Print Sheets" (p. 25) and "Number and Date Formats" (p. 25).

Detailed Selection

Steps1. From the Detailed selection drop-down list, choose what D-List page you want to print.

2. For each D-List in turn you can select and order the items you want to show in the view.Items included appear in the right-hand list. A blank selection is taken to mean all items, but unlike in Analyst, it does not include items that may be added at a future date. To sort in D-List order, highlight the items you wish to sort on the right-hand list, then click Sort. Sorting based on data values or other criteria can only be done in Excel. You may also Expand selected subtotal or formula items to highlight the components of the subtotal. Note: From within Detailed selection, instead of choosing a specific page, you may select the Entire D-List check box to include all items in the D-List. If you insert, delete, re-order, or rename an item in Analyst, it appears in the selection automatically. Select Entire D-List if you want all items excluded.

3. Click Next to go to the Analyst Batch Print 2 of 2 screen.For information about creating sheets, see "Create Sheets" (p. 27).

Saved SelectionThe Saved selection option looks for saved selections in the D-Cube. If it finds any saved selections, you can choose one of these to print from the Saved selection drop-down list.

For information about creating sheets, see "Create Sheets" (p. 27).

Entire CubeThe Entire Cube selection includes all D-List pages and all items.

All other options on the Analyst Batch Print 1 of 2 screen are grayed-out.

For information about creating sheets, see "Create Sheets" (p. 27).




Chapter 5: Refreshing, Recalculating, Saving

Partial RefreshA partial refresh can be achieved by using the colon (:) as a null character meaning 'do nothing'.

If you enter a colon (:) in a cell, then from the Analyst menu, click Recalculate, Selected View or Recalculate, All Views; it has the effect of refreshing cells with colons entered, and recalculating cells where the numbers have changed in Microsoft Excel.

To enter a colon (or any other number or command) across multiple cells, highlight all the target cells, type a colon : into any one of them, then press Ctrl+Enter. It will then enter the colon in all the highlighted cells.

Read Write AccessWrite access allows you to save changes back to a D-Cube (p. 13).

Read access allows you to view the data and try out changes, but not to save the data in the D-Cube.

To change Read/Write settings, from the Analyst menu, click Read Write Access.

Generally, the read/write access settings are only relevant when you have multiple users trying to enter data in the same D-Cube simultaneously. Write access to a D-Cube can only be given to one user at a time.

In the case of multiple users accessing views of the same D-Cube, the first person to recalculate, or the first to click the Write button, will gain write access. Other users can still recalculate, but cannot save any changes back to the D-Cube until you click the Release button to allow others write access to the D-Cube. Any number of users can read the data at any one time. The current access status will be displayed. If the Write button is greyed out, you may already have write access.

The Read/Write settings apply to the whole D-Cube, not just a part of it. This means that even if two users are trying to write to different views with non-overlapping selections, they still cannot both write to the D-Cube.

You may set options to refresh and/or gain write access automatically on opening the Microsoft Excel file and logging on to Cognos Planning - Analyst Add-in for Excel.

If you want an Excel report always to be refreshed from the latest data, make sure that Refresh View on Loading option is enabled. On opening the Excel file, this will log on to Cognos Planning - Analyst and then refresh the selected view.

If you always want to enter data via the Excel view, then make sure that the Get Write Access on Loading option is enabled. The default is for both options to be disabled. If an Excel workbook contains views from several D-Cubes, then these options must be set for each D-Cube separately. However if there are several views all from the same D-Cube, then once you have set it for one view it applies to all the others.



Recalculate

Steps1. From the Analyst menu, click Recalculate, Selected View or Recalculate, All Views to

process the numbers entered in an Microsoft Excel view. This will send the numbers back into the underlying D-Cube and use the formulas held in Analyst to calculate the results.

2. After recalculation, click Save D-Cube from the Analyst menu. The results are only saved in Analyst if you save the D-Cube.

Recalculate Selected ViewRecalculates based on the data in the Excel view. If other dependent views of the same D-Cube in the workbook contain unprocessed entries, you will be asked whether you want to recalculate or refresh these views.

Recalculate All ViewsProcesses the numbers you have just typed into the current view in Excel and recalculates all views of all D-Cubes in the workbook.

Rules For RecalculatingIf the active view of the D-Cube has been customized within Excel, the following rules apply when recalculating: • Rows, columns, or pages that are not an exact character match of a D-List (p. 14) item are

ignored. The matching process is case-sensitive. • If other views of the same D-Cube overlap, then both views will be recalculated. If you have

inadvertently targeted the same cell with conflicting numbers, then the earlier named view will have priority. The view name and number is found by choosing View Options (p. 42).

• Unless an Excel formula has been defined, it uses the formulas defined in Analyst to calculate the results. Excel formulas will not be overwritten unless you choose the option Overwrite Excel formula on refresh (p. 47). This will overwrite any Excel formula where the labels match D-List items. It includes overwriting numbers, such as =30+20, entered in a cell.

• You are allowed to use Breakback (p. 13) to set targets for Analyst formulas. You may breakback from an Excel detail item or from an Excel formula item. From the Analyst menu, click View, Options to disable or enable Breakback settings.

• If the auto-color options are on, the numbers turn red to indicate they have changed. Invalid items turn red (or red on grey) to show that they no longer match a D-List item.

• If the workbook and worksheet are not password protected, protected cells are overwritten and left protected. If the worksheet is password protected, they will not be overwritten.

RefreshFrom the Analyst menu, click Refresh, Views of D-Cube, Selected View or All Views to ensure that a Microsoft Excel view has been updated with the latest numbers held in Analyst. A refresh will pull in the latest data into any cell where the row, column, and page labels match the underlying D-List (p. 14) items exactly, and the cell lies within the ranges defined for the row and column labels. It refreshes the numbers (rather than the labels) and will over-write unprocessed entries.

Generally it will use the formulas in Analyst to calculate the results. Provided the labels match D-List items exactly, cells with Excel formulas will not be overwritten unless the view option to Overwrite Excel formula on refresh (p. 47) has been selected. This includes numbers entered as formulas, such as =30+20, entered in a cell.



Refresh Views of D-CubeRefreshes the active view (where the cursor is), and all other views of the same D-Cube in the workbook, with the latest values held in Analyst. It will not refresh the numbers in views from other D-Cubes.

Refresh Selected ViewRefreshes the active view only (where the cursor is), by pulling in the latest data from Analyst. It will not refresh the numbers in other views.

Note: If you turn off the Check for unmatched items option from the Analyst Default Options screen (choose Options from the Analyst menu), the program will cease to check for renamed or obsolete items. Keep this option turned on to ensure your selection is up-to-date after each refresh.

Refresh All ViewsRefreshes all views in the active workbook with the latest values held in Analyst.

Reset D-CubeFrom the Analyst menu, click Reset D-Cube to reset the D-Cube in Analyst back to the saved version, and refresh the active Microsoft Excel view. It will also refresh any other view in the workbook that uses the same D-Cube. This will not reset the spelling or selection of row and column labels, nor will it reset views of other D-Cubes.

If you want to keep some of your changes, select and copy them to an unused part of the worksheet before running this command. After the data is restored, copy your changes back into the active view and recalculate.

Save D-Cube

Steps1. From the Analyst menu, click Save D-Cube. If you have unprocessed entries, you will be

prompted to recalculate prior to saving.

2. The dialog box that appears shows the D-Cube (p. 13) name in the upper box and the views belonging to the D-Cube in the lower box. You must select the D-Cube(s) you want to save, then click Save. You may have to click Save several times if you have views from several D-Cubes in your Microsoft Excel file.

Note: From the File menu, click Save to save the Excel formatting and the numbers in Excel, but will not save the numbers in the D-Cube in Analyst. If you are entering numbers through Excel, it is important to recalculate all views, and then save the D-Cube before saving the Excel file and exiting. You will not be allowed to save the D-Cube unless you have Read Write Access (p. 29).




Chapter 6: Reselecting and Auditing

AuditingThe Auditing menu commands allow you to verify that a report is up to date and accurate. As well as refreshing with the latest data held in Cognos Planning - Analyst, you may check for items that have been renamed, deleted, inserted, moved, or put in a different subtotal in an underlying D-List. You may also check to see if the object names contained in the notes and referred to by buttons have been renamed. The object names you are allowed to update are the system name, library name, D-Cube (p. 13), D-List (p. 14), D-Link (p. 14) or Macro name.

Check Active View for BlanksChecks the active view for blank cells. The search occurs row-wise, starting from the top left. The first blank cell found becomes the active cell so you can change the value.

If no blanks are found, the cursor stays where it is.

Check Active View for ErrorsChecks the content of each cell in the active View for an Excel error code such as #VALUE!, #DIV/0!, ERR or #NAME?. The search occurs row-wise, starting from the top left. The first cell found with an error code becomes the active cell so you can change the value.

If no errors are found, the cursor stays where it is.

Check Integrity of ViewsChecks all named ranges in the workbook. If they are related to Analyst, it checks that the range names are valid and removes those that are no longer used. This can be a convenient way of cleaning up the workbook.

Check View for Renamed D-List ItemsSometimes you have to check a view for items that have been renamed in the D-List (p. 14) or in Excel.

Steps1. From the Analyst menu, select Auditing, Check view for renamed D-List items. The

left-hand list contains a list of all invalid items within the ranges defined for the row, column, and page labels that do not match an existing D-List item. The right-hand list shows the items in the D-List that are not included of the view. This will comprise new items, renamed items, and items that were never part of the current selection.

2. To rename an item in Microsoft Excel, highlight the invalid item on the left and the corresponding item on the right. Click Match to move the pair of items to the Matched Items list. Repeat for each D-List in turn.

3. If you wish to delete an Obsolete item from the left list, highlight the invalid item and click Delete. The item is moved to the Deleted items box. You can click Un-Delete to move the item back to the original location.

4. If you need to insert new items rather than just renaming existing items, click Analyst, Reselect View (p. 35).



Replace Object Names In All Definitions

Replacing the Analyst Object Name

Replaces a text string throughout the workbook in all the Analyst notes and all the buttons, text boxes, arrows, and other objects that have Analyst actions assigned to them. This is of particular use if a library, D-Cube (p. 13), D-List (p. 14), D-link (p. 14) or other object has been renamed in Analyst, but not in Microsoft Excel. Unless you update the text in the note, this will cause an error when you come to refresh, recalculate, or use the Analyst object.

The Analyst object names you are allowed to update are the System name, Library name, D-Cube, D-List, D-Link or Analyst Macro name. The names are all case-sensitive. You will be shown a list of all the valid object names from all the libraries on your system.

Renaming a Worksheet Containing Buttons or Text Boxes

If you rename a sheet that contains text boxes or buttons, actions will only function if you also replace the old sheet name with the new sheet name. For example, suppose you assign an action to a button (or text box) that refreshes a view. The button caption will be Refresh, the view it refers to might be Sheet1!Analyst_view_1. If you rename the sheet so it is called NewName, then the view it refers to needs to be changed to NewName!Analyst_view_1. To edit the view name, Ctrl+Click on the button and scroll down inside the text field of the button until you reach the view name.

Show Precedents of FormulaAllows you to check a highlighted selection for items missing and for invalid items contained in formulas. The highlighted selection should contain both the label containing the formula and its precedents. A precedent is a variable used to calculate the formula result. For example, in the formula Z= X + Y, the variables X and Y are precedents of Z.

Invalid or superfluous items that have been identified by the audit checks can be copied to the windows clipboard by copying and Pasting to a blank area of the spreadsheet. They may then be used to correct the existing labels by cutting and pasting the new items into the middle of the row or column labels.

Show Precedents of Formula only applies to row or column labels, not to page labels.

Incomplete TotalsThe message 'View … contains incomplete totals ..' means that some of the components of a subtotal are missing, possibly due to the renaming or deletion of the item in Microsoft Excel or Analyst.

Updating Your View

Steps 1. From the Analyst menu, click Reselect View.

2. If items have been renamed, the Update D-List Items (p. 35) screen will appear allowing you to rename items in Excel. Ctrl+Click on pairs of matching items, then click Match to move them to the Matched items boxes in the lower half of the screen.

3. If necessary, repeat the last step for each D-List in turn.

4. Click Yes to convert to custom items. If a row or column has been deleted recently in Analyst, then it will still exist as a row or column in Excel. You risk losing data by deleting such items automatically, so you should convert them into custom items (p. 13). Custom items remain in the Excel view, but are not refreshed from Analyst, so you should delete these items later using normal Excel commands, once you have checked that you no longer need the data. Custom items appear in red, assuming the standard color options are on.



5. From the Reselect View (p. 35) screen, select the items to appear in the view. To identify items that are missing from subtotals, first highlight the entire 'Items included' list on the right (A short-cut is to highlight the first item, then press Shift+End), then click the Expand button. Any items missing will be highlighted. Click the right arrow button and move these items into the Items Included list and sort as required.

6. If necessary, repeat the last step for each D-List in turn.

7. Click OK. The missing items will be inserted in the view.

8. From the Analyst menu, click Refresh, Selected View to ensure the numbers in the view are up to date.

9. Optional: Custom items will be colored red, assuming the auto-color option in Formal Options (p. 44) is on. Since custom items will no longer be refreshed from data held in Analyst, it is advisable to delete these from your view permanently.

Pick Item From D-ListTo enter text corresponding to items in a D-List (p. 14), from the Analyst menu, click Pick Item from D-List. A list box will appear showing all the available items in the D-List. This only applies to rows and columns that have a D-List format. It does not apply to items that have been formatted to accept free text, numbers or dates. You must always be logged on to Analyst if you want to use this facility.

Reselect ViewReselect the items that make up the rows, columns, and pages of the current view.

Steps1. From the Analyst menu, click Reselect View.

2. If items have been renamed or deleted since you last refreshed your report, Reselect View will first take you to the Update D-List Items (p. 35) screen so you can match the old labels against the renamed D-List (p. 14) items. If all items in your selection are valid, Reselect View takes you straight to the Analyst Reselect D-List Items screen.

3. The Analyst Reselect D-List Items screen allows you to select Detailed selection (p. 38), Saved selection (p. 38), Entire Cube (p. 38), and Entire D-List (p. 38) to include in your view. Custom items (p. 13) in Excel do not appear in the Analyst Reselect D-List Items screen.

4. Click Sort to sort highlighted items in the right-hand list into D-List order, or use the up and down arrows to move item(s) in the list on the right. An item or group of items can also be sorted by de-selecting with the left arrow key then highlighting an insertion point on the right-hand list. Click the right arrow to insert just below the chosen point.

5. Click Expand to highlight the items that make up a highlighted subtotal or formula item. This will highlight any item missing from a subtotal or formula. If you want missing items to appear in your view, click the right arrow to move them to the Items Included list on the right. Expand generally applies to formula items, the exception being detail items such as price and cost per unit that are weighted averages. If you expand these items, then it will include the item that is used as the weighting factor. If you clear the Check for unmatched items check box in the Analyst Default Options screen (choose Options from the Analyst menu), the program will cease to check for renamed or obsolete items. Keep this check box selected to ensure your selection is up-to-date after each refresh.

Update D-List ItemsThe Update D-List Item screen allows you to rename items so that they correspond to items in the D-List (p. 14). Items will be brought to your attention if they have been renamed or deleted in the underlying D-Lists.



If you have items that are not an exact character match of D-List items, then you can match or delete invalid items on the left against available D-List items on the right. To appear in the list, the items must be within the ranges defined for rows, columns, and pages. Only D-List items not currently selected will appear in the right-hand list. Custom items (p. 13) will not appear in either list.

To Rename and Match Items

Steps1. From the Analyst menu, click Reselect View (p. 35), or Auditing:Check view for renamed

D-list Items (p. 33).

2. To correct the spelling of items, highlight the corresponding items, then click Match.

3. Once you have matched as far as you can, click OK.

4. Converting the unmatched items to Custom items (p. 13).

• If you choose Yes, the unmatched rows and columns will remain in the view in Microsoft Excel, but will no longer be refreshed from Analyst.

• If you choose No, you will go back to the previous screen where you can continue with the matching process. Be sure to check each D-List in turn for unmatched items.

5. If you chose Reselect View (p. 35) you have the option to reselect or delete any new items you want to include or exclude in your view.


Chapter 7: Views

OptionsFrom the Analyst menu, click Options to set the default view options. These options will apply to all views set up in the future, but will not apply retrospectively.

The recommended options are:

All other options are off.

Note: If you are using autoformats, it is advisable to turn the foreground and background colors off to prevent these from overwriting the autoformat colors. From the Analyst menu, click View, Options to change color options.

Analyst System MessagesIf you turn Analyst System Messages OFF, it will no longer show the non-essential prompts and cautions. This is primarily for use when recording macros. However, even if you turn Analyst System Messages OFF, it will continue to show any serious message where there is a possibility of losing data or an error has occurred. The Analyst System Messages can only be turned off temporarily for a session, and will be turned on again each time you log on.

AutoFormatCognos Planning - Analyst Add-in for Excel uses the standard Microsoft(R) Excel auto-formats. The following options are available: Number, Font, Alignment, Border, Patterns, and Width/Height. You must choose at least one format option. You can apply more of these options at a later date, but you can't de-select these options retrospectively.

Steps1. From the Analyst menu, click View, AutoFormat.

2. Choose from 16 standard Excel table formats to display D-Cube information in Excel, then choose what formats to apply to the D-Cube including Number, Font, Alignment, Border, Patterns, and Width/Height. Click OK.Note: To entirely remove an existing table format, select None from the Table Formats list.

Auto-Color Foreground & Background Data Cells ON

Auto-Color Foreground D-List Cells ON

Check for unmatched items ON

Check for incomplete totals ON

Allow Breakback on recalculate ON


Chapter 7: Views

3. You may change autoformats when creating a new view. Step 5 is the AutoFormat option. Note: If you are using autoformats, it is recommended you turn the foreground and background colors OFF to prevent these from overwriting the autoformat colors. From the Analyst menu, click View, Options. To preserve any custom formatting you may have applied, autoformats are not re-applied automatically on refresh. If you insert new items immediately below formatted subtotals or column headings, Excel will take the formatting from the previous row. From the Analyst menu, click View, Autoformat to re-apply autoformatting.

Dynamic Selections

Detailed SelectionThe Detailed selection is available in the Selection type box. You can choose a D-List from the Detailed section box. For each D-List in turn you can select and order the items you want to show in the view. Items included appear in the right-hand list. A blank selection is taken to mean all items, but unlike in Cognos Planning - Analyst, it does not include items that may be added at a future date. To sort in D-List order, highlight the items you wish to sort on the right-hand list, then click the Sort button. Sorting based on data values, or other criteria, can only be done in Microsoft Excel. You may also Expand selected subtotal or formula items to highlight the components of the subtotal.

Entire D-ListThe Entire D-List option is part of the Detailed selection option. This selection puts all items into the view in D-List order. On refresh, any new items that were added to the underlying D-List would be inserted in the correct place automatically. Any old items that had been deleted would be deleted automatically. Any items that had been renamed in Analyst would be renamed in Excel. The selection will always respect the current D-List order.

Saved SelectionThe Saved selection is available in the Selection type box. This allows saved selections to come through to Analyst Add-in for Excel. This option is only available if you have named saved selections held in Analyst.

Entire CubeThe Entire Cube selection is available in the Selection type box. The Entire Cube option in New View, Define View, and Reselect View puts all items, present and future, from all D-Lists and from all dimensions, into the view. Items may be inserted, deleted, re-ordered, or renamed at a later date. On refresh, any new items that were added to the underlying D-List are inserted in the correct place automatically. All deleted items are deleted automatically, and all renamed items are deleted and brought back in with the new name.

Select Existing PagesThe Select existing pages button lets you highlight all existing pages of views of a D-Cube. This avoids recreating sheets that were previously inserted in a batch print. Click Select existing pages to highlight all pages previously selected. Click the left arrow to move the highlighted page(s) to the Pages to be omitted column. This leaves only the new pages included in the Pages to be created column.

ViewA view is defined as a single table. It consists of a selection of rows, columns, and pages from a single D-Cube in Analyst.


Chapter 7: Views

You can have multiple views of the same or different D-Cubes on each worksheet. Although performance is maximized when you use three or less D-Cubes per workbook, there is no theoretical limit to the number of D-Cubes you can use in each workbook.

Define ViewThe Define View menu command allows you to convert part of an existing Microsoft Excel spreadsheet to a view from an Analyst D-Cube (p. 13). Define View will also allow you to edit, repair, or convert an existing view. Since you can define precisely which D-List (p. 14) appears where, it will also allow you to slice a view so that the rows, columns, and pages can be swapped over.

If you are converting an existing Excel table, then the row, column, and page labels must be an exact match against the D-List items in order to pull in data successfully from Analyst.

Steps1. From the Analyst menu, click View, Define View.

2. If you already have a view open, a message appears asking if you want to redefine the view. Click Yes.

3. From the Analyst Define View 1 of 6 screen, if it is a new view, you will be asked to select the name of the D-Cube and the library it belongs to. If it is already a view of a D-Cube, you will be asked if you want to convert the existing view. Click Next.

4. From the Analyst Define View 2 of 6 screen, enter the cell positions or ranges where the Analyst cell address, the page label(s), the row labels and column labels are to appear in your report. Click Next.

5. From the Analyst Define View 3 of 6 screen, define which D-List is to be used for the row, column, and page labels, then click Match to confirm the pairing. Click Next.

6. From the Analyst Define View 4 of 6 screen, you are given the opportunity of matching any changed or misspelled D-List items against valid D-List items. The matching process is case-sensitive. You may also delete unmatched D-List items by highlighting the items and clicking Delete. Click Next.

7. From the Analyst Define View 5 of 6 screen, you may only refine the selection for the pages, but not for rows and columns. Select Detailed Selection (p. 38), Saved Selection (p. 38), or Entire Cube (p. 38) under Selection type. Click Next.

8. From the Analyst Define View 6 of 6 screen, select the View Options (p. 42) to make final adjustments to appearance and behavior. Note: If you clear the Check for unmatched items check box in the Analyst Default Options screen (choose Options from the Analyst menu), the program will cease to check for renamed or obsolete items. Keep this check box selected to ensure your selection is up-to-date after each refresh. You may specify the suffix to the range name for the view. For example, if the Range Name suffix is entered as 1, the full range name for the view would be Sheet1!Analyst_view_1. Note: If you are using autoformats, it is advisable to turn the foreground and background colors off to prevent these from overwriting the autoformat colors. Choose View from the Analyst menu and select Options. To preserve any custom formatting you may have applied, autoformats are not re-applied automatically on refresh. If you insert new items immediately below formatted subtotals or column headings, Excel will take the formatting from the previous row. You may re-apply autoformatting by choosing View from the Analyst menu and selecting Autoformat.

9. Click Finish to create the view. Once the view has been defined, notes containing the D-List name will be attached to all valid cells.


Chapter 7: Views

New ViewCreates a new view in Microsoft Excel based on data held in a D-Cube (p. 13) in Analyst. You are allowed several views of the same or different D-Cubes on each worksheet. You can have several worksheets in an Excel file.

Steps1. From the Analyst menu, click New View.

2. From the Analyst New View 1 of 5 screen, select a D-Cube from one of your libraries, and then click Next.

3. From the Analyst New View 2 of 5 screen, select which D-List (p. 14) you want to appear as rows, columns and pages by selecting a D-List and clicking the up or down arrow button. You can combine any number of D-Lists on each dimension. Click Next.

4. From the Analyst New View 3 of 5 screen, choose Detailed Selection (p. 38), Saved Selection (p. 38), or Entire Cube (p. 38) under Selection type.

5. From the Analyst New View 4 of 5 screen, select the view style as Normal, Hierarchical or a Pivot table. Note: If you clear the Check for unmatched items check box in the Analyst Default Options screen (choose Options from the Analyst menu), the program will cease to check for renamed or obsolete items. Keep this check box selected to ensure your selection is up-to-date after each refresh.

6. You may set the automatic color-coding, the suppress zero rows option, replicate headings (laminated dimensions (p. 16) only) and set checks to warn if the D-Lists are modified at a later date. You may choose the option to get write access on loading and/or to automatically refresh the view with the latest data every time you open the file.Note: If you are using autoformats, it is advisable to turn the foreground and background colors off to prevent these from overwriting the autoformat colors. From the Analyst menu, click View, Options.

7. From the Analyst New View 5 of 5 screen, select the auto format to be applied to the view of your cube.

8. AutoFormat allows you to choose from a selection of 16 standard Excel table formats to display information. You may also choose what formats to apply to the D-Cube, including Number, Border, Font, Patterns, Alignment, and Width/Height. Note: To preserve any custom formatting you may have applied, autoformats are not re-applied automatically on refresh. If you insert new items immediately below formatted subtotals or column headings, Excel will take the formatting from the previous row. You may re-apply autoformatting by choosing View from the Analyst menu and selecting Autoformat.

9. Click Finish. The view will appear in your spreadsheet.

Reselect ViewReselect the items that make up the rows, columns, and pages of the current view.

Steps1. From the Analyst menu, click Reselect View.

2. If items have been renamed or deleted since you last refreshed your report, Reselect View will first take you to the Update D-List Items (p. 35) screen so you can match the old labels against the renamed D-List (p. 14) items. If all items in your selection are valid, Reselect View takes you straight to the Analyst Reselect D-List Items screen.

3. The Analyst Reselect D-List Items screen allows you to select Detailed Selection (p. 38), Saved Selection (p. 38), Entire Cube (p. 38), or Entire D-List (p. 38) to include in your view. Note: Custom items (p. 13) in Excel do not appear in the Analyst Reselect D-List Items screen.


Chapter 7: Views

4. Click Sort to sort highlighted items in the right-hand list into D-List order. Otherwise use the up and down arrows to move item(s) in the list on the right. An item or group of items can also be sorted by de-selecting with the left arrow key then highlighting an insertion point on the right-hand list. Click the right arrow to insert just below the chosen point. Note: Sorting by data values or other criteria-based sorting may be accomplished using standard Excel functions such as Data, Sort from the main Excel menu.

5. Click Expand to highlight the items that make up a highlighted subtotal or formula item. This will highlight any item missing from a subtotal or formula. If you want missing items to appear in your view, click the right arrow to move them to the Items Included list on the right. Expand generally applies to formula items, the exception being detail items such as price and cost per unit that are weighted averages. If you expand these items, then it will include the item that is used as the weighting factor. Note: If you clear the Check for unmatched items check box in the Analyst Default Options screen (from the Analyst menu, click Options), the program will cease to check for renamed or obsolete items. Keep this check box selected to ensure your selection is up-to-date after each refresh.

Define Ranges in a ViewEnter the cell positions or ranges where the cell address, the page label(s), the row labels, and column labels are to appear in your report. Make sure the cell address is to the top left of the view. If you have more than one row, column, or page label (otherwise known as laminated dimensions (p. 16)), make sure that the range includes every cell that contains the labels.

Define Rows Columns PagesDuring the process of defining a view, screen 3 of 6, you can define which D-List (p. 14) is to be used for the row, column, and page labels.

Steps1. Select the dimension from the top left box and the corresponding D-List to use from the

top-right box.

2. Click Match to confirm the pairing. The D-List goes to the Matched D-Lists box in the lower half of the screen. Repeat for rows, columns and pages.

Match Misspelled Items or Delete Unmatched ItemsDuring the process of defining a view, you are given the opportunity to match misspelled items against valid D-List (p. 14) items, or deleting unmatched items.

Steps1. Highlight the Microsoft Excel item from the top-left Unmatched D-Lists box, then highlight

the corresponding D-List item in the top-right Unmatched D-Lists box. You can now match the item, or delete the item.

2. Click Match, and the pair are moved to the Matched Items box to show that they have been matched.

3. Click Delete, and the item will be moved to the Deleted items box. The spelling of matched items will be corrected, or the deleted items will be removed when you return to the view. Note: There may be more than one D-List with unmatched items. You will need to select each in turn.


Chapter 7: Views

Select Page ItemsWhen defining a view, you may only select the items appearing as pages at this stage. If you need to reselect rows and columns, then use Reselect View (p. 35) once the view is complete.

Slice a ViewSlicing a view allows you to take an existing view and swap over the rows, columns, and/or pages.

Unlike Analyst, slicing a view is not possible from the Analyst Reselect D-List items screen. To slice a view, the easiest way is to create a new view with the correct orientation of rows, columns, and pages.

An alternative way, if you are intending to slice the view frequently, is to set it up as a Pivot table when you create the view. That way you can slice the view simply by dragging the grey boxes containing the D-List names onto the row, column, or page label.

View CopyFrom the Analyst menu, click View, Copy to copy the active view to anywhere else in the workbook. You can only copy one view at a time.

The copied view will be given a new range name. For example, if you copy a view named Sheet1!Analyst_view_1 onto a separate worksheet it will be given a name such as Sheet2!Analyst_view_1. If you copy a view named Sheet1!Analyst_view_1 onto the same worksheet it will be given a name such as Sheet1!Analyst_view_2.

Delete View

Steps1. Click anywhere in a view to make it active, then click View from the Analyst menu.

2. Click Delete to delete the entire view. The area deleted is defined by the ranges of the row, column, and page labels. Other views of the same or different D-Cubes will not be affected.

View Options

Steps• From the Analyst menu, click View, Options. The View Options screen allows you to set

Formatting Options, Advanced Options, Validity Checks, and Action on Opening Workbook settings.

These options can be set for each view individually.

If you are using autoformats, turn the foreground and background colors off to prevent these from overwriting the autoformat colors. From the Analyst menu, click View, Options.

If you clear the Check for unmatched items check box in the Analyst Default Options screen (choose Options from the Analyst menu), the program will cease to check for renamed or obsolete items. Keep this check box selected to ensure your selection is up-to-date after each refresh.

View Paste D-List ItemsPastes a selection of D-List (p. 14) items into your spreadsheet.


Chapter 7: Views

Steps1. From the Analyst menu, click View, Paste D-List Items.

2. Choose the name of the D-Cube from which the D-List items are to be drawn, and then click Next.

3. Select the D-Lists you need. This would form either the rows or columns of the table. You cannot create both rows and columns in one operation, however, there are cases where you would want to create a laminated row or column dimension formed by the combination of two or more D-Lists. In that case you could select more than one D-List. Click Next.

4. You may re-order the items and exclude certain items as you wish. The default is for all items to be selected in D-List order. Click Next.

5. In the Start Cell, enter the cell reference of the first item in your list. Select whether to paste the D-List items vertically as Row labels or horizontally as Column headings. For laminated dimensions (p. 16) only, the Replicate headings check box allows you to repeat the item labels. Click Finish. The D-List will be pasted into the spreadsheet.

6. From the Analyst menu, click View, Define View if you need to paste in D-List items for page labels. You can then select the pages to be included in the view. A drop-down menu for the page labels will be inserted automatically.

View Resize All Drop-downs To Fit CellsResizes all the drop-down menus containing the page labels so that they fit the cell they are in.

Note: This option is for appearance only.

For long page labels you may need to resize or move the drop-down menu so you can see the full label. Ctrl+Click on the page label, then resize by dragging on one of the handles. The drop-down menus can be moved anywhere in the worksheet. It is the text underneath that defines the page labels, not the drop-down menu itself.

View StyleThe view style can be set to Normal view, Hierarchical, and Pivot Table. The view style can be selected when you first create a view, but you cannot change the view style retrospectively.

NormalA Normal view consists of a set of row, column, and page labels. The data is updated from an underlying D-Cube (p. 13) referred to by the red cell to the top left of the view.

HierarchicalThe Hierarchical view allows you to expand and contract different levels of a hierarchy by clicking on the outline symbols. From the Tools menu, click Options, and then clear Outline symbols on the View page.

Pivot TableA Pivot able allows you to slice and dice the data so you can choose which dimension you want to appear as rows columns and pages. Click and drag the grey boxes onto the rows, columns, or pages to re-orientate the view. The data for the pivot table is stored as a single column of data in a separate sheet. This puts an effective limit on the number of cells that can be displayed in a pivot table. The maximum number of cells is equal to the maximum number of rows in a worksheet.

If you are using autoformats, it is advisable to turn the foreground and background colors off to prevent these from overwriting the autoformat colors. From the Analyst menu, click View, Options.


Chapter 7: Views

Format OptionsFrom the Analyst menu, click View, Options to set the Formatting options for each view individually.

Auto Color - Foreground Data CellsThe auto color for the data uses the standard Analyst conventions. When the numbers have changed with respect to the saved version, the detail and formula items change to purple and red respectively. The coloring is re-applied every time the view is refreshed or recalculated. If you want to use your own coloring, you will need to turn the auto color options off.

Auto Color - Background Data Cells

Auto Color - Foreground D-List CellsThis refers to the color of the row and column labels. The conventions are slightly different from Analyst. A red label indicates an invalid item in Microsoft Excel, whereas in Analyst a red label means an item whose data has changed.

Auto Color - Background D-List Cells

Blue Detail item

Black Formula item

Purple Changed detail item

Red Changed formula item

Grey background Locked cells (prevents typing and input via a D-Link (p. 14))

Yellow background Protected cells (prevents typing)

Turquoise background Held cells (prevents change on Breakback (p. 13))

Green background Held and protected cells

Dark grey background Held and locked cells

Blue Detail item

Black Formula item

Red Item does not match an item in the underlying D-List (p. 14). The Check for unmatched items check box must be selected.

Grey Item does not match an item in the underlying D-List. The Check for unmatched items check box must be selected.


Chapter 7: Views

Note: If you are using autoformats, it is advisable to turn the foreground and background colors off to prevent these from overwriting the autoformat colors. Choose View from the Analyst menu and select Options.

To preserve any custom formatting you may have applied, autoformats are not re-applied automatically on refresh. If you insert new items immediately below formatted subtotals or column headings, Excel will take the formatting from the previous row. You may re-apply autoformatting by choosing View from the Analyst menu and selecting Autoformat.

Replicate HeadingsIn cases where you want to combine two or more D-Lists to comprise the row or column labels, otherwise known as a laminated dimension (p. 16), you can replicate the headings for the first set of labels. If Replicate Headings is cleared, then the first label will appear as a set of subheadings.

To convert an existing view so that the headings are replicated, you will need to click View, Options, Replicate Headings from the Analyst menu. Then, again from the Analyst menu, click Reselect View. The headings will only be replicated after you have clicked Reselect View.

Suppress Zero Rows on RefreshWhenever you refresh the view, rows containing all zeros are hidden.

Validity ChecksFrom the Analyst menu, click View, Options to set Validity checks for each view individually. The checks occur whenever you refresh or recalculate a view.

Check for Unmatched ItemsChecking for unmatched items looks for labels that no longer match any item in the D-Lists. Since creating the view, items may have been renamed in Microsoft Excel or Analyst, or deleted entirely from the D-List. This option allows you to check that all row, column, and page labels in the current view are up-to-date. First the program checks that the spelling of every item containing a note corresponds exactly to an existing D-List item.

Note: D-List items are case-sensitive.

It will warn you in two ways. First, it will provide an on-screen prompt every time you refresh the view. Second, it will color any invalid row and column labels red (or red on grey), provided you also have the Auto Color-Foreground/Background check boxes selected. If you find unmatched items, then from the Analyst menu, click Auditing, Check view for renamed D-list Items or Reselect View (p. 35) to bring the view in line with the current D-Lists.

The note attached to each label contains the name of its D-List. The presence of a note is indicated by a small red dot in the top right of each cell. You may switch this note off by clearing the Check for unmatched items check box. However, if you do so, you will not be able to match it against a renamed D-List item. Since it is important to be confident that the view reflects the latest data held on the underlying D-Cube, it is recommended that you leave this check box selected.

Check for Incomplete TotalsCheck for incomplete totals warns you if items are missing from subtotals or formulas in your current selection. This allows you to detect if new items have been inserted into subtotals in the D-List since you last refreshed the view, or if you have accidentally left items out. It will check every time you refresh.

You may need to turn this option off if you have deliberately selected subtotals or formulas without their component detail items.


Chapter 7: Views

To ensure that every component of a subtotal is included, choose Reselect View (p. 35), highlight every item on the Items Included list on the right, and click on the Expand button. This will highlight the missing items on the Items excluded list on the left. Click on the right arrow to bring them into the Items included list on the right.

To ensure that the order is correct, and sort any items that have been moved to a different sub-total, highlight every item on the Items included list on the right, then click on the Sort button. The Sort button sorts a highlighted group of items in the Items included list in D-List order.

Actions on Opening WorkbookWhen you open an old workbook you may automatically refresh a view with the latest numbers. From the Analyst menu, click View, Options to set these actions.

Refresh View on LoadingAutomatically refreshes the numbers from the underlying D-Cube as soon as you open the view. It will also refresh any other views that share the same D-Cube. It is common to keep this option selected so that the data is refreshed automatically whenever you open the Microsoft Excel file and log on to Analyst. The only exception is when you have edited the numbers in the Excel view when you were not connected to Analyst. In that case an auto-refresh on load risks losing the data you have recently entered.

A refresh will update the data, not the labels. It will not refresh the row or column labels to reflect renaming, addition or deletion of items, nor will it refresh the numbers in views from other D-Cubes. Excel formulas will not be overwritten by a refresh unless you have set this as a view option.

If you have multiple views of the same D-Cube, the option to Refresh View on Loading is not available under View, Options except when creating the first named view. Instead, use Analyst, Read Write Access (p. 29) to edit the setting for all views that use the D-Cube.

Get Write Access on LoadingUsed in a multi-user environment, this option automatically allows write-access when you open the view. This allows you to save the data in the underlying D-Cube. However it will not bounce another user off if they are already entering data and have write access.

If you have multiple views of the same D-Cube, the option to Get Write Access on Loading on Loading is not available under View, Options except when creating the first named view. Instead, choose Analyst, Read Write Access (p. 29) to edit the setting for all views that use the D-Cube.

Advanced OptionsFrom the Analyst menu, click View, Options to set advanced options for each view individually.

Treat Blanks as Zero on RecalculateWhen you recalculate a view in Microsoft Excel that contains blank cells, it will treat the blank cells as if a zero had been entered.

Treat Errors as Zero on RecalculateChecks the content of each cell in the active view for a Microsoft Excel error code such as #VALUE!, #DIV/0!, ERR or #NAME? When it comes to recalculating, it treats these cells as if a zero had been entered.


Chapter 7: Views

Allow Breakback on RecalculatePermits a Breakback (p. 13) to occur in Analyst when you enter a number in a black formula cell in Excel. The black color-coding indicates that the item is a formula in the underlying D-List. It is important to note that usually the formulas are stored in Analyst, not in Excel.

If the Breakback on recalculate check box is not selected, then you should only enter data in the blue detail cells as any data-entry in black formula cells will be ignored on recalculation.

Allow Breakback from Excel FormulasThis option allows you to Breakback onto a formula held in Analyst from a formula held in Excel. This is a special case, as usually the formulas are held in Analyst, not in Excel. It is recommended that if you use this option, double-check that the formulas in both Analyst and Excel are giving sensible results.

Overwrite Excel Formula on RefreshIf this check box is selected, it will only overwrite Excel formulas where the labels are an exact character match of existing D-List items and are within the ranges that define the row and column labels. Any cells containing Excel formulas that meet these criteria will be overwritten by the value held in Analyst.

Blank Invalid Cells if Note PresentIf D-List items have been deleted or renamed, the labels in Excel may become invalid. This option allows you to blank out the data in the invalid rows, columns, and pages to bring it into line with the underlying D-Cube. The significance of the note is that only items that were once valid have a note, so custom items (p. 13) (including custom Excel formulas) are not affected.

If you clear this check box, then the data held against invalid items remains unaffected when you refresh the view.


Chapter 7: Views


Index

AAccess

write access on loading, 42Access rights, 20, 29, 42Actions on Opening Workbook, 46Advanced Options, 46Analyst

integration with Analytic Applications, 9integration with Consolidation, 9

Analyst Macro list, 19Analyst note cell, 14

how it works, 14range names, 17

Analytic Applicationsintegration with Analyst, 9

Assign Action, 19get write access, 19, 20log off, 19, 20log on, 19, 20print, 19, 20recalculate, 19, 20refresh, 19, 21release write access, 19, 21run D-Link, 19, 21run macro, 19, 21save, 19, 21

Auditing, 33check active view for blanks, 33check for renamed D-List items, 33check integrity of views, 33copy invalid items, 33copy new items, 33replace object names in all definitions, 33, 34show precedents of formula, 33

Auditing Check Active View for Errors, 33Auditing Check Integrity of Views, 33Auditing Check view for renamed D-List Items, 33Auditing Show Precedents of Formula, 34Auto-color, 44

BBatch Printing

Create Sheets, 27Detailed Selection, 27Entire Cube, 27Page Setup, 25Print Sheets, 25Saved Selection, 27

Batch printing macros, 26Blank cells, 37Blank invalid data cells, 37Blanks

blank invalid cell if note present, 46checking for, 33treat blanks as zeros, 46

Break-Back, 13Break-Back on recalculate, 37

CCell note, 14

Analyst cell, 14D-Cube cell, 14how it works, 14range names, 17

Check active view for blanks, 33Check active view for errors, 33Check for incomplete totals, 42Check for unmatched items, 42Check integrity of views, 33Check view for renamed D-List items, 33Color conventions, 44Columns

defining, 39deleting, 35errors, 16, 45inserting, 35laminated, 16range name, 17renaming, 35sorting, 35

Consolidationintegration with Analyst, 9

Copyinvalid items, 34new items, 33view, 42

copyright, 2Create Sheets, 27Custom Items, 13

DDate formats, 25D-Cube, 13D-Cube Note cell, 14

Analyst cell, 14D-Cube name cell, 14how it works, 14range names, 17

D-Cubesdefining, 39renaming, 34resetting, 31saving, 31

Default options, 37Define view, 39Defining page items, 42Defining ranges in a view, 41Defining rows,columns,pages, 41Definitions

replacing text in definitions, 34Deleting

data in invalid cells, 33, 46rows, columns, pages, 35views, 42

Deleting unmatched items, 41


Index

Detailed selection - Dynamic Selection, 38D-Link, 14D-Links, 22

assign action, 19, 21drill down, 22running, 19, 21, 22

D-List, 14D-List notes, 42D-Lists

defining, 39D-List format, 35laminated, 16paste D-List items, 42pick item from D-List, 35renaming, 34renaming items, 33, 35

documentversion, 2

Drill-Down, 22Drop-down menus, 17

moving, 43resizing, 43sharing, 18

Dynamic Selections, 38

EEntire Cube - Dynamic Selection, 38Entire D-List - Dynamic Selection, 38Errors

#VALUE!,#DIV/0!, ?#NAME, 37cannot find a name, 45check active view for errors, 45check for incomplete totals, 45check for unmatched items, 45treat errors as zeros, 46

Extensionsintegration, 9

FFormats, 25

date and time, 25D-List format, 35percentages, 25scaled numbers, 25

Formatting options, 44Formulas

check for incomplete totals, 34, 45overwrite option, 46show precedents of, 33, 34

GGet write access, 29

assign action, 19, 20on loading, 29, 46

Get write access on loading, 46

HHeadings, 35

replicating, 44Help, 7Hierarchical view, 43How does the note in the Analyst cell work?, 14

IIncomplete totals, 34, 35, 45Inserting

rows, columns as first or last, 16rows, columns, pages, 35

Integration GuidAnalytic Applications integration with Analyst, 9

Integration GuideConsolidation integration with Analyst, 9

LLabels, 35Laminated dimensions, 16

defining, 39replicate headings, 42, 44

Librariesdefining, 39renaming, 33, 34

Log off, 11assign action, 19, 20

Log on, 11assign action, 19, 20

LogOff, 11LogOn, 11

MMacros, 19

Analyst macro list, 19assign action, 19, 21example, 22printing, 26renaming, 33, 34running, 22

Messages, 37Misspelled items, 34, 35, 41

NNew View, 40

Autoformat, 37Normal view, 43Note, 14

Analyst cell, 14Analyst cell how it works, 14Analyst cell range names, 17D-Cube note cell, 14D-Cube note cell how it works, 14D-Cube note cell range names, 17

Number formats, 25

OOptions, 37, 42

auto-color, 44blank invalid data cells, 46Break-Back on recalculate, 46default view options, 37get write access on loading, 46messages, 37overwrite excel formulas, 46refresh view on loading, 46replicate headings, 44suppress zero rows, 44treat blank cells as zero, 46treat errors as zero, 46view style, 43


Index

PPage label box, 17Page Setup, 25Pages

defining, 39deleting, 35inserting, 35moving page label box, 43range name, 17renaming, 33, 35resizing page label box, 43sharing, 18sorting, 35

Partial Refresh, 29Paste D-List items, 42Percentages

format, 25Pick Item from D-List, 35Pivot tables, 43Print

assign action, 19Print macros, 26Print Sheets, 25product

version, 2

RRange names, 17Ranges

ammending, 16, 39Read Write Access, 29

on loading workbook, 46Recalculate, 30

assign action, 19break-back option, 46

Refresh, 30all views, 30assign action, 19on loading, 46selected view, 30views of D-Cube, 30

Refresh view on loading, 46Release read/write access, 29Release write access, 29

assign action, 19Renaming, 33, 34

D-Cubes, 33, 34D-Links, 33, 34D-List items, 33, 35libraries, 33, 34macros~, 33, 34rows, columns, pages, 33, 35system, 33, 34

Re-ordering rowscolumns, pages, 35

Replace object names in all definitions, 33, 34Replicate headings, 44Reselect View, 35Reset D-Cube, 31Resize all drop-downs to fit cells, 43Re-slicing, 42Rows

defining, 39deleting, 35errors, 16, 45inserting, 35

Rows (cont'd)laminated, 16range name, 17renaming, 33, 35sorting, 35suppress zero rows, 44

Run D-Link, 22assign action, 19

Run macro, 22assign action, 19

SSave, 31

assign action, 19Saved Selection - Dynamic Selection, 38Scaling

format, 25Select existing pages - Dynamic Selection, 38Sharing pages, 18Show precedents of formula, 33, 34Slicing a view, 42Sorting rows

columns, pages, 35Start Cell, 42Subtotals

validate for missing items, 34, 35, 45Suppress zero rows, 44System

renaming, 33, 34

TText

replacing text in definitions, 33, 34Time formats, 25Treat blank cells as zero, 46Treat errors as zeros, 46

UUnmatched items, 41Update D-List Items, 35

VValidate selection on refresh, 42, 45Validity Checks, 45version

product, 2View, 38

default settings, 37defining, 39range name, 17recalculating, 30refresh, 30refresh on loading, 46slicing, 39

View Copy, 42View Define View, 39View Delete, 42View Options, 42

actions on opening workbook, 46advanced options, 46defaults, 37formatting options, 44validity checks, 45

View Paste D-List Items, 42


Index

View Resize all drop-downs to fit cells, 43View style, 43Visual Basic Commands, 22

WWrite access, 29Write access on loading, 46

ZZeros

check for blanks, 33suppress zero rows, 44treat blank cells as zeros on recalculate, 46treat errors as zeros on recalculate, 46zero out invalid cells, 46


Date post:	14-Aug-2020
Category:	Documents
Upload:	others
View:	9 times
Download:	0 times

Cognos Planning(TM) Add-in for Excel User...

Documents