Adding a site to an existing application

You can add a site to an application that you have already deployed.

To add a site to your application, you must export the application, add the new site, and then import the updated application. Every site must have its own site definition, and if you plan on filtering records for the new site, you must configure a site-based filter as well.

  1. Export the application to which you want to add a site.

    1. Navigate to the <app dir>\control\ directory on Windows (<app dir>/control/ directory on Unix).

    2. From the command line, export the application by entering the following command: runcommand.<bat|sh> IFCR exportApplication <destination>

    3. Navigate to the destination directory that you specified.

    4. Unzip the <app name><date&time>.zip file to an empty directory, for example: \myexports\discover.

  2. Add the default site ID, site node and site definition for you new site.

    1. Navigate to the pages node of your unzipped exported application, for example, \myexports\discover\pages.

    2. Open the _.json file in an editor and add a default site ID.

      For example: 

      {
    "defaultSiteId": "/DiscoverElectronics",
    "ecr:type": "page-root"
}

      This is the site that the Assembler uses when the request cannot be matched to any site using the URL patterns.

      Note

      All properties in JSON files must be in UTF-8 character format. Convert all Unicode characters to JSON encoded values.

    3. Navigate to the \myexports\discover\pages directory. Note that the application already has an existing site. For example, the Discover application has an existing site with DiscoverElectronics as the site_ID.

    4. Create a folder for your new site parallel to the existing site. The name that you provide for the folder becomes the site_ID, for example DiscoverCameras.

    5. Navigate to the existing site in your application, for example pages\DiscoverElectronics.

    6. Copy the site definition file, _.json, from the folder and paste it into your new site folder, for example pages\DiscoverCameras\_.json.

    7. Use a text editor to update the site definition with unique information appropriate for your new site. For example, the following new site has been updated with a unique URL pattern, display name, and description. 

      {
   "ecr:type": "site-home",
   "urlPattern" : "/DiscoverCameras",
   "displayName" : "Discover Cameras",
   "description" : "This site shows you all the Cameras available at Discover.",
}

    8. If you want the site to have its own unique icon to identify it in Experience Manager, you can replace the default site icon

      with one of your own by copying an image to the same directory as the site's JSON file.

      The image must be 16 by 16 pixels, and be named siteIcon.<extension>, for example pages\DiscoverCameras\siteIcon.png. The supported formats are JPG, JPEG, PNG, GIF, and TIF. Oracle recommends using the PNG format.

    9. Save and close the file.

  3. If you want your site to filter a subset of relevant records, you need to add a site-based filter to your site.

    1. Navigate to the new site directory pages/<new site_ID>, for example pages/DiscoverCameras.

    2. Create an XML file and name it filterState.xml. The following file filters records so that only those records in the cameras category can appear in the site. 

      <Item class="com.endeca.infront.navigation.model.FilterState" xmlns="http://ende¬
ca.com/schema/xavia/2010">
  <Property name="recordFilters">
    <List>
      <String>product.category:cameras</String>
    </List>
  </Property>
</Item>

    3. Save and close the file.

  4. A site needs at least one page in order to display so copy and paste pages that you want from your original site to your new site.

    For example, you could copy the browse folder from pages/DiscoverElectronics to pages/DiscoverCameras.

  5. Import the content with the new site information.

    1. Navigate to the <app dir>\control\ directory on Windows ( <app dir>/control/ directory on Unix).

    2. From the command line, import the updated content by entering the following command: runcommand.<bat/sh> IFCR importContent pages <path to source>.

      For example: 

      runcommand.bat IFCR importContent pages c:\myexports\Discover\config\import\pages

After you have added a site to your application, you must complete the following tasks:

Copyright © Legal Notices