IBM Content Navigator, Version 2.0.3         

cmisRoot

Use this configuration setting to configure the folder that will be the CMIS (Content Management Interoperability Services) root folder for users and applications to start browsing the CMIS repository. You configure the CMIS root to mount and link directly any folder path by using the flexible library-based mounting mechanism. You can configure to map directly to:

You must use the flexible library-based mounting mechanism to mount almost anything that you want. You mount folders by creating a library which maps to a new folder, existing folder, or a search folder. The libraries are organized into library groups. The library groups and the libraries are displayed as the first two levels of special folders under the root and are read only. Users can create, modify, and delete folders and documents within libraries or folders within libraries. The library groups and the libraries are displayed or hidden from the users based on the access control list assigned to each library or library group. You can hide the groups by creating all libraries in one library group and then map the CMIS root directly to the single library group. Bypassing the library groups results in a single level of special folders only that is read only. Use the LibraryCreate tool to create libraries and the LibraryGroupCreate tool to create library groups. Use the Browser tool to browse or modify existing libraries and library groups.

If you want the CMIS root to map directly to a single folder, identify the folder in context of the flexible library-based mounting mechanism. You can obtain a path to any folder without creating a library. You do not have to create a library, but the only thing that you need is a path to a folder. You can search and find any existing folder in the system and identify a valid path. You can also find folders under the existing libraries and All Item Types library. Use the Browser tool to browse or search for an existing folder and identify its path in context to the library-based mounting mechanism.

Then, the next step is to configure the cmisRoot setting to link directly to any path in context of the flexible library-based mounting mechanism. The CMIS root becomes the folder that you specify and is linked directly to the path you specify. The actual path is hidden up to the underlying folder including the folder itself. You do not see the name of the folder in the path. The CMIS root returns the children of the folder you mapped.

You can link the mounting mechanism root containing library groups, a specific library group containing libraries, a specific library containing folders and documents, or any folder within a library. By default, CMIS root is mapped to the root of the flexible library-based mounting mechanism,/cmRoot. It is recommended to configure CMIS root to map to a single library group and create multiple libraries to mount as many folders or searches as needed that are displayed to users based on access control.

Important: Depending on your CMIS root mapping, users might have read-only access on the first one or two levels of folders if the folder levels belong to the library-based mounting mechanism. You cannot create additional documents and folders within the high-level folder mounting mechanism. You can create, modify, and delete documents and folders after you browse into a library. If you must have write access to the CMIS root contents directly, you can map CMIS root directly to a library or a folder in a library that allows you to create and delete documents and folders directly within the CMIS root.

Example of CMIS root mapping

For example, if you have libraries filed under /cmRoot/default group, such as, /cmRoot/default group/default library and /cmRoot/default group/myCustomLibrary, you can map cmisRoot=/cmRoot/default group.

Then, the CMIS root will link directly to defaultApp and return defaultLib and myCustomerLibrary as its children. The CMIS path for defaultLib in appears in CMIS as /defaultLib.

If you browse to find an existing folder under the default library at /cmRoot//default group/default library/folderA/folderB/folderC, you can map cmisRoot=/cmRoot//default group/default library/folderA/folderB.

The CMIS root will link directly to folderB and return child folderC with CMIS path /folderC.

If you search to find an existing folderB and identify its path as /cmRoot/ALLITEMTYPES_APP/ALLITEMTYPES_LIB/ClbFolder/folderB{1234_A123456789Av1}, you can mount cmisRoot as the path to folderB. Then, CMIS root will return any children of folderB.