Search in RPE

With RPE 1.2 we have added search capabilities to Document Studio and we have expanded these capabilities in RPE 1.2.1.

The RPE Infocenter search topics are listed below but in this post I want to provide a quick summary with visual guidelines of the various search capabilities .

You can invoke the search functionality in 4 ways:

  • from the Outline View
  • from the Schema View
  • from the “Search” menu
  • find in schema

Searching from the Outline View

This option is available for variables, master page and styles and can be accessed from Outline’s context menu.


Choosing “Search Variable References” ( or Search Style , Search Master Page etc) will give a list with all the locations where the variable was used.


TIP using the Outline View search function is the preferred way for searching where  variables/master pages/styles are used. The same functionality is available from the Search menu but requires you to type the search term.

Search data references

The Data Source Schema View allows to quickly search where queries are used. To search wherever a certain schema query is used in the template, select the matching path in the schema, right click on it and select “Search for Data References”


The search results will contain where that exact query, in my example Project/Requirements/PRRequirement, is used anywhere in the template.

The search results window allow you to visualize the element containing the search occurrence ( click on the result) but unlike most other search results you cannot edit it by double clicking the search result.


TIP using the Data Source View search function is the preferred way for searching where  queries are used. The same functionality is available from the Search menu but requires you to type the search term.

Search Menu

This is the most flexible approach, the method that includes all others. You need to type the search term and specify the search context.  From RPE 1.2.1 there is an “All” context which is a reunion of all the other search contexts.

The search term can used the basic wildcard search ( typical meaning for . and *) as well as Regular Expressions.

TIP use * before and after the search term to find all the occurrences for that term.


NOTE the file search and JavaScript search are provided by the Eclipse RCP ( Rich Client Platform) that RPE Document Studio is built on but they are not connected to RPE. Do not use them as they provide no results in RPE’s context.


Find in schema

The last search capability is a reverse of the “Search Data References” and is accessible from the editor area. This search allows to locate in schema a query used in the template. This is useful when you have a very long and complex query on an element and you want to add other properties/subqueries from it or you simply want to inspect its structure.

You access it by right clicking on the element holding your query and selecting “Go To Schema” from the ‘Search” menu.


The correct node is selected in the schema with all the parent nodes leading to it being automatically expanded.


Closing remarks

We continue to improve RPE’s search capabilities so if you feel there is a particular scenario which is not yet covered please raise an Enhancement Request through the IBM Software RFE Community.

Author: Dragos Cojocari

Architect for Rational Publishing Engine

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s