Configure the layers for your deployment

You configure the layers for your multi-level libraries by editing the library-layers.xml configuration file.

In the initial configuration, a single layer is available ("library default layer" with the id "1") , as shown below:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE library PUBLIC "-//ixiasoft.com//cms//config//libraryLayers" "librarylayers.dtd">
<!-- ============================================================================================= --> 
<!-- --> 
<!-- FILE: librarylayers.xml --> 
<!-- --> 
<!-- DESCRIPTION: This file defines the available library layers within the docbase. --> 
<!-- Note that layer ID 0 is the Product layer and cannot be modified. Library layer IDs start at 1.--> 
<!-- --> 
<!-- ============================================================================================= --> 
<!-- REVISION HISTORY: -->
<!-- --> 
<!-- ============================================================================================= --> 
<library>
    <layer id="1" name="library" description="library default layer" isDefault="yes"/>
</library>
To configure layers, you create one <layer> element per layer. A layer has the following attributes:
Table 1. Attributes of the layer element
Attribute Description
id Level of the library layer. Library layers start at 1, the highest level. You can add as many layers as necessary. A library or product can reference content from a library that is at the same level (sibling library) or lower (child library).

The level must be unique within the library-layers.xml configuration file.

name Name of the library layer. This name is used in the DRM dialogs to identify the layer. Make sure to enter a descriptive name.
description Description of the library layer.
isDefault Specifies whether this layer is the default layer. Only one layer can be set as the default (isDefault="yes"). The default layer is used for backward compatibility. When an existing library version is released, if it does not have a layer level associated to it, it will be assigned this default layer.

You can add other layers, as appropriate for your deployment. Remember that creating multiple layers will increase the complexity of the IXIASOFT Dynamic Release Management.

Note: Please contact your IXIASOFT DITA specialist before implementing multi-level libraries in your deployment, as they increase the complexity of the IXIASOFT CCMS. Multi-level libraries must be planned carefully.
Note: You should make these configuration changes in the Test environment and test them before copying them to the Production environment. In a dedicated SaaS deployment, after testing the changes, ask IXIASOFT Customer Support to copy the changes to the Production environment.
  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the library-layers.xml file in the repository's /system/conf collection.
  3. Check out the file and open it for editing.
  4. For each layer to add, add the following <layer> element:
     <layer id="<layer_level>" name="<layer_name>" description="<layer_description>" isDefault="yes|no"/>
    For example:
     <layer id="2" name="Layer 2" description="Second library layer" isDefault="yes"/>
    The following example shows the configuration for the library layers:
    <library>
        <layer id="3" name="Product Library Level" description="Product Library Level" isDefault="yes"/>
        <layer id="6" name="Third Party Library" description="Third Party Library" isDefault="no"/>
        <layer id="9" name="Operating System Library" description="Operating System Library" isDefault="no"/>
    </library>
  5. Save, close, and check in the file.
  6. Inform users of the changes.
    The changes will be applied automatically once users close and then reopen their CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIASOFT CCMS > Synchronize Configuration. Additionally, have an administrator refresh IXIASOFT CCMS Web so that users will see the change reflected there.