Creating an index update task

The index supports the full-text search option in IBM® Cognos® Connection, IBM Cognos Viewer, Query Studio, and Analysis Studio. You must run the index update task once before results are returned for a full-text content search.

The index is not automatically updated when content changes, such as when a report is redeployed or when an object is removed from Content Manager. You must update the index to capture all changes. An indication that removed content is still in the index is if the results of an index search display the broken link icon instead of the expected icon. Also, the name of the search object appears in IBM Cognos Connection as plain text rather than a hyperlink. To ensure that the most recent content additions and deletions are reflected in the index and search results, define a schedule to update the index.

To view a list of object types that are indexable, in IBM Cognos Administration, click Index Search, and Index.

Tip: To find out when an object was last indexed, in Cognos Connection, click the set properties icon for the object. On the General tab, see the Indexed property. If the Indexed property does not appear, the object has not been indexed.

Procedure

  1. In IBM Cognos Administration, on the Configuration tab, click Content Administration.
  2. To start the New Index Update Wizard, click the new index update icon.
  3. Type a unique name and, if you want, a description and screen tip for the index update entry. Select the folder where you want to save the entry, and then click Next.
  4. To include entries in the index update task:
    • In the Included Content section, click Add.
    • Select the packages and folders to be included in the index update task.
    • Click the arrow button to move the selections to the Selected Entries list.
    • Click OK.
    Note: Object types that have been excluded from the index update service will not be indexed, even if they appear in a package, folder, or namespace that is included in the index update task. For more information see Refine the Scope of the Index.
  5. To exclude entries from the index update task:
    • In the Excluded Content section, click Add.
    • Select the packages and folders to be excluded from the index update task.
    • Click the arrow button to move the selections to the Selected Entries list.
    • Click OK.
  6. Click Next.
  7. Choose the action that you want:
    • To run now or later, click Save and run once and click Finish. Specify the date and time for the run, the content options, and the scope of the update. For more information about the options, see Updating an index. Click Run. Review the summary and then click OK.
    • To schedule at a recurring time, click Save and schedule and click Finish. Then, select frequency and start and end dates, the content options, and the scope of the update. For more information about the options, see Updating an index. For more information about scheduling, see Schedule Management.
    • To save without scheduling or running, click Save only and then click Finish.

Results

After the index update task runs once, full-text search is available to users.