Search terms reports provide the ability to identify documents containing specific keywords or terms. You can enter multiple terms and generate a report listing the number of hits for each term in a document. You can determine the output of the report by selecting one of the following type options:
- Report Only - Creates a report that includes the number of hits for each term or phrase. A hit indicates one or more uses of the term or phrase in a document.
- Report and Tag - Creates a report that includes the number of hits for each term or phrase in addition to the following:
- Saves the results to a multiple object field named after the search terms report with the prefix STR so that the results can be reviewed later.
- Tags the documents using the multiple object field with the search term(s) found.
This page contains the following topics:
- Guidelines for using search terms reports
- Creating a search terms report
- Running a search terms report
- Accessing tagged documents using the Field Tree browser
- Using tagged search terms in a saved search
Also see this related recipe:
You’re a system admin at a law firm and one of your clients, a construction company, is involved in litigation regarding the use of materials that they weren’t informed were potentially environmentally damaging when they purchased them from a major supplier.
There are roughly three million files related to this case, including emails, email attachments, invoices, and technical manuals related to construction practices and material handling.
Before you begin review, you want a report that tells you how many times the names of toxic substances appear in the documents. To get this, you create a new search terms report. You give it a name that is consistent with other objects you've created for this case, "Hazardous Materials search terms report." For the Index field, you select the dtSearch index you already created for your reviewers. Since you don't need to actually tag the documents that contain the terms you want to include, you select the Report Only option for the Type field. For the Searchable Set field, you select the set of documents you specified when you created the saved search for the dtSearch index data source. Finally, in the Add Terms field, you enter the substances you want reported on, which are the same ones included in your client's lawsuit and the same ones for which you've already created choices for an issue coding field. These terms are:
- radioactive isotopes
You save and run the report. The results tell you how prevalent these terms are in the data set. You now have a better idea of what lies ahead.
Other user group permissions
You may have an occasion where you want to grant limited permissions to a group of users outside of the site administrators. For example, you want to limit users from creating new Search Terms Reports to keep your environment organized. However, at the same time, you want users to view, edit, and add to existing terms lists.
To add search terms report permissions to a user group:
- Create a new user group and add it to your workspace.
- From the Manage Workspace Permissions modal window, click Edit Permissions.
(In the image below, the group name is Processing - STR Users.)
- Scroll down to locate the two entries for search terms reports--Search Terms Report and Search Terms Result. You want to edit permissions for existing terms, so you will edit the Search Terms Result object. (The Search Terms Report object grants permissions for reports overall and not the content within the report.) Click one or more icons to enable the permission level. Available levels include Disable, View, Edit, Delete, Add, or Manage Security.
- Click Save.
- Click the Manage Workspace Permissions link.
- Click the Preview button for your group.
The workspace opens with the group permissions applied. This view is helpful if you want to see how the workspace looks and functions as a group member. A banner across the top of the page reminds you of the preview mode.
- Open a search terms report.
You now see buttons above the search terms list corresponding to the permissions granted. In the image below, add and edit permissions apply.
- Check the box next to one or more search terms.
The permission level buttons become active.
- Click the appropriate button to edit the search term.
Note: If the only permission level granted is Edit, you will not see any buttons above the list. In this case, you can click any search term to enable a text box. Complete your edits and click Enter to save and exit.
Use the following guidelines to ensure that your search terms report properly highlights the required terms:
- Define a saved search using conditions that return the required group of documents for the Searchable Set. Persistent highlighting applies only to documents in the searchable set. Relativity also only counts hits that fall within the searchable set. Related items not included in the searchable set will not be searched for search terms.
Confirm that your dtSearch index includes all documents in the Searchable Set of the search terms report.
- Select Report and Tag in the Type radio button list for the report. If you don't select this option, then a multiple object field isn't created for the search terms report. If this field isn't created you can't select it in the Highlight Fields option when creating a persistent highlights set. See Persistent highlight sets.
- When using a search terms report as a highlight source in a persistent highlight set, only the terms in documents associated with the current reports appear highlighted. If you add new search terms to the reports, you must run pending terms so that they appear highlighted in documents.
To create a new search terms report, follow these steps:
- Navigate to the Reporting tab.
The Search Terms Reports tab opens by default.
- Click New Search Terms Report.
- Complete the fields on the form. See Fields.
- Click Save.
After saving the search terms report, the Search Terms Report Status section and Search Terms Report console appear. As the status section indicates, you must add terms to your new report. See Adding or editing terms and highlight colors.
Search terms reports contain the following fields:
- Name - the search terms report’s name. This value can't exceed 75 characters.
- Index - the dtSearch index used to create the report.
- Searchable set - a saved search that includes the set of documents used to create the report.
- Type - select one of the following options:
- Report and tag - creates a report that includes the number of hits for each term or phrase in addition to the following:
- Saves the results to a multiple object field named after the search terms report with the prefix STR (e.g. STR - Industry terms) so that the results can be reviewed later.
- Tags each document containing search hits using the STR multiple object field with the search term(s) found in each document.
Report only - creates a report that includes the number of hits for each term or phrase.
- Report and tag - creates a report that includes the number of hits for each term or phrase in addition to the following:
- Calculate unique hits - if set to Yes, this setting includes a Unique hits value for each term in the search terms results. Unique hits is the count of documents in the searchable set returned by only that particular term. If more than one term returns a particular document, that document is not counted as a unique hit. Unique hits reflect the total number of documents returned by a particular term and only that particular term.
Note: Unique hits can help you identify terms in your search terms report that may be overly inclusive.
- Include relational group - includes the "Documents with hits, including group" counts for each term in the search terms results. This value counts the documents with hits for each term as well as all documents in the same relational group as the documents with hits. Include relational group only includes hits of related items in the searchable set. Relativity doesn't look outside of the searchable set. Click the ellipsis and select a relational group to include.
- Email notification recipients - specifies recipients to send an email notification to when your search terms report finishes running. Enter the email address(es) of the recipient(s). Separate entries with a semicolon.
To add or edit terms for your search terms report:
Note: You must create a persistent highlight set for highlighted terms to appear in your documents. See Persistent highlight sets for more information.
- Click the name of your search terms report.
- Click Modify Terms from the Search Terms Report console.
The Search Terms report window opens.
- Enter your terms in the text box under the New Terms heading so that each term appears on a separate line.
Alternatively, you can also click the Dictionary link to display the Dictionary Search pop-up. In the pop-up you can perform searches using fuzziness, proximity, and stemming. Click Copy to List to add the Dictionary search results to the New Terms text box.
Note: Each line is treated as an individual dtSearch query. For more information about dtSearch, refer to dtSearch.
- Click Add Terms to move your new terms to the existing terms list.
A single term has a character limit of 450. A confirmation message displays with the count of new terms added and duplicate terms ignored.
- (Optional) Select the checkbox next to the term(s) and select the background color and text color using the drop-down menus. See the preview text to verify that the resulting highlighted text is readable. Click Apply Color.
Note: By default, highlighted terms appear as black text with a magenta background.
- Click Done.
After adding new search terms to an existing report, you must run the terms so that they appear highlighted in documents. See Running a search terms report for details.
To remove terms from the search terms report:
- Click Modify Terms.
- Select the checkbox next to the term(s) you want to remove under Existing Terms.
- Click Delete.
- Click Done.
If you remove search terms from the reports, the terms automatically disappear from the search terms report results. You must run the report again for accurate totals in the status bar and when using View Term Report.
Copying a search terms report
You can copy an existing search terms report using the mass copy operation.
To copy a search terms report:
- From the Search Terms Reports tab, click the checkbox next to the search terms report you want to copy.
- From the mass operations bar, select Checked. Alternatively, you can select All to copy all search terms reports.
- Select Copy in the drop-down menu.
The Copy window displays.
- Click Ok to copy the items.
You generate a search terms report by using the options available in the search terms report console. The console appears after you save a search terms report or when you open an existing report from the Search Terms Report tab.
The console includes the following options:
- Modify Terms - opens the terms management screen. On this screen, you can add new terms to the report, apply text and background highlight colors, and delete existing terms from the report.
- Run All Terms - generates counts for each term. Use this option when generating the report for the first time or if you want to regenerate counts for all terms in the report. Run all terms after adding new documents to the searchable set.
- Run Pending Terms - updates an existing report. It runs a report on only those terms with a Pending status.
- View Results - opens the Search Terms Results page. This page displays the report results, listing the number of document hits for each term.
Navigate back to the search terms report console for the report you are viewing by clicking on the object name in the search panel filter card.
The Search Terms Results page provides the following:
- Name - search term included in search terms report.
- Documents with hits - the number of documents in the searchable set that contain the search term.
- Documents with hits, including group - counts the documents with hits for each term as well as all documents in the same relational group as the documents with hits. The count only includes hits of related items in the searchable set. It will not look outside of the searchable set.
- Unique hits - counts the number of documents in the searchable set returned by only that particular term. If more than one term returns a particular document, that document is not counted as a unique hit. Unique hits reflect the total number of documents returned by a particular term and only that particular term.
- Last run time - timestamp when the search terms report last ran.
In this page, you can also access a list of any terms that failed during the creation of the Search Terms Report. To read these error messages, change your view to Search Terms Results Details.
Note: Documents with hits is not security-aware or influenced by permissions. This means that it includes documents the user can't view in a basic search. For example, a user could perform a dtSearch that returns a total of five documents, including two inaccessible documents. Even though the user can only view three documents, the search terms count still includes all five documents originally tagged with the search term.
- View Term Report - In the Search Terms Report console, click View Term Report to open the graphical search terms report. You can print or save the report. To save, select a file type at the top of the report.
- Retry Errors - attempts to regenerate the report for search terms that returned error messages.
- Refresh Page - updates the information displayed on the page.
After running a search terms report, the search terms report status section appears. It lists the search terms report name and status. The status indicates the current progress of the report. This field contains either Searching your terms, Completed, or Error.
This section also provides a summary of the search terms report and its results:
- Number of terms - total number of terms run in the search terms report.
- Documents in searchable set - total documents in the designated searchable set.
- Total documents with hits - the number of documents in the searchable set that contain the search term.
- Total documents with hits, including <relational group name> - counts the documents with hits for each term as well as all documents in the same relational group as the documents with hits.
After you run a search terms report with the Report and Tag option enabled, Relativity creates a folder in the Field Tree browser with documents grouped by tags found by the search terms report. The folder is named after the STR multiple object field created by the search terms report. For example, if your STR is named Produced Documents, the folder in the Field Tree browser is named STR - Produced Documents.
Click a search term tag in the Field Tree browser to view documents in your searchable set tagged with the selected term. You can also email a link to the tagged documents by right-clicking the tag results and selecting Email Link.
After you run a search terms report with the Report and Tag option enabled, Relativity creates choices for each of the terms that you specified. You can then use these choices as criteria in a saved search.
Use this procedure to create a saved search using tagged search terms:
- Follow the instructions for setting fields in the Information and Search Conditions sections on a saved search.
See Creating or editing a saved search.
- Select your search terms report in the Field box and select a condition in the Operator box in the Conditions section.
- Click to display the Select STR dialog in the Value field.
- Perform the following tasks on the Select STR dialog:
- Select your search terms report in the Field box.
- Select an Operator, such as any of these.
- Click to select search terms on the Select Items dialog.
- Set any other fields as necessary.
- Click OK. If you added the tagged search terms called energy, oil, and enron, the Conditions section would appear as follows:
- Repeat steps 1 to 3 for each tagged search terms.
- Click Search to run your query.