Previous Topic: Show My Reserved VersionsNext Topic: Find Version - Results


Find Versions

The Find Version dialog lets you select item versions from a list. The various options on this dialog work with one another to let you select versions according to multiple criteria. In addition, you can use the Find Version dialog to obtain version information.

Follow these steps:

  1. Click Tools, Find Version.

    The Find Version dialog appears.

  2. Specify a context for the search.
  3. (Optional) Select the Select Inactive Users check box to find the versions that are created / modified by the inactive users.

    Note: An inactive user is no longer associated with the current projects.

  4. Complete the fields in the dialog:
    Name

    Filters versions according to a naming pattern. You can use any number of wild cards (*) in any position for multiple character matching. You can use the question mark (?) for single character matching. You can specify multiple version names at the same time by separating the names with a semicolon. The Name field is not case-sensitive, for example, entering N* locates versions with names that begin with N or n.

    Package

    Filters versions that are based on the name of the package that created them. Clicking the button next to the Package field opens the Select a Package dialog listing all packages in the current context. This filter is not available when viewing versions in snapshot views.

    Package Group

    Filters versions that are based on the packages from the package group in the selected state. Clicking the button next to the Package Group field opens a Package Group dialog listing all package groups in the current context. This filter is not available when viewing versions in snapshot views.

    Providing the Package or Package Group name is mutually exclusive.

    View Path

    Changes the current location to any position in the current path. You can change the path by clicking the button next to this field. The Repository Path Selection dialog appears and lets you browse through available paths and select a location.

    Include subfolders

    Specifies versions that match the other filtering criteria in every path below the current one. You can then select versions from multiple paths to include in this operation. By selecting this option and clicking Find displays expanded paths displays the item names and their relative paths from your current position.

    Word/Phrase in File

    Specifies text to search for in text files as the Storage Type buttons indicate.

    Version/View

    Filters the versions in one of the following ways.

    If you select the package option, the following attributes are available:

    • Latest in View
    • Latest in Package
    • Latest
    • All in View
    • All in Package
    • All

    If you select the package group option, the following attributes are available:

    • Latest in View
    • Latest in Package Group
    • Latest
    • All in View
    • All in Package Group
    • All

    Based on your selection for the package or package group, the following attributes in the version/view are available.

    Latest in View

    Displays the latest versions for each item in the current view that match the other filtering criteria. Only one version per item displays. This option is incompatible with viewing branch versions because they are not in a view. When selected, the only Branch option available is Trunk Only.

    Latest in Package

    Displays the latest versions that are associated with the package specified in the Package field. This option is available only when the Package field is populated.

    Latest

    Displays the latest version for each item that matches the other filtering criteria. Versions that do not exist in the view but are associated with the current state also displays. Only one version per item displays. This option is not available when viewing versions in snapshot views.

    All in View

    Displays all versions matching the other filtering criteria that exist in the view that is associated with the current state. Only promoted versions display in another view. This option is incompatible with viewing branch versions because they are not in a view.

    All in Package

    Displays all versions that are associated with the package specified in the Package field. This option is available only when the Package field is populated.

    All

    Displays all versions. Versions include the branch and trunk even if that do not exist in the view but are associated with current state. This option is not available when viewing versions in snapshot views.

    Latest in Package Group

    Displays the latest versions that are associated with the packages within the package group that is specified in the Package group field.

    All in Package Group

    Displays all versions that are associated with the packages within the package group that is specified in the Package group field.

    Description

    Specifies text to search for in the description of the version. You can select the case-sensitive check box based on your search requirements.

    For example: If you search for No keyword with the case-sensitive option selected, the search results display all the possible combinations like NO, no, No, or nO.

  5. Click Find.

    The versions matching the filtering criteria are listed.

  6. (For selecting versions only) Click OK to return all files to the calling dialog.