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

Organizing Entries

Organize entries such as reports, analyses, agents, and packages in a meaningful way so that you can easily find them. It is important to plan how you can best organize entries in the portal. Review the entries and attempt to group them in a logical way. Consider grouping the entries by type or frequency of use.

You may decide to create a folder hierarchy by using nested folders. The folder structure should be logical and should support the chosen method of grouping.

Use meaningful names and detailed descriptions to identify entries in the portal.

You can copy, move, rename, or delete entries. You can create copies of entries and store them in multiple folders for easy access. You can disable entries and specify the order of entries. You can select a link for an entry. For example, if a report is deleted, you may want to link an associated report view to a different report.

Remember that an entry often refers to other entries such as packages, reports, analyses, or queries. In addition, there may be references to entries in job steps, agents tasks, drill-through targets, or metrics. Reference IDs are hard-coded in the specification for each entry.

Note that references to deployment objects are based on search paths, not IDs. IDs are installation-specific while search paths are not.

Copy an Entry

When you create a copy of an entry, you create a replica of that entry in another location in the portal. For example, create a copy if you want to use a generic report as the underlying structure for additional reports. The copy of the entry has a new ID. If there is another entry of the same name in the target location, you are prompted to replace the existing entry with the copied entry. If you choose to replace the existing entry, the ID of the existing entry is used.

If you copy a folder, references for entries in the folder that reference each other are updated to reference entries in the copied folder.

If you want to run an existing agent or report with some minor changes, create an agent view or a report view . For example, to change the format, language, or delivery method of a report, create a report view. You can copy multiple entries at the same time to the same location.

If you want a report to appear in more than one location, create a shortcut .

You must have read permissions for an entry you are attempting to copy. You must also have traverse permissions for the current folder, and write and traverse permissions for the target folder .

Steps
  1. In Cognos Connection, select the check boxes next to the entry or entries you want to copy.

  2. Click the copy button  on the toolbar.

  3. Go to the desired location for the new entry or entries and click the paste button  on the toolbar.

  4. If an entry name is the same as an entry name in the destination folder, choose whether you want to replace the existing entry with the one that you are copying:

Move an Entry

When you move an entry, you remove it from the current folder and place it in another folder.

You may decide to move an entry if your folder becomes so full that it is difficult to locate particular entries. You can create a series of subfolders and move the entries to support your new folder hierarchy. For example, a folder containing weekly sales reports can be divided into sales reports by month or by author.

When you move an entry, the ID stays the same. References to the entry from other entries are not broken. However, shortcuts to the entry no longer work.

For example, a report has several report views associated with it. When you move the report to another location in Cognos Connection, the references in the associated report views are not broken. However, shortcuts to the entry no longer work.

When you move an entry, if there is another entry of the same name in the target location, you are prompted to replace the existing entry with the moved entry. If you choose to replace the existing entry, the ID of the existing entry is kept. References to the moved entry are broken. Shortcuts to the entry no longer work.

If you want to use a generic entry as the underlying structure for additional entries, make a copy of the entry . If you want an entry to appear in more than one location, create a shortcut . If you want to run an existing agent or report with some minor changes, create an agent view or a report view . For example, to change the format, language, or delivery method of a report, create a report view.

You must have read permissions for the entry you are attempting to move. You must also have write and traverse permissions for the current folder and for the target folder.

Steps
  1. In Cognos Connection, select the check boxes next to the entry or entries you want to move.

  2. Click the cut button  on the toolbar.

  3. Go to the desired location for the entry or entries and click the paste button  on the toolbar.

  4. If an entry name is the same as an entry name in the destination folder, choose whether you want to replace the existing entry with the one that you are copying:

Rename an Entry

You may decide to rename an entry. Perhaps the current name for an analysis is confusing or the purpose of a report changed.

When you rename an entry, the ID stays the same. However, the search path changes. References to the entry from other entries are not broken. Shortcuts to the entry no longer work.

For example, a package has reports, agents, and drill-through definitions associated with it. When you rename the package, the references in the associated reports, agents, and drill-through definitions are not broken.

You cannot rename an entry to the same name as another entry that already exists in the same location.

You must have read permissions for the entry you are attempting to rename. You must also have write and traverse permissions for the current folder and for the target folder.

