You are here: Features > Search > More About Search Filter Sets > Search Filter Set Example

Search Filter Set Example

This feature is supported in DotNet Help, WebHelp, WebHelp Plus, and WebHelp AIR output.

Concepts and search filters might seem a little confusing to you at first. The following example is designed to help make these ideas clearer and guide you through the steps for creating your own search filter by using concepts.

Scenario

Let's say we have a Flare project called "Pets." In this project, we have dozens of topics about all kinds of animals (cats, dogs, parrots, hamsters, and so on). We have written five topics about dogs. These are:

Choosing a Dog
Feeding a Dog
Training a Dog
Grooming a Dog
Walking a Dog

We want our users to be able to search for information about dogs. However, we want to limit their search to these five topics (so that they aren't bothered with seeing search results in other "non-dog" topics). We'll use a concept to tie our five "dog" topics together, and then we'll customize the search feature to include this concept.

Step 1 - Create and insert a concept

First, we need to create a concept to tie these five topics together. We can create a concept with any name that we want, but it helps to name the keyword something that is obvious and all topics have in common. Therefore, we'll give our concept the name "dogs."

Open any of the five topics. In this example, we'll open the topic "Choosing a Dog."
Click in the location in the topic where you want to insert the concept. Typically, you'll insert the concept somewhere near the top of the topic. In our example, we will click right before our topic title "Choosing a Dog."
Select Tools>Concept>Concept Window or press SHIFT+F9 on your keyboard. The Concept window pane opens. Example
The cursor should already be placed in the Terms cell. If not, click in that cell. Then type dogs and press Enter. A concept marker labeled "dogs" is added before the topic title. Example (If you cannot see the marker, you need to turn your markers on by selecting View>Show>Show Markers.)

Step 2 - Copy and paste the concept marker into all relevant topics

Next, we need to place the same concept marker in our other four "dog" topics. We could repeat the same steps above for each topic, but we'll copy and paste our first concept marker instead.

In the "Choosing a Dog" topic, click on the concept marker and choose Select.
In the Standard toolbar, click .
Open another "dog" topic ("Feeding a Dog," "Training a Dog," etc.). Click in front of the topic title (or somewhere near the top of the topic), and in the Standard toolbar, click . Repeat this until you've pasted the concept marker into all five of the "dog" topics.

Step 3 - Create a search filter

Now that we have the concepts in place, we can create a search filter for the "dog" topics.

Select Project>Advanced>Add Search Filter Set. The Add Search Filter Set dialog opens.
Click Add. The search filter set is added to the Advanced folder in the Project Organizer. The Search Filter Set Editor opens to the right, with an initial search filter entry shown.
Click in the cell under the Filter Name column until "My Subset" is highlighted. Type Dog Topics and press Enter.
Click in the cell under the Concepts column. The Select Concepts for Search Filter dialog opens.
In the Selected Concepts section, double-click dogs. The concept is added to the "All Concepts" section on the left side of the dialog.
Click OK.
Press CTRL+S or click to save your work.

Step 4 - Associate the search filter set with a target

Finally, we need to make sure the search filter set that we created is associated with the target that we plan to build.

Open the target that you plan to build.
Click the Advanced tab.
Click the drop-down arrow in the Filter File field, and select the search filter set that we created.
Press CTRL+S or click to save your work.

Now when people use the search feature in our output, they can select "Dog Topics" from the Filter field to limit their search to our five "dog" topics.