Map Manager

IBM Cognos Map ManagerVersion 10.1.1

Installation and User Guide

��

NoteBefore using this information and the product it supports, read the information in “Notices” on page 21.

Product Information

This document applies to IBM Cognos Version 10.1.1 and may also apply to subsequent releases. To check fornewer versions of this document, visit the IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2005, 2011.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp


Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Chapter 1. What's New? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1New Features in Version 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Geopolitical Boundary Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 2. Installing Map Manager . . . . . . . . . . . . . . . . . . . . . . . . 3System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Supported Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Install Map Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Uninstall Map Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 3. Map Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Report Studio and Map Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Start Map Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Open a Map File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Create a Custom Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Save a Map File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Save a Map File Using a Different Name or Location . . . . . . . . . . . . . . . . . . . . . . 9Change the Position or Name of a Map in the Report Studio Map Selection Dialog . . . . . . . . . . . . 9Import a Map from a Non IBM Source . . . . . . . . . . . . . . . . . . . . . . . . . . 10Preparing Maps for Reuse in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Change the Map Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Add a Description to a Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Add an Alias to the Dictionary for a Map Feature . . . . . . . . . . . . . . . . . . . . . 12Find a Map Feature. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Adding Language (Locale) Support . . . . . . . . . . . . . . . . . . . . . . . . . . 13Merge a Customized Map with Another Map . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 4. Acquiring New Maps . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 5. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Problems Importing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Error Importing Translated Text File . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27H. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28J . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28N. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

© Copyright IBM Corp. 2005, 2011 iii

R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31U . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

iv IBM Cognos Map Manager Version 10.1.1: Installation and User Guide

Introduction

This document is intended for use with IBM® Cognos® Map Manager. MapManager is a Microsoft Windows program that you use to prepare maps for use inreports.

This document describes how to install Map Manager. It also describes how tov import maps from non IBM sourcesv define alternate names or abbreviations for map featuresv provide multilingual support for maps

Finding information

To find IBM Cognos product documentation on the web, including all translateddocumentation, access one of the IBM Cognos Information Centers. Release Notesare published directly to Information Centers, and include links to the latesttechnotes and APARs.

You can also read PDF versions of the product release notes and installation guidesdirectly from IBM Cognos product disks.

Accessibility features

This product does not currently support accessibility features that help users witha physical disability, such as restricted mobility or limited vision, to use thisproduct.

Forward-looking statements

This documentation describes the current functionality of the product. Referencesto items that are not currently available may be included. No implication of anyfuture availability should be inferred. Any such references are not a commitment,promise, or legal obligation to deliver any material, code, or functionality. Thedevelopment, release, and timing of features or functionality remain at the solediscretion of IBM.

Samples disclaimer

The Great Outdoors Company, GO Sales, any variation of the Great Outdoorsname, and Planning Sample depict fictitious business operations with sample dataused to develop sample applications for IBM and IBM customers. These fictitiousrecords include sample data for sales transactions, product distribution, finance,and human resources. Any resemblance to actual names, addresses, contactnumbers, or transaction values is coincidental. Other sample files may containfictional data manually or machine generated, factual data compiled fromacademic or public sources, or data used with permission of the copyright holder,for use as sample data to develop sample applications. Product names referencedmay be the trademarks of their respective owners. Unauthorized duplication isprohibited.

© Copyright IBM Corp. 2005, 2011 v


vi IBM Cognos Map Manager Version 10.1.1: Installation and User Guide

Chapter 1. What's New?

This section contains a list of new features for this release. It will help you planyour upgrade and application deployment strategies and the training requirementsfor your users.

