Kentico CMS 7.0 Developer's Guide

Synchronizing the content

Synchronizing the content

Previous topic Next topic Mail us feedback on this topic!  

Synchronizing the content

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

All changes made to the documents and objects are tracked in the database, in the synchronization log. You can view the changes in CMS Desk –> Tools –> Staging.

 

 

InfoBox_Note

 

Please note

 

It is recommended that both the target and source sites have the same Code name prior to synchronizing content between them. You can change the value by going to Site manager and Editing (Edit) the site.

 

 

The interface for viewing changes and performing synchronization is divided into the following tabs:

 

All tasks tab

 

On the All tasks tab, you can see a list of all content staging tasks, i.e. all changes made to the system that can be synchronized on the target server.

 

Using the Server drop-down, you can choose the target server that you want to synchronize. By choosing (all), you perform synchronization for all available target servers. Then you can perform one of the following actions using the buttons at the bottom:

 

Synchronize selected - performs synchronization for all tasks selected by the check-boxes (Enabled) on the target server;

Synchronize all - performs synchronization for all listed tasks on the target server; in case you made any changes to content on the target server in the meantime, these changes will be overwritten

 

Delete selected - deletes all tasks selected by the check-boxes (Enabled) on the target server

Delete all - deletes all listed tasks on the target server

 

You can also perform the following actions separately with particular staging tasks:

 

View View - opens a new window with detailed information about the staging task

Synchronize Synchronize - performs the synchronization task on the target server

Delete Delete - deletes the synchronization task from the list

 

devguide_clip0438

 

Documents tab

 

In the screenshot below, you can see the Documents tab. By clicking the website root in the content tree on the left, you can view a list of all changes (synchronization tasks) made to all the documents of your website. By clicking a particular document, you can view only the changes made to it.

 

You can perform the same actions as on the All tasks tab, as described above.

 

You can also perform the following manual actions. These actions are manual because they are not related to the listed tasks and they can be performed even if there are no synchronization tasks logged:

 

Synchronize Run complete synchronization - performs complete synchronization of all documents in the content tree

Synchronize Synchronize current document - synchronizes the currently selected document

SynchronizeSubTree Synchronize current sub-tree - synchronizes all documents in the selected sub-tree

 

The following types of tasks are logged for documents. You can see the type in the Task type column:

CREATEDOC - document was created

UPDATEDOC - document was modified

DELETEDOC - document was deleted

DELETEALLCULTURES - all cultural versions of the document were deleted

PUBLISHDOC - document was published

ARCHIVEDOC - document was archived

REJECTDOC - document was rejected

MOVEDOC - document was moved to another location in the content tree

 

devguide_clip0439

 

Data tab

 

In the screenshot below, you can see the Data tab. This is where changes made to data in custom tables are logged.

 

You can perform the same actions as on the All tasks tab, as described above.

 

You can also perform the following manual actions. These actions are manual because they are not related to the listed tasks and they can be performed even if there are no synchronization tasks logged:

 

Synchronize Run complete synchronization - performs complete synchronization of all data in all custom tables

SynchronizeSubTree Synchronize current sub-tree - synchronizes all data in the selected custom table

 

The following types of tasks are logged for custom tables data. You can see the type in the Task type column:

 

CREATEOBJ - new item was added to a table

UPDATEOBJ - an item in a table was updated

DELETEOBJ - an item in a table was deleted

 

Please note: Staging tasks for custom table items are logged based on their ItemGUID columns. Changes made to items that do not have this column (typically custom tables imported from older versions of Kentico CMS) are not logged. You can edit custom tables in CMS Desk -> Tools -> Custom tables. You will see a warning message with a link letting you generate the GUIDs for the respective tables.

 

devguide_clip0440

 

Objects tab

 

In the following screenshot, you can see the Objects tab. This is where changes made to objects are logged.

 

The main categories are website and Global objects. The first category contains object changes connected to the current website, whilst the second one contains object changes for global objects.

 

You can perform the same actions as on the All tasks tab, as described above.

 

When you select a particular object category, you get also the following manual action offered. This action is manual because it is not related to the listed tasks and can be performed even if there are no synchronization tasks logged:

 

SynchronizeSubTree Synchronize current sub-tree - synchronizes all objects in the selected category

 

The following types of tasks are logged for objects. You can see the type in the Task type column:

 

CREATEOBJ - new object was created

UPDATEOBJ - object was modified

DELETEOBJ - object was deleted

ADDTOSITE - object was assigned to a site; applicable only to site-related objects

REMOVEFROMSITE - object was removed from a site; applicable only to site-related objects

 

The following types of tasks are logged for folders in media libraries:

 

CREATEFOLDER - folder was created

RENAMEFOLDER - folder was renamed

COPYFOLDER - folder was copied

MOVEFOLDER - folder was moved

DELETEFOLDER - folder was deleted

 

 

devguide_clip2120

 

Please note

 

Global metadata changes such as changes to document types, custom tables and system tables produce staging tasks for all staging servers of all sites. In such case, it is recommended to synchronize such changes to all servers of all sites at the same time to prevent overwriting of such metadata and losing the data by synchronizing the older tasks later.

 

You can use the <add key="CMSStagingTreatServerNamesAsInstances" value="true" /> key to make sure that once the global task is synchronized, it is deleted from all other servers with the same name to prevent such possibility. The default value is false since staging can use multiple target instances targeted with the same names.

 

 

devguide_clip0441