CMISSpaces

From KnowledgeTree Document Management Made Simple

Jump to: navigation, search

CMISSpaces is an Adobe Air based client. For compatibility you will want Build 7 or Build 8. Earlier builds are not compatible with CMIS 0.61 and later builds may be built against newer versions of the specification.

As the specification is updated we will attempt to keep KnowledgeTree in sync with both the specification and at least one client (with CMISSpaces as our current first choice.)

Note: Adobe Air is required to run this client and CMISSpaces can be downloaded here: http://code.google.com/p/cmisspaces/

Currently supported functionality includes:

  • Browsing
  • Folder (Space) creation and deletion
  • Document creation and deletion

Document creation may use either the CMISSpaces internally created simple document types (File->Create Content) or by uploading an existing file.

Using the KnowledgeTree CMIS API with CMISSPaces

Once you have installed Adobe Air and CMISSpaces, open CMISSpacesConfig.xml in your installation directory and edit the cmisUrl property as follows: 

<!--  cmis service rest atom url of cmis repository -->
<property name="cmisUrl" value="http://localhost:80/webservice/atompub/cmis?servicedocument"/>
A content repository in CMISSpaces
replacing "localhost:80" with the appropriate hostname/ip address and port number for your KnowledgeTree installation.

By default CMISSpaces will fill in admin:admin as the username:password combination. For a default KnowledgeTree install this will be accepted. If you have changed the admin password or would like to log in as a different user, fill in the authentication data as needed.

After logging in you should be presented with a standard Explorer style view, a folder tree on the left and folders and documents on the right.

Important: Before creating a space/folder or document, you will need to browse the space/folder in which you intend to create content. Notice that until you do this the File menu options are grayed out, and the corresponding creation buttons are not active.

When wanting to add content to the root folder immediately after login, click on any object in the right hand view to indicate that the current folder is the one in which you wish to create content. CMISSpaces does not currently auto-select this space even though the contents are loaded on first login.

Known Issues

  • No Search actions are available
  • Limited Write actions are available. You may create content but you cannot update it (although you are now able to move content from one folder to another.)
  • While the In Development version of the KnowledgeTree CMIS API now has support for moving objects, none of the clients tested were able to perform the request due to apparent lack of functionality in the CMIS client applications.
  • Some Read actions are either not available or accept a limited set of the available options (optional function arguments are in general not yet implemented, e.g. filters and paging.)
  • If you are too quick to use one of the creation functions after selecting a new folder, the content may be placed in the previous folder selected. Always wait until the right hand pane content has reloaded with the newly selected folder content before creating, in order to avoid this issue. This ensures that the CMISSpaces client has updated the current folder.
  • When deleting/viewing folders or documents CMISSpaces requires the user to left click on the item and then right click to select the delete option. Simply right clicking on a folder or document not previously selected brings up the menu but the delete option does not appear to function. This appears to be a general issue with CMISSpaces not selecting items when right-clicking.
  • There appears to be no easy method of refreshing folder contents if they have been changed outside of CMISSpaces.
  • CMISSpaces does not appear to display error messages on failure of a function. This can be very confusing as you don't get any indication of what failed or why.
  • CMISSpaces does not currently support move functions within the repository. While the cut/paste operations appear in the menu, no command is issued on attempting to paste an item.
  • Attempting to upload a second file of the same name into the same space does work (KnowledgeTree will internally name the new file with a number in parentheses to distinguish it) - however CMISSpaces does not indicate that the upload was successful.

See Also

Retrieved from "http://wiki.knowledgetree.org/CMISSpaces"