About this task
To search a property name / property value pair, it is
necessary to perform the following steps:
Procedure
- Specify the BTT property name and property value
Type
your values in
Property Name and
Property Value entry
fields. Both fields are mandatory.
- Property Name
The Property Name entry field is the property identifier
that you want to search.
,
- Property Value
- The Property Value entry field contains the value of the
property to search for.
Use * to indicate any set of characters and ? to indicate
any character.
As explained later, it is also necessary to select
the artifact types that must be taken into account when searching.
On the other hand, notice that
Notice that for different artifact
types, available Property Name for searching is different - In case of Data Elements, Contexts, Types, Formats, Operations,
Services and Flows, the Property Name can be
- any properties defined in the “Detailed Information” section except
“Comments” Property.
- “Direction” Property only have 4 values
- “input” (only input)
- “output” (only output)
- “both” (input and output)
- “none” (no input and no output)
It follows a property search example of “Data Elements”:
- In case of Views, the Property Name can be only
“Context” and “CSS”.
- If it is “CSS”, the value must be a file name, so all the views
that contain this file name in their css files will match the search.
It follows an example of Views properties search:
- In case of Widgets, the Property Name can be all
the property names shown in the “Properties” view. It also applies
for extended widgets and extended properties at project level. It
follows an example of Widgets properties search:
- In case of Conditions, the Property Name can be
“Id”, “Description” and “Deprecated”.
- If it is “Deprecated” property, possible values are Y or N. It
follows an example of Condition properties search:
- Select “Case sensitive” and “Exact match” options if necessary
- Check “Case sensitive” check box in case you want the search
to take into account upper and lower case in property name and property
value.
- Check “Exact match” if you want to search for a property name
and a property value that are exactly as specified.
- Select the BTT artifact type to search for Select
one or more BTT artifact types in the “Search For” section. They are
the artifact types that will be taken into account when searching
all the occurrences where the property name belonging to these kinds
of artifacts is defined and it has value equals to the value specified
by the user.
- Select the Search Scope
Search
scope functionality is the same as the one existing in Eclipse/RAD
search.
Choose the scope for your search. You can either search
the whole workspace, previously selected resources, projects enclosing
the selected resources or pre-defined working sets.
Workspace: it
searches in the whole workspace.
Selected resources: it
searches in the resources selected previously in BTT Project Explorer.
So, notice that first it is necessary to choose all the resources
where you want to do the search and then open the BTT search view.
Enclosing
projects: if you select some files in the BTT Project Explorer
and then you check “Enclosing projects” in BTT Search view, the search
result will search in all projects that contain the selected files.
Working
sets: it allows to search in specific working sets defined via
“Choose” button.
- Click Search button.
After clicking the “Search” button, the
Search view
would display the results details of your search.
- Match results are grouped by project.
- When double clicking on a match result, the corresponding file
of this match will be opened and the appropriate artifact will be
selected.
Follows an example of artifact id search to search data
elements with identifier “sessionData”:
Notice that
Search view shows
the results “as Tree” (by default) as well as “as List”. Also, there
are options
- to expand and collapse projects
- to remove matches from the results list
- to navigate through the matches results (via “Show Next Match”
/ “Show Previous Match”)
Example
Follows an example of properties search of “description”
property with any value in Data Elements and Conditions artifacts:
Search results view:
When double clicking on the match, the corresponding
file is opened and the artifact is highlighted: