• Screen Layout
  • Toolbar
  • Content Trees
  • Field Information
  • Task List
• Connections
  • Creating a Connection
    • Creating a Connection using Direct Connection
    • Creating a Connection using Packaged Connection
  • The Connection Manager
  • Editing a Connection
  • Deleting a Connection
  • Connection Information
• Comparing
  • Setting up for comparison
  • Comparing Items
  • Lightning Mode
  • Deep Compare
  • Searching for Items
  • Comparing Fields
  • The Field Value Editor
    • Text Field Editor
    • Multi-List Field Editor
    • Xml Field Editor
  • Controlling Comparison
  • Content Tree Context Menu
• History Engine
  • Opening the History View
  • The History View
  • Navigating to Item
  • Loading More History
  • Exporting history changes
• Tasks
  • Available Tasks
  • Copy All and Lightning Mode
  • Multi-Threaded copy
  • Removing Tasks
  • Reordering Tasks
  • Running Tasks
  • Exporting Tasks
• Logging
  • Log Console
  • Writing to a Log Folder
• Scripts
  • Sitecore Razl PowerShell Connections
  • Importing the script module
  • Running scripts in build pipelines
  • Operations
    • Copy-RazlItemsUsingHistory Operation
    • Copy-RazlItem Operation
    • Copy-RazlItemTree Operation
    • Copy-RazlItemVersion Operation
• Advanced Scripts
  • Getting Sitecore Item Information
    • Get-RazlChildItems
    • Get-RazlField
    • Get-RazlFieldBlob
    • Get-RazlItem
    • Get-RazlReferencedItems
    • Get-RazlReferredItems
  • Setting Sitecore Item Information
    • Set-RazlField
    • Set-RazlFieldBlob
    • Set-RazlItem
    • Set-RazlItemTemplate
  • Manipulating Sitecore Items
    • Move-RazlItem
    • Remove-RazlItem
  • Querying Sitecore using Razl
    • Get-RazlDeepCompareResults
    • Get-RazlHistory
    • Search-RazlItems
  • Manipulating ItemDetails
    • ItemDetails Object
    • FieldInfo Object
    • FieldInfoVersioned Object
    • FieldLanguageInfo Object
    • ItemProperties Object
    • New-RazlItem
    • New-RazlField
    • Remove-RazlField
  • Misc Sitecore Razl CmdLets
    • Clear-RazlCache
    • Get-RazlDatabaseNames
• Razl and Containers
  • Building the Razl Connector into docker-compose containers
• FAQ

Sitecore Razl

Using the History View

The history view allows you to review entries in the Sitecore history databases and then navigate to those items in the Content Tree. The Sitecore history database stores a record of items events, for example save, add version, delete and created.

The history engine used by Sitecore may not be turned on by default, if Sitecore Razl does not display any history items check your Sitecore configuration for the following in the database you are targeting:

  <Engines.HistoryEngine.Storage>
	<obj type="Sitecore.Data.$(database).$(database)HistoryStorage, Sitecore.Kernel">
	  <param connectionStringName="$(id)" />
	  <EntryLifeTime>30.00:00:00</EntryLifeTime>
	</obj>
  </Engines.HistoryEngine.Storage>

Also notice that the history engine specifies a lifetime to retain this data which by default is 30 days, Sitecore Razl won’t be able to display any information before this time.

Note: Starting with version 5, Razl supports using search indexes for the history view. The history based on search indexes is available for Sitecore 9 and later. For older versions of Sitecore, the history view continues to be based on the history table and the history engine.

Opening the History View

To open the history view follows these instructions:

1. Connect to a Sitecore instance
2. Click the history button next to the appropriate connection.

The History View

When you open the history view you will be presented with the following screen:

This history list appears above the Content Tree and displays the the date and time of the latest entry with the path to the item and the available move operations. Entries made on the same day are grouped under a day separator. To keep the list simple Sitecore Razl shows only the latest entry for an item if the item is different between the two Sitecore databases.

You may click on one of the operations in the history view to add the operation to the task list. Clicking on the task icon in the History Change Detail view is the same as clicking on the task icon in the compare window.

The performance of the History Change Detail window may be improved by selecting Lightning Mode. This works the same way as Lightning Mode when comparing items.

Navigating to an Item

To navigate to an item displayed in the history list double click on the desired item and Sitecore Razl will find the item in the Content Tree.

Loading More History

Sitecore Razl does not load the entire history database when you open the history view, instead this data is loaded as you scroll through the history list. When you approach the bottom of the loaded list of item Sitecore Razl will automatically try to retrieve more data.

If you scroll back to the top of the history list Sitecore Razl will try to load any new history entries or you can right click on the history list and click the Get Latest History option.

Exporting history changes

If you want a list of items in the history window, click the Download Results as a .CSV button in the toolbar. This will open a save dialog, allowing you to specify the location and name of the exporeted item list.

The export will contain the item path, compare state, item id, left and right server names and the change date.