To use Cognos product documentation, you must enable JavaScript in your browser.

The Project Page

After you create or open a project, the project page appears. The project page is where you design, package, and publish project metadata. This page contains several panes and views that you can use to view and modify the objects in a project.

The Project Viewer

The Project Viewer shows the objects in a project in a hierarchical view. You can use the Project Viewer to view, modify, and create objects.

Relationships are shown in both the Diagram and Explorer tabs. Imported functions are shown in the Explorer tab.

The Project Viewer uses the following icons to represent objects and states. A project may use some or all of the icons.

Icon

Object

 

Project

 

Root namespace or any other namespace in the project

 

Data source folder

 

Data source

 

Parameter map folder

 

Parameter map

 

Packages folder

 

Package

 

Published package

 

Dimension

 

Hierarchy

 

Level in a hierarchy

 

Measure dimension

 

Measure

 

Query subject

 

Query subject based on multidimensional data

 

Query subject that contains query items whose Usage property is set to Fact

 

Query item

 

Calculation whose Usage property is set to Attribute

 

Calculation whose Usage property is set to Identifier

 

Embedded calculation

 

Calculation whose Usage property set to Fact

 

Query item whose Usage property is set to Identifier

 

Query item whose Usage property is set to Fact

 

Query item that is located under a shortcut query subject

 

Calculation

 

Filter

 

Relationship

 

Semi-additive measure

 

The object is checked into the repository. This icon appears over other icons.

 

The object is checked out of the repository. This icon appears over other icons.

 

The object is checked out of the repository by a different user. This icon appears over other icons.

 

Linked segment or project that was updated. This icon appears over other icons.

 

Linked object. This icon appears over other icons.

 

Shortcut. This icon appears over other icons.

 

Invalid object. This icon appears over other icons.

The Explorer Tab

The Explorer tab shows the contents of a project, similar to any file system. Arrange objects by name, class, or description. If you have a large number of objects in a project, it may be easier to locate them in the Explorer tab.

You can use the Explorer tab to view, create, and modify objects and relationships. You can also create folders and namespaces to group objects.

The Diagram Tab

Use the Diagram tab to show the relationships between objects in a project. Relationships between objects are shown as lines with cardinality notation . You can expand objects and namespaces to show the object hierarchy and the relationships between objects.

In the Diagram tab, you can do any of the following:

Change the Settings for Diagrams

You can change one or more settings for diagrams.

Steps
  1. From the Diagram menu, click Diagram settings.

  2. Set the level of detail.

    You can select query items, relationships, scope relationships, cardinality, and descriptions.

  3. Select the type of notation.

    You can use Merise or Crowsfeet notation. By default, Framework Manager uses Merise notation. Merise notation marks each end of the relationship with the minimum and maximum cardinality of that end. You can also use Crowsfeet notation, which provides a pictorial representation of the relationship.

  4. To align objects more easily, turn the Snap options on.

  5. To have a network of evenly spaced lines in the background, select the Display grid check box.

  6. Select the font and color for text.

  7. If you are working in the Context Explorer, under Options for Context Explorer, specify showing objects with or without their related objects.

    If you change this option, it is applied the next time you open the Context Explorer.

  8. Click OK.

The Dimension Map Tab

You can use the Dimension Map tab to view, create, and modify hierarchies and levels for the dimension you selected in the Project Viewer. You can also view and modify scope relationships.

The Measures and Attributes tabs appear after you click the Dimension Map tab. Use the Measures tab to view or modify all the measures and scope relationships that are available in the model. Use the Attributes tab to view or modify the role of the selected query item.

You can also embed calculations in the query item.

Tip: The best way to view SAP BW metadata is in the star layout. From the Diagram menu, click Auto Layout Diagram, and then select Star.

The Properties Pane

The Properties pane shows the properties of the objects that you last selected in the Project Viewer, Explorer tab, Diagram tab, Dimension Map tab, Dependencies tab, Search pane, or Summary pane. Object properties are set during import, and some property values can be modified during modeling. You can use the Properties pane to add, modify, or delete the properties of objects.

You can modify the properties for multiple objects at one time. If you select more than one object, Framework Manager shows only the properties that are common to all the objects. You can

If you need more room, you can resize the Properties pane or move it so that it floats in the window. For example, if you have more than one monitor, you can then move the Properties pane to another monitor.

Replacing Multiple Property Values

You can replace multiple values for each text string property.

When you replace multiple property values, Framework Manager automatically updates elements that are dependent on the values you replaced. If any dependencies cannot be updated, such as data source and parameter map names, you must validate the model manually.

