Searching for properties

About this task

To search a property name / property value pair, it is necessary to perform the following steps:

Procedure

  1. 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:
  2. 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.
  3. 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.
  4. 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.

  5. 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: