Find labels using advanced search

You can search for the descriptive title of a snapshot version. The Label is entered on the Create snapshot and Save as Branch screens, in the Name field and has a limit of 50 characters. You can search by either entering part of a label or selecting from a list of saved labels.

Before you begin

  • To access the Changesets module, you must have one of the following permissions:
    • Administrator permissions
    • Changesets module permissions

    Administrators can grant access to the Changesets module by following the steps in Allow non-Admin users to work with changesets.

  • In the Changesets module, Advanced search is available only on the Changesets tab. You cannot open Advanced search on the Histories tab.
  • The Advanced search feature in Changesets does not include Advanced content, so you cannot use XPath expressions here to search.

Tips and tricks

Choose how to search for a Label

Search by entering Label text

To search by entering Label text:

  1. From the top menu options, select the Changesets module.
  2. If not open, select the Changesets tab.
    You cannot open advanced search on the Histories tab.
  3. On the Changesets tab, select Advanced search.

    Result: a new pane opens in between the basic search bar and the changeset list.

  4. In the Field list, select Label.
  5. In the Operator list, select one of the following:
    • = (Equals): show only changeset records that have a Label with the exact characters you enter in Value
    • <> (Not Equal to): show all changeset records that do NOT have a Label with the exact characters you enter in Value
    • Contains: show only changeset records where the Label has some of the characters you entered in Value
    • Does Not Contain: show only changeset records where the Label does NOT have any of the characters you entered in Value
    • Starts With: show only changeset records where the Label begins with the characters you entered in Value
    • Does Not Start With: show only changeset records where the Label does NOT begin with the characters you entered in Value
    • Ends With: show only changeset records where the Label ends with the characters you entered in Value
    • Does Not End With: show only changeset records where the Label does NOT end with the characters you entered in Value
  6. In the Value list, enter part of or an entire word or phrase that might be used in a Label.
  7. Optionally, you can revise your search criteria:
    1. Click add_clause Add to add another search parameter.
    2. Click remove_clause Remove to remove a search parameter.
    3. If you have multiple parameters in the query, choose the appropriate criteria from the And/Or list.
    4. To group search parameters, select the checkboxes for two or more consecutive parameters and click Group selected clauses.
    5. To ungroup search parameters, click ungroup_clauses Ungroup clauses.
  8. Verify the search parameters for your query and then click search_button Search.

    Result: You see a list of changesets that match your criteria.

  9. To save the list of components that match the search as a CSV file:

    1. Click ExportCSV Save as CSV.
    2. To choose what time zone is used, on the Convert time confirmation screen, select one of the following:

      You see the date displayed in the header of the CSV as: All date/times are shown in {timezone} or UTC.

      UTC is a time zone standard used as a basis for all time zones worldwide. It is a constant time scale and does not change for Daylight Saving Time.

      • To use your local time, click Yes.
      • To use UTC time, click No.

      Result:

      If the list of changesets contains more than 200 records, only the first 200 are saved to the CSV file.

      • You see a file is downloaded to your computer using the following format:
        • InspireChangesets_DD-MM-YYYY-HH-MM-SS-MS
      • If you searched for a change, Inspire now saves only your search results to the CSV file.
      • If you filtered the list, Inspire now saves your filtered list to the CSV file.
      • If you sorted the list, Inspire now saves your sorted list to the CSV file.

Search by selecting a saved Label

If you don't know the exact wording of the Label, you can search by selecting from a list of saved Labels.

To search by selecting a saved Label:

  1. From the top menu options, select the Changesets module.
  2. If not open, select the Changesets tab.
    You cannot open advanced search on the Histories tab.
  3. On the Changesets tab, select Advanced search.

    Result: a new pane opens in between the basic search bar and the changeset list.

  4. In the Field list, select Label (Valid Values).
  5. In the Operator list, select one of the following:
    • = (Equals): show only changeset records that have a Label with the exact option you select in Value
    • <> (Not Equal to): show all changeset records that do NOT have a Label with the exact option you select in Value
  6. In the Operator list, select a saved Label.
  7. Optionally, you can revise your search criteria:
    1. Click add_clause Add to add another search parameter.
    2. Click remove_clause Remove to remove a search parameter.
    3. If you have multiple parameters in the query, choose the appropriate criteria from the And/Or list.
    4. To group search parameters, select the checkboxes for two or more consecutive parameters and click Group selected clauses.
    5. To ungroup search parameters, click ungroup_clauses Ungroup clauses.
  8. Verify the search parameters for your query and then click search_button Search.

    Result: You see a list of changesets that match your criteria.

  9. To save the list of components that match the search as a CSV file:

    1. Click ExportCSV Save as CSV.
    2. To choose what time zone is used, on the Convert time confirmation screen, select one of the following:

      You see the date displayed in the header of the CSV as: All date/times are shown in {timezone} or UTC.

      UTC is a time zone standard used as a basis for all time zones worldwide. It is a constant time scale and does not change for Daylight Saving Time.

      • To use your local time, click Yes.
      • To use UTC time, click No.

      Result:

      If the list of changesets contains more than 200 records, only the first 200 are saved to the CSV file.

      • You see a file is downloaded to your computer using the following format:
        • InspireChangesets_DD-MM-YYYY-HH-MM-SS-MS
      • If you searched for a change, Inspire now saves only your search results to the CSV file.
      • If you filtered the list, Inspire now saves your filtered list to the CSV file.
      • If you sorted the list, Inspire now saves your sorted list to the CSV file.