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.

searchinrpe_outline_1

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

searchinrpe_outline_2

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”

searchinrpe_dataref_1

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.

searchinrpe_dataref_2

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.

searchinrpe_menu_1

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.

searchinrpe_menu_2

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.

searchinrpe_findinschema_1

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

searchinrpe_findinschema_2

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.

Advertisements

Author: Dragos Cojocari

Architect for Rational Publishing Engine

Leave a Reply

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

WordPress.com Logo

You are commenting using your WordPress.com 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 )

Google+ photo

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

Connecting to %s