1. 2. Configure SitecoreAI instance

Export the site structure

The xmc-structure.json file defines the structure of your target SitecoreAI environment. You generate this file using the CMSExportStructure-x.x.x.zip package and then upload it to the SitecoreAI Pathway app.

Note

You can download this package from the 2 Configure SitecoreAI instance page by clicking info.png Read instructions in the Upload target SitecoreAI structure section.

To export the site structure:

  1. From the source environment, download the following:

    • Component templates
    • Page templates
    • Rendering items
    • Site presentation folder
  2. Extract all the .zip files, including the package.zip files inside the downloaded packages.

  3. In the CMSExport structure folder, create the following subfolders with this exact naming:

    • Components - for the component data source templates.
    • Pages - for the page templates.
    • Renderings - for the rendering items.
    • Presentation - for the presentation folder.
  4. Copy the downloaded packages into the target destination as follows:

    Package/FolderDestination folder
    Component Data Source template itemComponents
    Page TemplatesPagesFollow a flat hierarchy of page templates. No folder structures permitted. All page templates must be in the root of the Pages folder. This means that the xmc-structure.json file must be organized as follows
    templates belong in the "Pages" section.Rendering components associated with a datasource template belong in the "Renderings" section.Page designs mapped to specific pages belong in "PageDesignMappings" section, andThe complete list of page designs, including their partial designs, belongs in the "PageDesigns" section.Templates that are in nested folders in the source need to be added separately.
    PresentationPresentation
    Project folder from the Rendering item download. If you have additional rendering item locations, for example the Feature or Foundation folders, these need to be copied into the Renderings folder as well.Renderings
  5. In the terminal, navigate to the Export-Structure.ps1 file and run the export structure script with Admin permissions.

    pwsh -NoProfile -ExecutionPolicy Bypass -File .\\export-structure.ps1
    
  6. Verify that the xmc-structure.json file was created and is not empty and, if correct, upload it to the SitecoreAI Pathways app.

If you have suggestions for improving this article, let us know!