Hi Rajath, On Wed, May 01, 2013 at 09:04:55PM +0530, Rajath Shashidhara wrote: > Hi Ariel, > > Thanks. > > As far as I have understood: > A CMIS is a repository to store files and folders. > I have to make a UCP which integrates into the existing UCB that provides > editing access to files stored in the the CMIS repository by implementing > XContentProvider interface.
Not only editing access, but access in general, as the content might be read-only. > The things that I have to take care is the connection to the cmis > repository, permissions to access files, querying content from the files, > browsing through the repository to display the file hierarchy, etc. The last one is not your responsibility. The UCB will query your UCP for content X, using Apache Chemistry you will retrieve information about content X (the mime, if it is a folder or a file, etc.), and then the UCB will execute commands on the content. Browsing the repository will happen in the file picker (menu File - Open), this will end up calling your UCP to provide UCB-contents and execute commands on it (if the UCB-content is a folder, the UCB-content will be asked to list its contents; etc.). > I browsed through some of the devguides of Apache Chemistry. The code was > not too complex. I was able to follow the code - I could find the functions > required to implement the above functions i the example code. Yes, Apache Chemistry comes with clear examples, that show most of what you will need to use. The hard part to understand is OpenOffice API ;) > But one thing I have not understood is: > A cmis repository can contains documents/folders/relationships/policies. Yes, you will represent the CMIS repository as a root folder with a set of documents and folders, something like the FTP-content provider in the diagram from http://wiki.openoffice.org/wiki/Documentation/DevGuide/UCB/Universal_Content_Broker > But there is no mention about the kind/format of document for which the > support is required. The UCP is the lowest level, that means you know nothing about if a CMIS content can be "handled" by OpenOffice, that is, if OpenOffice can open it and display its contents to the user, this depends on a filter being available, but the UCP knows nothing about filters: you simply provide contents and execute commands on them. Answering your doubt above, you will have to support handling everything in the CMIS repository that can be represented as a folder or a file/document. > Is it something like a openoffice format document is residing in the > repository and I have to connect the already existing editing tools of > openoffice to that file? No, it is something at a lower level: if a CMIS content represents a file/document and the user is trying to open it, the UCB will execute an "open" command on the CMIS-content; for you, this means only to provide the document's content as an stream, but you don't know if OpenOffice can handle it, this isn't your responsibility. > Do I have to deal with MIME Type of files to identify openoffice supported > files? The MIME type will be one of the properties you have to provide about a content. But you don't make any assumption about what OpenOffice will do with it, you simply don't care ;) The list of properties and commands an UCB-content should support are listed at http://www.openoffice.org/api/docs/common/ref/com/sun/star/ucb/Content.html In trunk this documentation looks a little better: http://svn.apache.org/viewvc/openoffice/trunk/main/offapi/com/sun/star/ucb/Content.idl?revision=1460358&view=markup#72 Though the trunk sdk does not work, you can get it only to read the docs. > I think I'm short of information and understanding to write a good > application. The UCB API is rather "complex". You may get a general understanding of how it works by playing with some AOO Basic code: http://people.apache.org/~arielch/api/UCB_demo.odt this code uses the WebDav UCP, you need a Developer Snapshot from a recent trunk, because it does not work on 3.4.1; but you can change the URLs and make them point to files on the local file system: the code is the same for all UCB contents. Regards -- Ariel Constenla-Haile La Plata, Argentina
pgpy4ep5sjicG.pgp
Description: PGP signature
