Home CMS Documentation Home CMS 10 Custom Plug-in Applications Site Migrator Expanding Site Packages

Expanding Site Packages

You can import (unpack) a packaged branch of a site to a selected site node. The imported branch expands as children under the node.

Version Notes: CMS 10.5

Users can pack and import asset folders in CMS 10.5. Packages can include pages, assets, or both.

To expand a site package:

Navigate to Apps > Site Migrator > Unpack.
Select the package to expand in the Select a package... drop-down list.
The Select a package... icons display.
Additional Information
Select a package... icons provide options to view package content, download the package, or delete the package. Icons include:
View Package Site Tree: dialog displays with selected package's site tree.
View Package Assets: dialog displays with selected package's asset file names and paths.
Download Package: Icon downloads a zip file of the selected package to your local system.
Delete Package: Delete window displays. Click OK to delete the selected package, permanently.
Click Map Schemas. The Map Schemas for Package dialog displays.
Version Notes: CMS 10.2+
The Map Asset Schemas link displays as an Unpack option if the Site Migrator package originates from a CMS 10.1+ site that includes content that referenced an asset. Similar to the Map Schemas link, this allows you to map asset schema fields to the asset schema fields that are being unpacked.
Map Target Site Schemas (right column) with each page type within Package Schemas (left column).
The Map Schemas for Package dialog contains the following controls:
- Manual Mapping:
  1. Drag the target site schema from the right column to the appropriate package schema in the left column. The schema opens.
  2. Map the schema's fields in the same way you mapped the schema.
  3. When you are finished, click Save and Close.
- Assisted Mapping:
  1. Click Map Same Names. The system will attempt to assign target site schemas with package schemas, based on matching names.
    Troubleshooting
    For assisted mapping to function, the source and target schema names must be identical. If these schema names do not match, you must map them manually.
    Troubleshooting
    If you have applied assisted mapping and find that auto-matching has not filled in a particular field, the source and target schema elements may not have the same Name and Type values. Inspect the schema of the packaged source to ensure that the Type value is valid.
  2. Click Save and Close when finished.
In the Pick the Parent Page... field, enter the page that will become the parent of the package when it expands on the target site.
Version Notes: CMS 10.5
Site Migrator requires a parent page for all package types (i.e., page-only packages, page and asset packages, and asset-only packages).
While the selected page becomes the parent of the unpacked pages, Site Migrator automatically unpacks assets to their original path(s) in the Assets Manager. If an existing asset uses the same path as an unpacked asset, the system auto-appends a number to the end of the unpacked asset name.
Enable any of the following options for package expansion to suit your needs:
- Apply page categorization with matching category IDs: When enabled, the categorizations within the packaged schemas will be applied to the target site if there are matching category IDs.
- Create categories from package: When enabled, the packaged taxonomy tree is used to create categories for packaged pages.
- Apply structured URLs: When structured URLs are enabled, page names-not xIDs-display in URLs.
- Keep original IDs: When enabled, the package maintains the original xIDs of the pages in the expanded package.
  Note
  If any xID in the package already exists in the site where the package will be expanded, this feature doesn't work.
  Note
  After using this feature, new pages in the site must begin at an xID higher than any xID in the package. For example, consider a site whose highest page is x567. After expanding a package where the highest xID is x1000, with Keep original IDs enabled, the next page, component, or folder created in the site will have the xID of x1001.
- Apply Lingual Maps: When enabled, includes language mapping resources.
- Use existing assets with same path: When enabled, if an asset path exists, the CMS uses the existing ID to update references on imported pages. If unchecked and a path conflict exists, assets are imported with an appended number value.
Click Unpack.