The search menu in Harmoni makes it simple to find items of interest in the project tree. Many options are available to help narrow the search criteria and speed up the navigation through the project tree.
To commence your search, type what you are looking for in the search project tree field at the top of the project tree. Hitting enter or clicking on the search icon performs the search.
Harmoni defaults to showing all variables that match the search item.
- You can refine your search using the options under the search menu.
- When Harmoni cannot find matches, it displays the message: "warning - no matches in dictionary." You can check your search options and try searching again.
Items found in the search are highlighted. The searched text shows in orange.
The search menu
- Search Project Tree
- Search results
- Open/close replace field
- Search in
- Search by
- Reset options
- Reset tree
- Revert label
1. Search Project Tree
- Enter the keyword or phrase you want to locate in the search project tree field.
- Hit enter or click on the search icon.
- You can clear search results by resetting the tree or by using the
icon on the search field.
2. Search results options
When performing a search:
- show in tree identifies the found items and displays the entire project tree.
- shrink reduces the project tree and only shows the found items plus any headings required for context.
3. Open/close replace field
As you design your project, you may change labels one at a time, but there are more efficient ways to change multiple labels in one go. Search and replace can be useful for making several label changes in a single transaction.
- In the search project tree area, enter the word or phrase you want to locate.
- Hit enter or click on the search icon.
- Once you have found what you are looking for, enter your new text in the replace area.
- Hit enter or click on the replace icon.
4. Search in
- search in selected will limit the search to just selected items in the project to include in the search.
- Search results can be filtered to only include specific variable types using search in headings, axes and/or elements.
- Both the display label and the source label can be searched for.
- Select source label.
- In this example we have also added the expression search.
- In the search project tree field, enter the source label you want to locate.
- Hit enter or click on the search icon.
- The search will return items that match the relevant source label.
5. Search by
- partial - find any text containing the search string.
- exact - match the entire search string.
- expression - include key characters to tailor a search.
| Character | Description | Example |
| * | Multi-character wildcard |
Doing an expression search for: Q12_* Who will find all labels that contain the text Q12_, followed by anything, but then also contains the word "Who". |
| ? | Single-character wildcard |
Doing an expression search for: Q12_? Who will find all labels that contain the text Q12_, followed by a single character, then the word "Who". |
| \ | Escape character | If you want to search for a question mark using the expression search you would use \? |
| ^ | Matches the start of a string |
Doing an expression search for: ^Q5 will find any item starting with "Q5". |
| $ | Matches the end of a string |
Doing an expression search for: /?$ will find any item ending with a question mark (?). |
Example expression search
- Select search by expression.
- In the search project tree area, enter the expression you want to locate. In the example above we have used the single-character wildcard ? and the multi-character wildcard *.
- Hit enter or click on the search icon.
- The search will return items that match the selected criteria.
6. Reset options
Click on reset options and all search options return to the default settings.
7. Reset tree
Clear the search results by removing the search using the X at the end of the search field.
You can also clear search results by selecting the reset tree option at the bottom of the search pane.
8. Revert label
Revert is a powerful way to return your data design item(s) to a previous/original state. You can use the revert label option should you wish to change the display label across all sources or just from one of your sources. Reverting a label will create a new item(s) in the project tree.
Revert label is not an option for the below scenarios:
- any user created constructions.
- when an item only exists in one source.
- when the item display label is the same as the source label.
Before reverting a label keep in mind that constructions, saved analysis (views/stories) and data in dashboards will be lost. Action is not reversible.
To revert a label:
- Select the item you wish to revert the label.
- In the search menu, select revert label.
- Through the wizard you can select the sources you wish to revert labels. Select the relevant sources.
- Once you confirm you want to proceed a new item will appear in the project tree.
Revert Label - Naming Convention
After revert label, the new item name will follow the below naming convention:
a) Revert all sources
{Item_Source_Label}_{Source_Display_Name}_{Timestamp} _#Reverted#
Example:
- Q3 Q3-Age group_Hotel Survey 2013.sav_20190626091719505_#Reverted#
- Q2b Age Groupings_Hotel Survey 2014.sav_20190626091719505_#Reverted#
b) Revert partial sources
{Item_Source_Label}_{Timestamp}_#Reverted#
Example:
- Q3 Q3-Age group_20190620155411337_#Reverted#
- Weight Weight_20190620155905918_#Reverted#