Steps
  1. In Cognos Connection, locate the entry you want to rename, and in the Actions column, click the properties button .

  2. Click the Properties tab.

  3. In the Name box, type a new name for the entry.

  4. Click OK.

Disable an Entry

You can disable entries to prevent users from accessing them.

Disabling entries is useful when you want to perform maintenance operations. For example, you may want to disable a folder while you reorganize its content. When you disable a folder, the folder content is also disabled.

If an entry is disabled, the disabled icon  appears beside the entry to indicate that it is disabled.

If the source entry is disabled, all shortcuts to the entry appear with the source disabled icon , indicating that it no longer works.

You must have read and write permissions for an entry to enable or disable it. You must also have traverse permissions on the folder that contains the entry.

Steps
  1. In Cognos Connection, locate the entry you want to disable and, in the Actions column, click the set properties button .

  2. Click the General tab.

  3. Select the Disable this entry check box.

    Tip: To enable a disabled entry, clear the Disable this entry check box.

  4. Click OK.

If you have only read, execute, or traverse permissions for a disabled entry, you cannot see the entry in the portal. If you have write or set policy permissions for a disabled entry, it appears in the portal with the disabled icon .

Select a Link for an Entry

Some entries are linked to other entries when they are created. For example, a report view is linked to a report and a report or agent is linked to a package. Metrics are linked to a metrics package.

You can change the link for an entry. For example, if a report is deleted, you may want to link an associated report view to a different report. After you change the link, the report view reflects the content of the new report.

Select a link that is appropriate for the entry. For example, the package that a report is linked to must contain a valid model for the report to run correctly.

If the link associated with the entry is not available, Unavailable appears. For example, Unavailable appears if the package that a report is linked to is deleted.

You must have write permissions for the entry you are attempting to select a link for. You must also have write and traverse permissions for the current folder.

Steps
  1. In Cognos Connection, locate the entry you want and click the set properties button .

  2. Click the General tab and find the current link for the entry.

    For example, for a report, look in Package. For a report view, look in Source report.

  3. Click the link.

    For example, for a report, click Link to a package. For a report view, click Link to report.

  4. Select the new entry that you want to link the entry to and click OK.

Delete an Entry

When you delete an entry, you permanently remove it from the portal and its ID is deleted. You may decide to delete an entry because it is outdated or may no longer satisfy your requirements.

Deleting the source entry for a shortcut removes only the source entry. The shortcut entries remain but have an invalid reference icon  and are not accessible.

Deleting a shortcut or a report or agent view removes only the selected entry and not the source entry. References from other entries no longer work.

You must have write permissions or set policy permissions for the entry you are attempting to delete. You must also have write and traverse permissions for the current folder.

Steps
  1. In Cognos Connection, select the check boxes next to the entries you want to delete.

  2. Click the delete button  on the toolbar.

    A confirmation box appears.

  3. Click OK.

Specify the Order of Entries

You can specify the order of folders and entries in the portal. You may decide to organize entries by level of usage and place entries that you use daily at the top of the list.

By default, existing entries are sorted alphabetically. Entries added after the order is specified are shown at the end of the list.

To specify the order of entries, you must have read and write permissions for all entries in the folder and read and traverse permissions for the folder containing the entries.

Steps
  1. In Cognos Connection, click the tab you want.

  2. Click the order button  on the toolbar.

  3. Select the entries in the Shown in default order list box and click the right-arrow button  to move them to the Shown first list box.

    Note: You specify the order of folders and entries independently.

  4. Click the Up, Down, To top, and To bottom links to move the folders and entries within the list.

  5. Click OK.

Create a Folder

You can organize entries into folders. Having folders that are logically labeled and organized helps you easily locate reports. For example, you might want to create folders in My Folders or Public Folders to help you organize your entries.

You can create folders in the following locations:

You must have write access to a folder to create entries in it.

Tips
Steps
  1. In Cognos Connection, go to the location for the new folder.

  2. Click the new folder button  on the portal toolbar.

  3. In the Name box, type the name of the new folder.

  4. If you want, in the Description and in the Screen tip box, you can type a description of the entry.

    The description appears in the portal when you set your preferences to use the details view . The screen tip, which is limited to 100 characters, appears when you pause your pointer over the icon for the entry in the portal.

  5. If you do not want to use the target folder shown under Location, choose another location:

  6. Click Finish.

The new folder has the same permissions as the parent folder. For information about changing access permissions, see Access Permissions.