Local History Details
The Local History Details panel helps you to explore each change in your project: what and when was done, which files were affected by this change, differences between the versions. There are several ways to open this panel:
- the Main Menu:
View ⇒ Show Local History Details
- the Solution Explorer: by right-clicking any item and selecting Show Local History Details in the context menu
- the Local History panel: by clicking the Show Details button near the version that you want to explore, or double-clicking this version's name
- right-click on the editor's tab and select the Show Local History Details option from the context menu
Any of these actions opens a separate panel — the Local History Details panel. It is split into 2 parts: versions and changes.
The Versions that affected <file / folder / project name> section
In the left part of the Local History Details panel, you can find the list of versions that affect the selected item. This list is the same as it is in the Local History panel. The data is displayed in 2 columns: version's name, and the date of changes. By default, all data about versions are ordered chronologically. You can click on a column's header, and the data will be sorted in ascending or descending order. Both lists can be filtered, so you can find what you need faster and easier.
Clicking on the Filter icon in a column's header will open the filter window. Here you can specify the search parameters and quickly find the exact version that you need.
First of all, you should select the item that will be determined as a search scope. You can check only the items that you are interesting in, or you can check Select all. The next inputs help you to get a more precise search result:
- the drop-down lists with search conditions:
Is equal to,
Is not equal to,
Does not contain,
Is contained in,
Is not contained in,
Is not empty,
Is less than,
Is less than or equal to,
Is greater than,
Is greater than or equal to,
Is not null,
- a text input, where you can type a text for the condition above,
- the button Match case, which makes the search case-sensitive,
- a drop-down list with the logic operators
The buttons at the bottom of the Filter window help you to manage the search process. You will get the search result immediately after selecting the search scope and selecting the search parameters. If you want to close the Filter window, click the Filter button, or the
x button in the top right corner — the filter still will be active (and its icon will be highlighted). To cancel the filter, open this filter again by clicking the filter's icon and click the Clear filter button.
The Date column has the same filter, except one field — instead of a text input there is a date input, so you can type the exact date or choose it from the calendar.
The Changes in selected version section
In the right part of the Local History Details panel, you can find the list of changes in each version. The data is displayed in 4 columns:
- File — a name of the file that was changed. With the help of the context menu of each file you are able to compare this file with its current or previous version.
- Status — a type of a change:
Added(marked in green color) — the item was created,
Modified— the content of the item was changed,
Renamed— the item was renamed,
Moved— the item was moved,
Deleted(marked in red color) — the item was deleted,
- Path — the folder that includes this file,
- Action — an option to restore the file's version.
Each column, except the Action column, also has the same filter, and you can sort the data by clicking the column's header.
In the context menu of a file in the Changes section, you have the ability to compare the versions of the file: you can compare the selected version with the current one or with the previous one.
The Local History functionality gives you the ability to restore any file to any of its versions. In order to do this, follow the next steps:
- select the necessary version in the left part of the Local History Details panel. On the right side, you will see the list of files that were changed in this version,
- click the Restore button near the file that you want to restore, in the right part of the Local History Details panel.
However, there are some limitations for removed and moved files:
- if you restore a file that was moved through the project, you will get the changes from the previous in the content but not in the previous location,
- you're not able to restore the content for deleted files, but you can review the last version of this file from the context menu using the Show removed version option.
Process of restoring
Sometimes you need to roll back to one of the previous versions of the files: if you need to fix an issue, change parameters to the previous without typing them manually, and so on.
The current state of the file version will be changed locally to the selected version. If the selected version is equal to the current version, you will get a message that there is nothing to restore.
In another case, you should confirm restore.
NB: All the restored files are restored only locally. If you want to implement these changes to your Salesforce org, you need to build them.
In this section:
This also may be useful: