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 DRM.

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.

To configure the layers for your multi-level libraries:

  1. Open the TEXTML Administration perspective by clicking the TEXTML Administration shortcut on the tool bar. If the shortcut is not displayed, follow these steps:
    1. Select Window > Open Perspective > Other
    2. Click TEXTML Administration.
    3. Click OK.
  2. In the TEXTML Administration view, double-click the server. If your server is not displayed in the view, you must add it to the view.
  3. When the Connect as dialog opens, type your username and password and click OK.
  4. Double-click the name of your docbase to open a connection to the Content Store.
  5. Locate the library-layers.xml file in the repository's /system/conf collection.
  6. Right-click the file and select Check Out.
  7. Double-click library-layers.xml to open it in a text editor.
  8. 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>
  9. Save, close, and check in the library-layers.xml file.
  10. Inform users of the changes.
    The changes will be applied automatically once users close and then reopen their . Users can also apply the changes without restarting their IXIASOFT CCMS Desktop by clicking DITA CMS > Synchronize Configuration.