You can match either the entire property value, or part of the value. By matching part of the property value, you can perform multiple replacements on a single text property. For example, if you search for “nation” and replace it with “country”, the property value “This nation and that nation” is replaced with “This country and that country”. However, "national" will be replaced with "countryal".

Tip: Before replacing property values, enlarge the Properties pane and widen the column of the property whose value you want to replace.

Steps
  1. In the Project Viewer window, select multiple objects.

    Tip: To reduce the set of properties to search for before performing the replace, filter the properties first. On the Properties tab, right-click the column heading you want to filter on and click Set Autofilter.

  2. Choose one of the following:

  3. Right-click the column heading for the property whose values you want to replace, and click Bulk Replace.

  4. In the Search for and Replace with boxes, type the search and replace text strings.

    Tip: To replace empty properties, leave the Search for box blank.

  5. To perform a case-sensitive search, select the Match case check box.

  6. To search for the complete property text, select the Match entire cell contents check box.

    Tip: To replace all property fields, regardless of the text they contain, type one asterisk in the Search for box and select the Match entire cell contents check box.

  7. Do one or more of the following:

    As the changes to a property are made, the results appear on the tab.

    When the bulk replace reaches the last object in the list, a message appears showing the number of replacements.

The Tools Pane

The Tools pane contains the Summary tab, the Search tab, and the Dependencies tab.

You can change the Tools pane into a separate window. To do this, click the title bar of the pane and drag it in any direction until the outline of pane becomes a thick line. You can now drag the Tools window to any location on your desktop. To change the window back to a pane inside the Framework Manager window, drag it to one of the Framework Manager borders until the window outline becomes a thin line.

The Summary Tab

The Summary tab shows the language, statistics, and tasks available for the selected object in the Project Viewer.

The Project section shows the design language and the active language. You can change the active language.

The Statistics section shows the number of objects, by class, located in the currently selected object. If the selected object contains a folder, the contents of the folder are included in the number count. Selected objects include projects, namespaces, and folders. The default selected object is the project.

The Tasks section shows actions that are applicable to the currently selected object, based on the object class. If you select a folder, actions for the folder are listed. If you select an object in that folder, the list includes actions for both the object and the folder.

For more information about the object classes, see the c8_location\templates\bmt\CR1Model\BMTModelSpecification.xsd file.

The Search Tab

When you are working with a large project, it can be difficult to locate the objects that you need to complete a task. Use the Search tab to quickly find objects by applying different search criteria, such as the location, the class, a condition, or a property.

If your model contains multiple languages, ensure that you specify the Active language value in the Define Languages dialog box before searching for objects.

Steps
  1. In the Tools pane, click the Search tab.

    Tips:

  2. In the Search String box, type the text that you want to find.

    You can use uppercase, lowercase, or mixed case strings. The search is not case sensitive. Valid wildcard characters are "*" and "?".

  3. Click the double up arrow button  to show the search criteria boxes.

  4. In the Condition list, select a condition to apply to the search string.

    The Condition box determines how the Search string value is matched with text in the model. It contains a list of possible search conditions. If you want to search using wildcard characters, use the equals condition.

    A regular expression is a complex and powerful method for matching text strings. To search using a regular expression, use the regular expression condition. A regular expression search is case sensitive. For example, to find all objects that contain the word "Car" search for the string "\Car", without the quotation marks.

    The value for the Condition box is saved from session to session.

  5. In the Search in list, select the part of the model hierarchy that you want to search.

    The value for the Search in box is saved from session to session.

  6. In the Class list, select the single class of objects that you want to search.

  7. In the Property list, select the type of property that you want to search.

    The (All Properties) property searches all properties. The Object Name property restricts the search to the name of each object. The Text Properties property searches the set of properties that contain text strings, such as Description or Screen Tip, but not including the object name.

    The value for the Property box is saved from session to session.

  8. Click Search.

    The results are listed at the bottom of the Search tab. Search results can contain multiple values, such as text properties, for a single object. When you click an object that has multiple values, all the values that belong to that object are selected. If your model contains multiple languages, the search results include properties for each language in the model.

    After you do one search, the Subset check box becomes available. If you select the Subset check box, the next search operates on the existing search results. The Subset check box is cleared after each search. You can do successive subset searches by selecting the Subset check box.

  9. To see an object in the Project Viewer, click an object in the Search tab.

  10. To see an object in the diagram, right-click an object in the Search tab and click Locate in Diagram.

You can replace values for properties .

The Dependencies Tab

The Dependencies tab shows the objects that are dependent on a selected object. For more information, see Show Object Dependencies.