With Gearset, you choose a metadata filter before running a comparison, which determines the metadata that's retrieved for the comparison results grid. You can choose from standard filters, or create a custom filter. In a custom filter, you can use regex. For a detailed guide on how to do this, see this separate support article.
However, there are some cases where you may want to filter the results after a comparison. You can use the global search in the top-right to filter by text, or use the filtering in the
Metadata type column to select a particular metadata type, for example. Sometimes, a fine-grained filter might be required, such as hiding some fields based on their name — which is something you can do using regex filters.
In this example, there's a custom object called
RegexExample that exists in the source and target. The source object has some fields that don't exist in the target. These fields are:
We're going to filter based on the names of the metadata items.
To start, click on the menu icon at the top of the
Filter results by text
If we want to include items based on text in the name, e.g. to only show items with
TEST included in their name, we can simply enter that in the box. (This filtering is not case sensitive, so typing in
test gives the same results.)
Now, only items with names including
TEST are included in the results:
Filter results by regex
Tick the box
Use regular expression to enable regex mode:
Note that ticking the box to enable regex mode makes the filter case-sensitive.
For example, if we only wanted to see items that did not include
TEST in their name, we could use the regex expression
^((?!TEST).)*$ to exclude:
Now, only fields with names not including
TEST are shown in the comparison results:
To use several filters together, combine them with the
| operator, e.g.
TEST|Quantity will match on either word: