Overview #
This article explains how administrators can initialize indexing from the Codebeamer Reports page using the Indexing UI. Use this feature when you need to reindex items based on a cbQL query.
Prerequisites #
- You have Administrator privileges in Codebeamer.
- You have access to the Reports page.
- You can generate or view the cbQL string used by the report.
Run a report #
- Go to the Reports page in Codebeamer.
- Run any report as usual.
- After the report loads, a new Index button appears.
This button is only available to administrators.
Open the Indexing UI #
-
Click the Index button on the report.
A modal opens showing the cbQL string used by the report.
- This string is the basis for reindexing.
- It can be reused to run indexing again without rebuilding the report.
Start indexing #
- In the modal, confirm the cbQL selection.
- Initiate indexing.
- Indexing begins immediately based on the items returned by the cbQL query.
View indexing progress #
Indexing progress is shown in your user account popover.
The popover displays:
- Number of items sent for indexing
- Number of items that could not be sent for indexing
- Number of items awaiting indexing
These values update as indexing progresses.
Results and next steps #
After indexing is complete, Codebeamer updates the indexed items based on the cbQL query you submitted. You can run additional reports and reindex again at any time using the same workflow.