Libraries are the starting points for collaboration in
some client applications, and contain documents and folders. You can
create a library by using the LibraryCreate tool.
About this task
Making a folder into a library adds information, such
as a default document type to use when a user adds a document to a
folder without specifying a document type. You can either map a library
to a new empty folder to create a new empty library, or map it to
an existing folder in the system. Unless your system already has existing
folders that can be used as libraries, you might want to create empty
libraries for various collaboration projects and teams.
When
the path model is created, the following libraries are created for
you:
- A repository root library
-
- The repository root library maps to the Content Manager EE hierarchical root folder
available in Content Manager EE Version
8.4.3 or later and mounts it as a library.
- The access is controlled by the access control list for the hierarchical
root folder by default. You can change the ACL on the library by using
the Browser tool to restrict user access.
- You can delete the library that maps the repository hierarchical
root.
- You can use the LibraryCreate tool to browse and mount the repository
hierarchical root folder or folders that are filed under it.
- The browse model path is the path that administrators see during
library configuration or mounting. Browse model path: /cmRoot/default
group/repository root
- CMIS path: /default
group/repository root
- A blank default library
-
- You can use the default library for your initial IBM® CMIS
for Content Manager configuration so that
you can get started without having to create more libraries.
- This library is a default choice for configuring IBM CMIS
for Content Manager.
- The default Document Type is CmisDocument.
- The browse model path is the path that administrators see during
library configuration or mounting. Browse model path: /cmRoot/default
group/default library
- CMIS path: /default
group/default library.
- Example
-
CMIS users
can configure their CMIS root
folder so that it hides all or part of these libraries. By default,
the cmpathservice.properties file is configured
as cmisRoot = /cmRoot. This configuration causes
the CMIS root
folder to point to /cmRoot. As a result, the
users see a subfolder of the root folder that is called default
group, and a subfolder of the default group folder
that is called default library.
CMIS users with a default
configuration can create documents in the /default group/default
library folder or its sub folders. You can also hide the
two folders by setting: cmisRoot = /cmRoot/default group/default
library. As a result, the CMIS folder is mapped
to /cmRoot/default group/default library path,
and users can create folders and documents directly without seeing
the default group/default library folder. If
you create other libraries, you can map them to the CMIS root in the same
way.
You can also map the CMIS root to Content Manager EE folders under libraries.
For example, to map a folder that is named MyCMISRoot to
the CMIS root
folder, specify: cmisRoot = /cmRoot/default group/default
library/MyCMISRoot. In this case, documents and folders
that are contained in the MyCMISRoot folder are
in the IBM CMIS
for Content Manager root
folder.
- The all item types library
-
- The all item types library is a special item type-based library
that ensures a path to every item in the system. The library allows
limited browsing by accessible item types. It is restricted to a subset
of items that can be browsed when the item types contain many items.
- When you add documents directly into an item type folder under
the all item types library, you can add documents only of the same
type as that item type folder. An item type folder cannot contain
documents of other types. However, if an application created an existing
folder for a particular item type, there are no type restrictions
on subfolders. The only restriction is that the item type folder itself
can only directly contain items (documents or folders) of that specific
item type.
- You cannot create folders directly in the item type folders through
some client applications.
- Default Document Type: Uses the type that is referenced by the
particular itemType folder that is traversed in the first level of
subfolders underneath the All Item Types library.
- Path: /ALLITEMTYPES_APP/ALLITEMTYPES_LIB,
if cmisRoot=/cmRoot, or /$type,
if cmisRoot is customized
- When you browse, the all item types library is hidden by default.
However, you can configure it by using the listAllItemTypesLibrary
configuration setting in cmpathservice.properties file.
In an interactive mode, the tool prompts you
for all required options. You can also run the tool in a silent mode
by specifying the options and values. You can use either the single
character or the full name of the option.
To display a list
of available options, enter java com.ibm.content.cm.tools.LibraryCreate
-? or java com.ibm.content.cm.tools.LibraryCreate
-help.
Example
The following code sample shows how to run the tool in
an interactive mode:
Operating system |
Code sample |
Linux and UNIX systems |
./configure-repository.sh LibraryCreate |
Windows |
configure-repository.bat LibraryCreate |
The following code sample shows how to run the tool in a silent mode. You must enter the command
in one
line.
java com.ibm.content.cm.tools.LibraryCreate -r calvin -u icmadmin -p Passw0rd
-o SCHEMA=ICMADMIN -g myLibGrp -l MyLib -t MyLib -d MyDesc -a PublicReadACL
-i CmisDocument -z true -b false -f /cmRoot/default group/repository root/
folder1/folder2