Importing steps

Step 1

•

Import packages - from the list, choose a package that you want to import; packages need to be in <web project>\CMSSiteUtils\Import in order to be displayed in this list; if you want to add an import package to the folder, do it and click the Refresh (

) link - the new package will be displayed in the list

•	Preselect all items - if selected, all items in the package will be preselected in the next step.

•	Preselect only new items - if selected, only items that are not already in the database will be preselected.

Proceed to the next step by clicking the Next button.

The following steps differ for site, set of objects and single object import. When importing a site-related single object, Step 2 will let you choose the target site form the existing sites. When importing a set of objects, Step 2 will be skipped and Step 3 will be displayed directly.

Step 2

•	Import a new site - if selected, a new site will be created based on the content of the import package.

•	Site display name - enter the display name of the new site.

•	Site code name - enter the code name of the new site.

•	Domain name - enter the domain name of the new site.

•	Import objects into an existing site - if selected, the site selected below will be updated with the contents of the import package.

•	Select site - select a site that you want to update with the contents of the import package.

Step 3

In Step 3, you can select which of the objects from the exported package are to be imported and which are not. You can make this selection by choosing one of the categories displayed in the tree view on the left side of the screen. Only categories of objects found in the import package will be displayed. By selecting a category, a set of check boxes appears in the right part of the screen, letting you select which objects are to be exported and which are not. Objects that already exist in the database are marked with *. If you leave such object's check-box checked, this existing object will be overwritten with the newly imported one.

Global selection

•	Load default selection - if clicked, object preselection will be done based on choice in Step 1.

•	Select all objects - if clicked, all objects will be preselected.

•	Select only new objects - if clicked, only objects not existing in the database will be preselected.

•	Deselect all objects - if clicked, all objects will be deselected.

Import settings

•	Update site definition - displayed only when importing to an existing site; if enabled, all settings stored as a part of the site object will be updated with those contained in the package; these settings are contained in the Site\cms_site.xml file inside the export package

•	Assign all objects to the imported site (recommended) - if checked, all imported site-related objects will be assigned to the imported site

•	Run the site after import - if checked, the imported site will be run after the import process finishes

•	Delete incomplete site when import fails - if checked, incompletely imported site will be deleted when the import process fails

•	Import files (recommended) - some objects in the database are linked with physical files in the file system; if you check this check-box, such files contained in the package will be imported too

•	Overwrite system queries - if checked, system queries will be overwritten by those contained in the package

•	Do not import objects where parent object is missing - if checked, child objects whose parent objects are not found will be skipped and the import process will continue

•	Import tasks (recommend) - if checked, delete tasks (incremental deployment) included in the package will be performed

Overwrite system queries

This option is displayed only when importing from version older than the current one; if checked, all queries from the package will be imported and will overwrite the current ones; if the package contains your own custom queries that you added to the system, it is necessary to have this option enabled.

The first three options under 'Import settings' will be offered only when importing a whole site. When importing objects, only the Import files option will be offered.

Step 4

In Step 4, an import log will be displayed, showing the progress of importing. You can abort importing by clicking the Cancel button any time. When the import successfully finishes, click the Finish button to return to Site manager -> Sites.

Application restart

At the end of the import process, you may get the following error message:

"Application has been restarted and the logging of the import process has been terminated. Please see context help in this section for more details and how to solve this issue."

If so, you will have to finish the import process manually:

1.	Open the imported package and extract the following folders located in <package>\Data\Files (if they are present):

- cms_webpart

- cms_cssstylesheet

- cms_documenttype

- cms_formusercontrol

- cms_inlinecontrol

- cms_pagetemplate

- Global

Also extract the <package>\Data\Site folder.

2.	These folders contain subfolders named identically to the folders inside your web project root. Remove the '.export' extensions from the included files and copy them manually to the appropriate location inside your web project folder with respect to the original folder structure.

3.	Under the Site folder, the ##SITENAME## folder may be found in the folder structure. If so, please rename this folder to the name of the imported website and copy the content of the Site folder to the root of the web.

Page url: http://devnet.kentico.com/docs/5_5r2/contexthelp/index.html?site_import.htm