In the upgraded UI of Compare and deploy feature, we've made it easy to pull a new version of specific metadata types and/or components in just a few clicks.
This can be accomplished via refreshing a specific metadata type or refreshing a single item in the comparison results.
βRefreshing specific metadata types
After running a comparison, it's common to make additional changes in your environment - but in many cases, it can be a bit redundant to re-run the entire comparison for metadata types that are not being modified.
β
With the option to refresh specific metadata types, you can maintain the results of your original comparison while only querying Salesforce for the metadata types that you would like to retrieve again.
To refresh a specific metadata type, simply navigate to the filter pane on the left side of the comparison results screen and select the refresh icon next to the metadata type that you would like to update.
There are two types of refreshes available - Quick refresh
and Full refresh
:
Quick refresh (recommended)
This option will only fetch recently changed metadata (by retrieving changes made since the last comparison), and uses cashed metadata for unchanged metadata to save time.
Full refresh
This option will fetch everything from your Salesforce org for the metadata type you're refreshing.
This option may be unnecessary if you can use Quick refresh
, as it can take longer to retrieve metadata. But it can be useful, for example in scenarios when Salesforce does not update its timestamps correctly.
Upon selecting the refresh icon, the metadata type in question will briefly become greyed out. This shows that Gearset is loading the new results from Salesforce.
β
Refreshing a single item in a comparison
When in a comparison, if you discover that one component is incorrect, and you want to update it, it can feel redundant to run a new comparison to grab the latest version of that one component.
With the refresh item option, you can update the component and refresh it from within your existing comparison without having to re-run the whole comparison.
To refresh a single item, right-click on a component and select the "Fetch latest
" option.
Below an example of how to fetch (retrieve) the latest changes for Account
Custom object:
If multiple components are selected and you right-click on one of them, this will show an option of "Fetch latest for selected items
".
Selecting this will refresh all the selected metadata components:
Once "Fetch latest for selected items
" option is selected, you'll see the spinning icon next to each of the items, as shown below.
β
Refreshing all selected metadata types
If you have already selected a group of metadata types from the filter and would like to refresh all of those selected types at once, you can do so by hovering over the All types in filter
button and clicking the Refresh all types
icon when it appears.