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

Open the Local History Details panel from the Main Menu

  • the Solution Explorer: by right-clicking any item and selecting Show Local History Details in the context menu

Open the Local History Details panel from Solution Explorer

  • 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

Open the Local History Details panel from the Local History panel

  • right-click on the editor's tab and select the Show Local History Details option from the context menu

Open Local History Details from the editor's tab

Any of these actions opens a separate panel — the Local History Details panel. It is split into 2 parts: versions and changes.

The Local History Details panel

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.

The filter

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,
    • ​Starts with,​
    • ​Ends with,​
    • ​Contains,​
    • ​Does not contain,
    • ​Is contained in,
    • ​Is not contained in,
    • ​Is empty,
    • ​Is not empty,
    • ​Is less than,
    • ​Is less than or equal to,
    • ​Is greater than,​
    • ​Is greater than or equal to,​
    • ​Is null,
    • ​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 ​And​ / ​Or​.

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 filder with date


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.

Restore files

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.

Restore the file

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.

Show removed version

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.

Nothing to restore

In another case, you should confirm restore.

Restore confirmation

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:

Last modified: 2017/03/29 10:48

footer image