To review an up-to-date list of environments supported by IBM Cognos products,such as operating systems, patches, browsers, Web servers, directory servers,database servers, and application servers, visit the IBM Cognos Customer Center(http://www.ibm.com/software/data/cognos/customercenter/).

New Features in Version 10.1.1

Listed below are new features since the last release.

Geopolitical Boundary Changes

From time to time, geopolitical boundaries of various countries and regions changeto recognize new realities due to conflict and division. This release contains twomap updates.v The map of India now includes the state Lakshadweep and adjustments to the

boundaries of various disputed regions. Lakshadweep is a group of islands inthe Laccadive Sea located to the west of the India.

v The world and European maps now have separate regions for Serbia,Montenegro, and Kosovo. Previously, the maps showed a single region of Serbiaand Montenegro, which included the Kosovo region. Kosovo is a self-declaredindependent state; the map reflects a separate region based on United Nationsrecognized boundaries.

© Copyright IBM Corp. 2005, 2011 1

http://www.ibm.com/software/data/cognos/customercenter/

2 IBM Cognos Map Manager Version 10.1.1: Installation and User Guide

Chapter 2. Installing Map Manager

Install IBM Cognos Map Manager if you want tov convert maps from non IBM sourcesv assign alternate names for map featuresv assign alternate languages for map features

Before you install, ensure that you have administrator privileges for the computeryou are installing on. If you are not an administrator, ask your systemadministrator to add you to the Administrator group.

System RequirementsBefore you install IBM Cognos Map Manager, ensure that your computer meets thesoftware and hardware requirements. The hardware requirements depend on yourbusiness intelligence environment. You may require additional resources, such asdisk space.

The following table lists the minimum hardware and software requirements to runMap Manager.

Requirement Specification

Operating system Microsoft Windows

Disk space Minimum: 50 MB of free space on the drivethat contains the temporary directory

Supported EnvironmentsTo review an up-to-date list of environments supported by IBM Cognos products,such as operating systems, patches, browsers, Web servers, directory servers,database servers, and application servers, visit the IBM Cognos Customer Center.

The IBM Cognos Customer Center is online at http://www.ibm.com/software/data/cognos/customercenter/. It is important to apply all required operatingsystem patches and to use only the versions of other software that are supportedby an IBM Cognos product. Otherwise, your product may not work properly.

Install Map ManagerYou install IBM Cognos Map Manager on a Microsoft Windows computer. You caninstall it on the same computer as an IBM Cognos Business Intelligence product orcomponent, such as IBM Cognos Framework Manager, or on a different computer.

Procedure1. We recommend that you first close all applications that are running.2. Insert the product disk and then open the installation menu.

The Welcome page of the installation wizard should appear.




If the Welcome page does not appear, in the win32 directory on the disk,double-click issetup.exe.

3. Select the language to use for the installation.The language you choose determines the language of the text that appears onthe pages of the installation wizard.

4. On the Installation Location page, select the directory.If you are installing Map Manager on a computer that already has IBM CognosBI products, you must install Map Manager in the same directory.If you are prompted to stop the services, click Yes.

5. Follow the directions in the installation wizard.On the Finish page, if you had stopped the services earlier, click Start IBMCognos Configuration, and then restart the services.

Results

You can now use the Microsoft Windows Start menu to start IBM Cognos MapManager.

The installation wizard creates two log files in the installation_location\instlogdirectory. The install log file records the activities that the installation wizardperforms while transferring files. The summary-error log file records thecomponents you install, disk space information, your selections in the transferdialogs, and any errors the installation wizard encounters while transferringcomponents. The log file names include the product name, version, build number,and time stamp.

Uninstall Map ManagerIf you no longer require IBM Cognos Map Manager, you can uninstall it using theuninstall program. It is important to use uninstall programs to completely removeall files and modifications to system files.

The Uninstall wizard also removes IBM Cognos Framework Manager if it isinstalled in the same location.

Before you uninstall, ensure that you back up any data that you may need in thefuture.

Procedure1. From the Microsoft Windows Start menu, click Programs, <installation folder>,

Uninstall IBM Cognos.The Uninstall wizard appears.

2. Follow the instructions to uninstall.

Results

The Cognos_uninst_log.htm file records the activities that the Uninstall wizardperforms while uninstalling files. To find the log file, look in the Temp directory.

Uninstalling does not remove any files that changed since the installation, such asuser data files. Your installation location remains on your computer, and you retainthese files until you delete them using Microsoft Windows Explorer.


Chapter 3. Map Manager

IBM Cognos Map Manager is a Microsoft Windows program that you use toprepare maps for use in reports. You can add aliases and languages to the samplemaps that are provided. You can convert custom maps from a non IBM source toIBM Cognos map format (CMF) and then add aliases and languages. MapManager supports maps that use geoset format (GST), such as those from MapInfo,our OEM-preferred provider for map data.

You can perform other actions with map information using a combination ofMapInfo and IBM Cognos products. For example, you can create maps in MapInfoProfessional, prepare the maps for use in Map Manager, define and run a reportthat uses maps in IBM Cognos Report Studio, and then view the report in ReportViewer.

Within each of the applications, you can perform certain actions as shown in thefollowing table.


Application Actions permitted Actions not permitted

Report Viewer Drill through

Get tool tips

Zoom

Change layer content

Adjust mismatched data

Report Studio Choose map layers

Apply default map colors

Add aliases within report

Define rules for color basedon data source queries andfilters

Change map content

Map Manager Convert maps from MapInfoformat to IBM Cognosformat

Create custom layers

Change the preview image

Add a description

Define aliases for featurenames

Add languages

Change map content

MapInfo Professional Create new objects

Create new layers inMapInfo tab format

Add languages

Define rules for color basedon data sources

Before you use Map Manager, you should be familiar with basic map terminologyand the reporting requirements for your organization.

Map Manager manages the following types of information in map files:v Preview images

Shows thumbnail images of the map. You can preview the general appearance ofthe map. Preview images do not contain data.

v LayersShows thematic groupings of features. For example, it may include regions suchas provinces, territories or states, categories such as major and minor cities, oruser-created custom layers.

v FeaturesSpecifies the points or named elements on a map. Text labels identify points onthe map.

v Base languageIdentifies the default language for labels. Used when the user's preferredlanguage does not exist in the map file. In Report Studio, this is the language forlabels at run time if the user locale is not a supported language in the map file.


v DictionaryLists the feature names and any aliases for each available language.

Report Studio and Map ChartsReports in IBM Cognos Report Studio use maps to represent data that can bedisplayed spatially. For example, a map can show things such as geographical area,floor plans in a building, seats in an airplane, or parts of the human body.

A map in IBM Cognos BI consists of a collection of layers. Each layer containsdifferent information that is determined either from the map file or from your datasource. A layer is like a transparency that is placed on top of the base map. Eachlayer adds more information to the map. For example, a map of the world maycontain one layer with information related to countries and another layer withinformation related to cities.

At run time, Report Studio queries the data source to retrieve the data to show inthe map chart. Map layers and points (map features) on the map chart use thenumeric values of the data to display the appropriate color. If the text for the labelsthat appears on the map differs between the map file and the data source, youmust set up aliases in the map file before you run the query. This ensures that theappropriate colors are shown. Report authors can choose to set up the aliases atrun time for one-time reporting needs.

At run time, the map label text appears in the language of the user's locale setting.For example, users who have a German user locale see the map labels in German,while users who have a French user locale see the map labels in French. If the mapfile does not contain the language of the user's locale, then the labels appear in thebase language that is specified in the map file. You can change the base language.

Start Map ManagerStart IBM Cognos Map Manager when you want to import maps from non-IBMsources or manage existing IBM Cognos map files.

Procedure

From the Microsoft Windows Start menu, click Programs, <installation folder>, IBMCognos Map Manager.

Chapter 3. Map Manager 7

Open a Map FileOpen an existing IBM Cognos map file (.cmf) to view the map, to create customlayers, or to add aliases, a description, or languages.

You must use the import wizard to open a map file from a non IBM source.

If you want to use the map as the basis of a new map, save it using a differentname.

You can also resize the application window.

Procedure1. From the File menu, click Open.2. In the Look in list, click the drive, folder, or Internet location that contains the

IBM Cognos map file (.cmf) that you want to open.3. In the folder list, locate and open the folder that contains the map file.

Tip: Sample map files are located in the installation_location/maps directory.4. Click the file, and then click Open.Related tasks

“Import a Map from a Non IBM Source” on page 10Before you can use a custom map in IBM Cognos Report Studio, you must convertit to an IBM Cognos map file (.cmf). For this release, MapInfo geosets (*.gst) andrelated files are supported.“Save a Map File Using a Different Name or Location” on page 9You can save a map file using a different name or location if you want to use it asthe basis for another map file or to save different versions of the map file.

Create a Custom LayerCreate a custom map layer based on existing features.

Procedure1. From the Tools menu, click Define Custom Layers.2. Click Add.3. In the New Layer dialog box, type a name for the layer.4. From the list, select the layer on which you want the new layer to be based.5. Click OK.6. To assign a color to the new layer, click the color bar.7. Select the color from the palette and click OK.8. With the new layer highlighted, click the Features tab.9. On the Features tab, type a name for the group of features you want to

associate with this layer, and add features from the Available features list.10. Click OK.

Save a Map FileSave a map file to preserve any changes.


What you save in IBM Cognos Map Manager is the IBM Cognos map file (.cmf),which is a specific set of data for the layers in a map, including the imagedefinition and the locale or language-based feature names and aliases.

Use the Save As command to save different versions of the map file.

For the map to be accessible to IBM Cognos Report Studio, you must save it in theinstallation_location/maps directory.

Procedure

From the File menu, click Save.When a new map file is saved to the installation_location/maps directory, it appearsat the end of the list of maps in the Report Studio map selection dialog. You canmove the new map to another position in the map selection dialog.Related tasks

“Change the Position or Name of a Map in the Report Studio Map SelectionDialog”By default, new maps are added to the bottom of the map selection dialog in IBMCognos Report Studio. You can move the new map to an existing map group orcreate a new map group for it.

Save a Map File Using a Different Name or LocationYou can save a map file using a different name or location if you want to use it asthe basis for another map file or to save different versions of the map file.

Procedure1. From the File menu, click Save As.2. Specify a location.3. In the File name box, enter a new name for the file.4. Click Save.

Change the Position or Name of a Map in the Report Studio MapSelection Dialog

By default, new maps are added to the bottom of the map selection dialog in IBMCognos Report Studio. You can move the new map to an existing map group orcreate a new map group for it.

Note: For a map file (.cmf) to be accessible to IBM Cognos Report Studio, it mustbe located in the installation_location/maps directory.

Procedure1. In the installation_location\webcontent\pat\res directory, open MapGroups.xml

in an XML editor. In a distributed environment, this file is located on thegateway.

2. To add the new map to an existing group, add a <map> entry to the group.For example, to add a new map for Ontario to the Americas group, find the<folder> node for "IDS_MAP_GROUP_LABEL_AMERICAS" and type the entry<map id="ontario.cmf"/>

The position of the entry is important. Maps appear in the order in which theyare listed in the file.


3. To add the new map file to a new map group, do the following:v Add a new <folder> node in the position you want it to appear.

For example, to add a Provinces group to the Canada map in the Americasgroup, find the <map> node for "canada.cmf", add a line after it, and thentype<folder idsLabel="IDS_MAP_GROUP_LABEL_PROVINCES">

v Add an indented line after the new <folder> node and type the new <map>node.For example,<map id="ontario.cmf"/>

v In the installation_location\webcontent\pat\res directory, openreportstudio_en.xml in an XML editor. In a distributed environment, this fileis located on the gateway.

v Find <section name= "RSB" type="UI"> and type the entry <stringid="IDS_MAP_GROUP_LABEL_PROVINCES"> type=<List ItemLabel">Provinces</string>

4. To rename a map in the Report Studio dialog, rename the corresponding entryin reportstudio_en.xml only.

5. To delete a map from the Report Studio dialog, delete the corresponding entryin MapGroups.xml and reportstudio_en.xml.Note: Keep a record of the changes to MapGroups.xml andreportstudio_en.xml. When you upgrade IBM Cognos BI, these files areoverwritten and you must manually reapply the changes.

Import a Map from a Non IBM SourceBefore you can use a custom map in IBM Cognos Report Studio, you must convertit to an IBM Cognos map file (.cmf). For this release, MapInfo geosets (*.gst) andrelated files are supported.

If the custom map file contains attribute data other than identifiers and aliases, thedata is ignored by IBM Cognos Map Manager. The custom map file can use anycoordinate system.

To be converted to an IBM Cognos map file, the map must meet the followingrequirements:v The MapInfo tab files must be referenced by *.gst files.v Map objects (regions and points) must have an identifier and the identifier must

be in the first column of the associated MapInfo table.v If aliases are defined for the identifiers, they must be in any column except the

first column.

Procedure1. From the File menu, click Import.

The Map Import Wizard opens.2. Click Next.3. On the Specify a map file wizard page, choose the location of the MapInfo

files, identify the language that the map was authored in, and then click Next.Map Manager reads and then loads the data.

4. On the Select aliases wizard page, do the following:v Expand the column headings.


v Click the check box for each column, if any, that contains aliases for thefeatures in the first column.For example, the feature column may refer to Canadian provinces usingabbreviations, such as Ont., and another column may use the full name, suchas Ontario. These two columns refer to the same map feature. The full-namecolumn is an alias for the abbreviations (feature) column and should bechecked.

v In the Layer box, select the next layer, expand the column headings, andselect any alias columns that apply.

v Repeat for all layers.v Click Finish.After you import the custom map, you can set it up to ensure it is available formultiple reports.

Preparing Maps for Reuse in ReportsIBM Cognos Map Manager helps report authors or modelers reuse the same mapcharts across departmental, corporate, and national boundaries. By managing themap files from which the map charts are based, report authors can reuse thecontent to ensure its consistency and usability. The ability to reuse contentcontributes to increased quality, and reduced time and costs for development andmaintenance.

Use Map Manager to add language support so that users can view feature nameson map charts in their preferred language. Use Map Manager to add aliases so thatfeature names can be correlated to names in corporate databases.

Users can reuse custom maps or the sample IBM Cognos map files in their reports.However, before you can use custom map charts in IBM Cognos Report Studio,you must convert them to IBM Cognos map files by importing them into MapManager.Related tasks

“Import a Map from a Non IBM Source” on page 10Before you can use a custom map in IBM Cognos Report Studio, you must convertit to an IBM Cognos map file (.cmf). For this release, MapInfo geosets (*.gst) andrelated files are supported.

Change the Map ImagePreview a thumbnail of the map image that will appear in a report to see how itwill look. Depending on your reporting requirements, you may want to change thethumbnail image of the current map. For example, you may want to use a mapthat was created with non IBM software and saved as an image file.

When you import a map from a non IBM source, IBM Cognos Map Managercreates a thumbnail image that is a stripped-down version of the map. The defaultcolor of the image is determined by the first MapInfo object to be read from thelayer. You may want to add color or a name to the thumbnail image or you maywant to use an existing thumbnail image.

The requirements for a thumbnail image are that it must bev in PNG, JPG, or GIF formatv between 154 by 110 pixels


You can also reset the map image to use the default.

Procedure

1. In the Image window, click the browse button.2. In the Look in list, click the drive, folder, or Internet location of the new image

file.The image file must be PNG, JPG or GIF format.

3. Find the image and click it.4. Click Open.

The new image appears in Map Manager.5. From the File menu, click Save.

Reset the Map Preview Image to the DefaultChange the preview image back to the default image if the default image bettersuits your reporting needs.

Procedure

To reset the preview image to the default, in the image window, click the restore

button .

Add a Description to a MapWhen a map is used in IBM Cognos Report Studio, it contains a copyright. Youcan add a description of the map to the copyright information using IBM CognosMap Manager.

You cannot change the copyright information.

Procedure1. In the Description window, click in the Description box.2. Type the description.3. From the File menu, click Save.

The description appears in the Copyright box and in Report Studio when themap is used.

Add an Alias to the Dictionary for a Map FeatureYou can specify aliases that match data values in your data source to featurenames in the map.

For example, a report uses a data source that contains the name Korea, while themap file uses two names: Korea, Republic of, and Korea. Before you can accuratelyshow information, such as revenue for Korea, Republic of, you must create an aliasthat matches that country to Korea in the data source.

Aliases are also useful when addresses in your data source use abbreviations forcity names. You can create an alias for each abbreviation to identify the city theyreference.


Report authors can override or add to these multilingual labels in IBM CognosReport Studio for one-time reporting needs. For example, if multiple regionscontain a city that has the same name, you may choose to show only the city inone region by setting up an alias.

Procedure1. In the Dictionary Entry window, click the Language list and then click the

language of the dictionary.The map layers and features associated with this language are now availablefor defining aliases.

2. In the Layer box, select the appropriate layer.The features in this layer are listed in the Feature box.

3. If you want additional information to help identify the features in the layer,select the appropriate layer from the Refine layer box.Additional information about the feature appears in the Feature box in theRefine column.

4. In the Feature box, select the name of the feature for which you want to add analias.

5. In the Alias box, type the alias and then click the add entry button .The alias is added to the dictionary.

Find a Map FeatureYou can quickly search for every occurrence of a word or letter sequence in featurenames. For example, you can search for a list of cities in the United States with thename Springfield.

Procedure1. In the Dictionary Entry window, click the Language list and then click the

language.2. In the Layer box, select the layer.3. If required, in the Refine layer box, select the appropriate layer to see

additional information to help identify the feature.4. In the Find box, type the text that you want to search for.

The Feature box shows the results of the search.

Adding Language (Locale) SupportFor multilingual support, you can translate the labels for the names of mapfeatures to different languages. For example, in IBM Cognos Report Studio, if youhave multilingual versions of a report, you can ensure that the map charts areavailable in the same language as the report.

Export the Translation FileThe first step in providing multilingual versions of the map labels is to select thelanguages and make the feature names available for translation. You do this byexporting feature names for all or some selected layers to files that can be used bytranslators or prepared for translators.

Procedure1. From the Tools menu, select Export Translation File.


The Export Translation File dialog box appears. The Languages currently inthe map box shows the current list of languages. You must export at least oneof these languages as the basis for translating the map labels into otherlanguages. As a result, one of the languages in the map file appears in theLanguages to be exported box.

2. If there is more than one language in the Languages to be exported box,

select any that you do not want and then click the remove button .Tip: Press Ctrl+click to select multiple languages.

3. In the Languages to be added box, select the languages you want the text

translated to and then click the add button .4. In the Languages to be exported box, move the languages to the sequence

you want using the up and down arrows.In the export translation file, the languages appear as column headings in theorder shown.

5. Select whether you want to translate all or some layers.v If you want to translate the names of the map features in all layers, click

All.v If you only want to translate the names of the map features in some layers,

click Selected and then in the Layer box, clear the check boxes for thelayers you don't want to translate.

6. Click Export.7. In the Save in list, click the drive, folder, or Internet location that contains the

image file that you want to open.8. In the File name box, enter a new name for the file.9. Click the Save as type list, and then click the file format that you want to

save the file in.If you select TXT, the columns are separated by tabs. If you select CSV, thecolumns are separated by commas.

10. Click Save.The feature names are saved in a TXT or CSV file and are ready fortranslation. We recommend that a TXT file be imported to a Microsoft Excelspreadsheet for the translation. This will prevent errors in tabulation betweencolumns. When the translation is complete, the information can be exportedback to a TXT file.Important: Ensure that you read and write information from Excel usingUTF-8 encoding.You import the translation file back into IBM Cognos Map Manager aftertranslators have translated the content of the export file.

Import the Translation FileThe second step in providing multilingual version of the map labels is to make thetranslated features names available to users. You do this by importing both theoriginal and translated languages into IBM Cognos Map Manager.

To successfully import the translated feature names, the TXT file must meet thefollowing requirements:v Feature names must be in the same sequence as they were when you exported

the file.v The file must contain the same number of feature names.


v For a TXT file, ensure that there are no extra tabs.v For a CSV file, ensure that there are no extra commas.v The map file that was used to export the language translation file must be open.

Procedure1. From the Tools menu, select Import Translation File.2. In the Look in list, click the drive, folder, or Internet location that contains the

IBM Cognos map file (.cmf) that you want to open.3. In the folder list, locate and open the folder that contains the file to import.4. Click the file and then click Open.

The Import Translation File dialog box opens. The language that thetranslators used for the translation is listed in the Key language in thetranslation file box.

5. From the Other languages in the translation file box, click the language that

you want to import and then click the add button .6. Click OK.

If you click the Language list in the Description window or in the Dictionarywindow, it now includes the imported language.

Merge a Customized Map with Another MapOccasionally, you may want to change the map that you use to represent ageographic area.

If the map you are replacing is customized, you can perform a merge to copy thealias and description to the new map.

Procedure1. Open the map that you want to use.2. From the File menu, click Merge.3. Enter the location of the customized map whose data you want to use, and

click Merge.4. Click OK.



Chapter 4. Acquiring New Maps

IBM supplies a set of standard maps that can be used directly with IBM CognosMap Manager.

If you already have proprietary geographic data, you can also create your owncustom GST files and then import these into Map Manager. To create custom GSTfiles, you must use an application that produces MapInfo files, such as MapInfoProfessional.



Chapter 5. Troubleshooting

Use this troubleshooting information as a resource to help you solve specificproblems you may encounter when installing or using IBM Cognos Map Manager.

When you are troubleshooting, log files can help you. The IBM Technotes areanother valuable troubleshooting tool and are available at the IBM CognosCustomer Center (http://www.ibm.com/software/data/cognos/customercenter/).

When you cannot resolve a problem, the final resource is your technical supportrepresentative. To analyze a problem, your technical support representativerequires information about the situation and the symptoms that you areexperiencing. To help isolate the problem, collect the necessary data before youcontact your representative.

Problems Importing FilesYou may encounter problems when you try to import a map file or text file.

Error Importing Translated Text FileWhen you import a TXT or CSV file that has been translated, you receive an errormessage similar to the following:

Unable to save the file.

An error occurred while importing the map file.

Unable to import. The translation file contains no useful content.

The problem may be caused by one of the following:v The map file that is open is not the map from which you created the export

translation file.v Features were added or deleted in the file.v Columns (extra tabs or commas) were added to the file.v The data was sorted and is now in a different sequence than when it was first

exported.

To resolve the problem, first ensure that the correct map file is open. If it is, thenresend the original exported file for translation and specify that the contents mustnot be sorted, deleted, added to, or modified except to add translated features. Ifrequired, export the translation features and languages again.




Notices

This information was developed for products and services offered worldwide.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law: INTERNATIONALBUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFNON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE. Some states do not allow disclaimer of express or implied warranties incertain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.


IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Software GroupAttention: Licensing3755 Riverside DrOttawa, ON K1V 1B7Canada

Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

If you are viewing this information softcopy, the photographs and colorillustrations may not appear.


Trademarks

IBM, the IBM logo, ibm.com, and Cognos are trademarks or registered trademarksof International Business Machines Corp., registered in many jurisdictionsworldwide. Other product and service names might be trademarks of IBM or othercompanies. A current list of IBM trademarks is available on the Web at “ Copyrightand trademark information ” at www.ibm.com/legal/copytrade.shtml.

The following terms are trademarks or registered trademarks of other companies:v Microsoft, Windows, Windows NT, and the Windows logo are trademarks of

Microsoft Corporation in the United States, other countries, or both.

Notices 23

http://www.ibm.com/legal/copytrade.shtml

http://www.ibm.com/legal/copytrade.shtml


Glossary

This glossary includes terms and definitions forthis product.

The following cross-references are used in thisglossary:v See refers you from a term to a preferred

synonym, or from an acronym or abbreviationto the defined full form.

v See also refers you to a related or contrastingterm.

To view glossaries for other IBM products, go towww.ibm.com/software/globalization/terminology.

Aaccess permission

A privilege that permits the access or useof an object.

accountability scorecardA scorecard that Metric Studioautomatically builds for each user whichcontains the metrics and projects theyown.

agent A process that performs an action onbehalf of a user or other program withoutuser intervention or on a regularschedule, and reports the results back tothe user or program.

alias An alternative name used instead of aprimary name.

anonymous accessA type of access that allows users andservers to access a server without firstauthenticating with it.

application tier componentFor installation, the set of processors thataccess the query databases to gatherinformation and then render the results asPDF and HTML reports and metrics.Application tier components also passrequests to Content Manager and renderthe results that Content Manager retrievesfrom the content store.

attributeIn BI Modeling, a characteristic of an

entity which is descriptive rather than aunique identifier or an aggregativemeasure.

authenticationThe process of validating the identity of auser or server.

authentication providerThe communication mechanism to anexternal authentication source.Functionalities, such as userauthentication, group membership, andnamespace searches, are made availablethrough authentication providers.

Bburst To create several report results by running

a single report once. For example, theuser can create a report that shows salesfor each employee, and run it once,sending different results to regionalmanagers by bursting on region.

burst keyThe dimension or level of a query in thereport specification that is used to create,or burst, a set of report results.

CCA See certificate authority.

calculated memberA member of a dimension whose measurevalues are not stored but are calculated atrun time using an expression.

canvasAn area within a dashboard that usersinteract with to create, view, andmanipulate content and data.

capabilityA group of functions and features thatcan be hidden or revealed to simplify theuser interface. Capabilities can be enabledor disabled by changing preferencesettings, or they can be controlled throughan administration interface.

cardinality


http://www-306.ibm.com/software/globalization/terminology/

http://www-306.ibm.com/software/globalization/terminology/

1. For relational data sources, a numericalindication of the relationship between twoquery subjects, query items, or othermodel objects.

2. For OLAP data sources, the number ofmembers in a hierarchy. The cardinalityproperty for a hierarchy is used to assignsolve orders to expressions.

cascading promptA prompt that uses values from aprevious prompt to filter the values in thecurrent prompt or pick list.

certificateIn computer security, a digital documentthat binds a public key to the identity ofthe certificate owner, thereby enabling thecertificate owner to be authenticated. Acertificate is issued by a certificateauthority and is digitally signed by thatauthority. See also certificate authority.

certificate authorityA component that issues certificates toeach computer on which components areinstalled.

CGI See Common Gateway Interface.

cipher suiteThe combination of authentication, keyexchange algorithm, and the SecureSockets Layer (SSL) cipher specificationused for the secure exchange of data.

class styleA combination of formattingcharacteristics, such as font, font size, andborder, that the user names and stores asa set.

CM See Content Manager.

Common Gateway InterfaceAn Internet standard for defining scriptsthat pass information from a web serverto an application program, through anHTTP request, and vice versa.

conditionAn expression that can be evaluated astrue, false, or unknown. It can beexpressed in natural language text, inmathematically formal notation, or in amachine-readable language.

constraint

1. A security specification that denies oneor more users the ability to access a

model component or to perform amodeling or authoring task.

2. A restriction on the possible values thatusers can enter in a field.

contactA named e-mail address to which reportsand agent e-mails can be sent. Contactsare never authenticated.

content localeA code that is used to set the language ordialect used for browsers and report text,and the regional preferences, such asformats for time, date, money, moneyexpressions, and time of day.

Content ManagerThe service that retrieves informationfrom the content store, and savesinformation to the content store.

content storeThe database that contains the dataneeded to operate, such as reportspecifications, published models, andsecurity rights.

credentialA set of information that grants a user orprocess certain access rights.

cube A multidimensional representation of dataneeded for online analytical processing,multidimensional reporting, ormultidimensional planning applications.

custom setIn Analysis Studio, a named object whichcan include filter rules, calculations, andsort rules. Custom sets can define a set ofmembers that is different from any setoriginally defined in the cube model. Seealso predefined set, set.

Ddashboard

A web page that can contain one or morewidgets that graphically representbusiness data.

data sourceThe source of data itself, such as adatabase or XML file, and the connectioninformation necessary for accessing thedata.

data source connectionThe named information that defines the


type of data source, its physical location,and any sign-on requirements. A datasource can have more than oneconnection.

data treeWithin a studio, a structure that containsobjects such as query subjects, queryitems, dimensions, levels, and members.A data tree is used as a palette of theavailable data that can be inserted intocalculations, filters, display areas, andother authoring gestures.

deploymentThe process of moving an application(such as a report or model) to a differentinstance. For example, reports are oftencreated in a test environment and thendeployed to production. When anapplication is deployed, it is exported,transferred, and imported.

deployment archiveA file used for deployment. A deploymentarchive contains the data from the contentstore that is being moved.

deployment specificationA definition of what packages to move(deploy) between source and targetenvironments, the deploymentpreferences, and the archive name.Deployment specifications are used forimport and export.

derived indexA calculated metric that provides a statusand a score based on other metrics.

details-based setA set based on an item and its immediatedetails. See also set.

dimensionIn Cognos BI and TM1®, a broadgrouping of descriptive data about amajor aspect of a business, such asproducts, dates, or locations. Eachdimension includes different levels ofmembers in one or more hierarchies andan optional set of calculated members orspecial categories.

dimensional data sourceA data source containing data modeledusing OLAP concepts, includingdimensions, hierarchies, and measures.

drill downIn a multidimensional representation ofdata, to access information by startingwith a general category and movingdownwards through the hierarchy ofinformation, for example from Years toQuarters to Months.

Eevent A change to a state, such as the

completion or failure of an operation,business process, or human task, that cantrigger a subsequent action, such aspersisting the event data to a datarepository or invoking another businessprocess.

event keyA combination of data items that uniquelydefines an event instance. Identifying anevent instance enables the agent todetermine if it is new, ongoing orstopped.

event listThe set of detected event instancesevaluated by the task execution rules todetermine which agent tasks should beperformed.

Ffact See measure.

Ggateway

An extension of a web server programthat transfers information from the webserver to another server. Gateways areoften CGI programs, but may follow otherstandards such as ISAPI and Apachemodules.

glyph The actual shape (bit pattern, outline) of acharacter image. For example, italic A androman A are two different glyphsrepresenting the same underlyingcharacter. Strictly speaking, any twoimages which differ in shape constitutedifferent glyphs. In this usage, glyph is asynonym for character image, or simplyimage (The Unicode Standard – Version1.0).

Glossary 27

group A collection of users who can share accessauthorities for protected resources.

groupingIn reporting, the process of organizingcommon values of query items togetherand only displaying the value once.

Hhierarchy

The organization of a set of entities into atree structure, with each entity (except theroot) having one or more parent entitiesand an arbitrary number of child entities.

Iinformation card

A display of high-level information aboutdashboard or report content, such asowner, contact information, datemodified, and an optional thumbnail viewof the dashboard or report.

information paneIn Analysis Studio, a pane that helps theuser to confirm their selection in the datatree by displaying related information,such as the level and attributes.

initiativeA task developed to achieve objectives orclose the gap between performance andtargets. Initiatives are associated withindividual objectives and often known asprojects, actions, or activities.

item See member.

Jjob A group of runnable objects, such as

reports, agents, and other jobs that theuser runs and schedules as a batch.

job stepThe smallest part of a job that can be runseparately. A job step can be a report or itcan be another job.

Llayout The arrangement of printed matter on a

screen or page, including margins, linespacing, type specification, header andfooter information, indents, and more.

level A set of entities or members that formone section of a hierarchy in a dimensionand represent the same type of object. Forexample, a geographical dimension mightcontain levels for country, region, and city.

locale A setting that identifies language orgeography and determines formattingconventions such as collation, caseconversion, character classification, thelanguage of messages, date and timerepresentation, and numericrepresentation.

MMDX See Multidimensional Expression

Language.

measureA performance indicator that isquantifiable and used to determine howwell a business is operating. For example,measures can be Revenue,Revenue/Employee, and Profit Marginpercent.

memberA unique item within a hierarchy. Forexample, Camping Equipment and 4 Mantent are members of the Productshierarchy.

metric A measure to assess performance in a keyarea of a business.

metric extractA set of mappings between an existingCognos data source and a Metric Studioobject or value. For example, a cubemeasure named Revenue is mapped to aMetric Studio metric named RevenueActual Value.

metric packageIn Cognos Connection, a representation ofa Metric Studio application. A metricpackage contains connection information,reports, and metric management tasks forthat application. See also package.

metric storeA database that contains content formetric packages. A metric store alsocontains Metric Studio settings, such asuser preferences.

metric typeA category of metrics that defines thebusiness rules such as performance


pattern, units, and meaning of a group ofmetrics. For example, Revenue can be ametric type, and European Revenue andNorth American Revenue would bemetrics of this type.

model A physical or business representation ofthe structure of the data from one or moredata sources. A model describes dataobjects, structure, and grouping, as wellas relationships and security. In CognosBI, a model is created and maintained inFramework Manager. The model or asubset of the model must be published tothe Cognos server as a package for usersto create and run reports.

multidimensional data sourceSee dimensional data source.

Multidimensional Expression LanguageThe multidimensional equivalent ofStructured Query Language (SQL).

Nnamed set

See predefined set.

namespaceA part of the model in which the namesmay be defined and used. Within anamespace, each name has a uniquemeaning.

news itemA single entry in a Really SimpleSyndication (RSS) compatible format. Itcan include a headline, text, and a link tomore information. A news item task in anagent can be used to create news itemsfor display in a Cognos Connectionportlet.

Oobject In Report Studio, an empty information

container that can be dragged to a reportfrom the Toolbox tab and then filled withdata. Reports are made up of objects,which include crosstabs, text items,calculations, graphics, and tables.

object extractAn extract that defines the metadata for aMetric Studio object, such as a userdefined column, a scorecard, or a datasource.

Ppackage

A subset of a model, which can be thewhole model, to be made available to theCognos server. See also metric package.

page setIn Report Studio, a set of one or moredesigned pages which repeat in the reportoutput for each instance of a chosenquery item. See also set.

passportSession-based information, stored andencrypted in Content Manager memory,regarding authenticated users. A passportis created the first time a user accessesCognos 8, and it is retained until asession ends, either when the user logs offor after a specified period of inactivity.

portletA reusable component that is part of aweb application that provides specificinformation or services to be presented inthe context of a portal.

predefined setA set of members defined inside an OLAPdata source as a list or by an expression.Predefined sets can be used in analysisand report authoring. See also custom set,set.

product localeThe code or setting that specifies whichlanguage, regional settings, or both to usefor parts of the product interface, such asmenu commands.

project

1. In Metric Studio, a task or set of tasksundertaken by a team and monitored on ascorecard. A project tracks dates,resources, and status.

2. In Metric Designer, a group of extracts.Each extract contains the metadata that isused to populate the Metric Studio datastore or to create applications.

promptA report element that asks for parametervalues before the report is run.

properties paneWithin a studio, a pane that provides anoverview of the properties for selecteddata. The properties pane can also be

Glossary 29

used to make several changes and applythem at the same time, instead ofrepeating several different commands.

publishIn Cognos BI, to expose all or part of aFramework Manager model orTransformer PowerCube, through apackage, to the Cognos server, so that thedata can be used to create reports andother content.

Qquery The simple report specifications created

and edited by Query Studio.

query itemA representation of a column of data in adata source. Query items may appear in amodel or in a report and contain areference to a database column, areference to another query item, or acalculation.

query subjectA named collection of query items thatare closely functionally related. Querysubjects are defined using FrameworkManager to represent relational data andform the set of available data forauthoring reports in Query Studio andReport Studio. A query subject is similarto a relational view in that it can betreated as a table but does not necessarilyreflect the data storage.

RReally Simple Syndication

An XML file format for syndicated Webcontent that is based on the Really SimpleSyndication specification (RSS 2.0). TheRSS XML file formats are used by Internetusers to subscribe to websites that haveprovided RSS feeds. See also Rich SiteSummary.

repeaterIn Report Studio, a cell container thatrepeats values within itself with nopredefined internal structure.

repeater tableIn Report Studio, a table-like containerthat repeats cells across and down thepage or row in the associated query.

report A set of data deliberately laid out tocommunicate business information.

report outputThe output produced as a result ofexecuting a report specification against adata set.

report specificationAn executable definition of a report,including query and layout rules, whichcan be combined with data to produce areport output.

report viewA reference to another report that has itsown properties, such as prompt values,schedules, and results. Report views canbe used to share a report specificationinstead of making copies of it.

response fileAn ASCII file that can be customized withthe setup and configuration data thatautomates an installation. The setup andconfiguration data would have to beentered during an interactive install, butwith a response file, the installation canproceed without any intervention.

Rich Site SummaryAn XML-based format for syndicated webcontent that is based on the RSS 0.91specification. The RSS XML file formatsare used by Internet users to subscribe towebsites that have provided RSS feeds.See also Really Simple Syndication.

RSS

1. See Rich Site Summary.

2. See Really Simple Syndication.

Sscore A number or ranking that expresses

applicability in relation to a standard.

scorecardA collection of metrics representing theperformance of one unit or aspect of anorganization.

scorecard structureThe hierarchy of scorecards that reflectshow an enterprise organizes its metrics.

security providerSee authentication provider.


selection-based setA collection of individual items that theuser has explicitly selected. The items ormembers may be selected from one ormore levels of the same hierarchy. Seealso set.

sessionThe time during which an authenticateduser is logged on.

set A collection of related items or members.Members in a set may be specificallychosen, or selected by one or more filterrules. See also custom set, details-basedset, page set, predefined set,selection-based set, stacked set.

stacked setTwo or more sets arranged one aboveanother in rows or side-by-side incolumns. See also set.

strategyThe overall plan of action (such as for abrand unit, business unit, channel, orcompany) to achieve a stated goal.Strategies normally cover a period ofmore than one year.

strategy mapIn Metric Studio, a visual representationof the strategy and the objectives of thatstrategy for an organization. For example,a strategy map may show employees howtheir jobs are aligned to the overallobjectives of the organization.

summaryIn reporting and analysis, an aggregatevalue that is calculated for all the valuesof a particular level or dimension.Examples of summaries include total,minimum, maximum, average, and count.

Ttask An action performed by an agent if the

event status meets the task executionrules. For example, an agent can send ane-mail, publish a news item, or run areport.

task execution ruleA user-specified option within an agentthat determines which statuses and valuescause a task to be run. It determineswhich tasks to execute for each eventinstance.

templateIn report authoring, a reusable reportlayout or style that can be used to set thepresentation of a query or report.

thumbnailAn icon-sized rendering of a largergraphic image that permits a user topreview the image without opening aview or graphical editor.

tuple An ordered collection of two or moremembers from different dimensions. Forexample, the tuple (2007, CampingEquipment, Japan) returns the value forthe intersection of the three members:2007, Camping Equipment, and Japan.Tuples can be used to filter and sort data,and to create calculations.

Uunion set

See stacked set.

user Any individual, organization, process,device, program, protocol, or system thatuses the services of a computing system.

user-defined columnIn metric management, a column used torepresent a value other than the actual ortarget. It may be an industry benchmarkor any other useful additional numericalinformation for a period, including acalculation based on the other values ofthe metric. User-defined columns may bedifferent for each metric type.

Wwatch list

A list of metrics that each user has chosento monitor closely. If notification isenabled in Metric Studio, the user willreceive e-mail notification of changes tothese metrics. Users can also choose todisplay their watch list as a portlet withinCognos Connection.

watch ruleA user-defined condition that determineswhether a report is delivered to the user.When the rule is run, the output isevaluated and, if it satisfies the conditionor rule, the report is delivered by e-mailor news item. Watch rules limit report

Glossary 31

delivery to those reports containing dataof significance to the user.

Web Services for Remote PortletsA standard for creatingpresentation-oriented web services so thatthey can be easily integrated within otherapplications, such as web portals.

widgetA portable, reusable application or pieceof dynamic content that can be placedinto a Web page, receive input, andcommunicate with an application or withanother widget.

work areaThe area within a studio that contains thereport, analysis, query, or agent currentlybeing used.


Index

Aaliases 13

Bbase language 5

Ccopyright of maps 12CSV file requirements 15custom layers 8

Ddefault map preview images 12description of map 12dictionary 5, 13disk space 3

Eenvironments supported 3errors

importing translation files to Map Manager 19European map

boundary changes 1exporting

translation files 13

Ffeatures 5

Gglossary 25

Iimporting

non IBM maps 10translation files 15

India mapboundary changes 1

installing Map Manager 3

Llayers 5

creating custom 8locales

adding 13log files

installation 3troubleshooting 19

Mmap charts and Report Studio 7map features

adding aliases to the dictionary 13finding 13

Map Managerimporting files 19importing translated text files 19

mapsadding 17adding a description 12boundary changes 1copyright information 12importing 10merging 15moving in Report Studio selection dialog 9opening 8preparing for use in reports 11previewing image 12resetting the preview image 12saving 9saving with different name or location 9upgrading 15

Nnew features 1non IBM maps

importing 10

Ooperating system 3

Ppreviewing map images 5, 12

RReport Studio

map description 12map selection dialog 9using map charts 7

requirementsfor TXT and CSV files 15system 3

Ssearching map features 13source of new maps 17starting Map Manager 7system requirements 3


Ttext files

exporting 13importing 15

thumbnail view 12translation files

exporting 13importing 15problems importing into Map Manager 19

troubleshooting 19TXT file requirements 15

Uuninstalling Map Manager 4

Wworld map

boundary changes 1


Documents

Map Manager