-- Chimezie Thomas-Ogbuji Junior Consultant Fourthought Inc. (303) 583 9900 ext 104 cogbuji@fourthought.com XMLDocument beta is a collection of Zope products and python tools that integrate XML into Zope, above and beyond the current XMLDocument product. Like ZDOM, it is the result of a collaborative venture by Digital Creations and Fourthought Inc. ClobXmlDocument This is a Zope product that wraps XML content for use in Zope. In many ways it behaves similarly to the original XMLDocument, except it only creates a single Zope object upon import or creation. XMLImporter This python module allows users to externally import XML content into the Zope database in a 'controlled' manner. The user has full range of control over import parameters. XSLT Method This is a Zope product that wraps an XSLT stylesheet for use in Zope. Like a DTML method, it can be invoked on a ClobXmlDocument instance and return the resulting XSLT transformation. Fourthought provides custom technological solutions based on open technologies. 4Suite is a powerful set of Python tools developed by Fourthought for Web-based applications in areas such as Intranets, E-Commerce and knowledge-management. Elements of 4Suite have been adopted as core XML technologies in Zope and in the Python XML distribution links: Fourthought: http://fourthought.com 4Suite: http://fourthought.com/4Suite/ DOM 2 Spec: http://www.w3.org/TR/2000/CR-DOM-Level-2-20000307/ Zope http://www.zope.org contact: consultants@fourthought.com Installing XMLDocument beta --------------------------- This document describes installing XMLDocument beta on Unix. Important Notes XMLDocument requires 4DOM which is installed by the ZDOM installation. Simply installing ZDOM should resolve this dependency XMLDocument requires 4XPath and 4XSLT XMLDocument also requires Bison, Swig, and Flex. The RPMs for these can be downloaded at the corresponding locations Bison (ftp://rpmfind.net/linux/MandrakeCooker/cooker/Mandrake/RPMS/bison-1.28-4mdk.i586.rpm) Swig ftp://rpmfind.net/linux/MandrakeCooker/cooker/Mandrake/RPMS/swig-1.1p5-4mdk.i586.rpm Flex (might already be installed) ftp://rpmfind.net/linux/MandrakeCooker/cooker/Mandrake/RPMS/flex-2.5.4a-11mdk.i586.rpm Installing If necessary, install all the dependent packages (as well as Zope) Download this files from our FTP server (ftp.fourthought.com): /pub/4Suite/4Zope/XMLDocument/XMLDocument-beta.tgz /pub/4Suite/4Zope/XMLDocument/XMLImporter-beta.tgz /pub/4Suite/4Zope/XMLDocument/4Suite-Base-0.8.0beta1.tar.gz /pub/4Suite/4Zope/XMLDocument/4XPath-0.9.0beta2.tar.gz /pub/4Suite/4Zope/XMLDocument/4XSLT-0.9.0beta2.tar.gz Installing ClobXmLDocument and XSLTMethod: decompress XMLDocument-beta.tgz to a temporary directory like so: cd (some temporary directory) tar -xzf (location of downloaded file)/XMLDocument-beta.tgz run the stage.py script file. By default, it installs XMLDocument to /usr/local/src/Zope. If you have installed Zope in a different location you can specify this on the command line using the --dest option. For example, if you wanted to install XMLDocument to /home/Zope you would execute the stage.py script like so: stage.py --dest=/home/Zope Installing XMLImporter: decompress XMLImporter-beta.tgz to an arbitrary directory. make sure (Zope install directory)/lib/python is in your PYTHONPATH * read the python files in test_suite for examples on how to use XMLImporter Installing XPath, and XSlt: Simply untar the appropriate packages and follow the instructions in INSTALL Assuming you've satisfied the dependencies, you should be done! questions? email: consultants@fourthought.com RELEASE NOTES _______________________ XMLDocument beta supports the import and manipulation of XML files in Zope through the use of XSLT. See (XPath: http://www.w3.org/TR/1999/REC-xpath-19991116, and XSLT: http://www.w3.org/TR/1999/REC-xslt-19991116) XMLImporter is currently used as a python based tool to input XML files as Zope Objects. The mapping functionality and XSLT transform are used to manipulate the incomming XML stream into a set of Zope Objects. The transform is applied to the incoming XML to allow manipulation and compression of the incomming XML. See http://216.164.72.7:7780/Wiki/Members/jim/ZDOM/InitialNotes under the heading optimization. The final set of objects created by XMLImporter is defined by the mapping dictionary where keys are the tagNames to be created, and the values are references to python classes. A current limitation of the system is that Zope must not be running during an import. Clob XML Document is a Zope Object that represents a complete XML document. Interfaces are provided to edit the content of the document, and modify how the document is displayed when viewed. XSLTMethod is a Zope Object that applies an XSLT transform to an object. An XSLTMethod can be accessed as any other method of an object. With the ZDOM pakage installed, the XSLTMethod can be applied to any Object in the Zope application. Special processing is currently restricted to Clob XML Documents. When an XSLTMethod is applied to a Clob XML Document the contents of the document are used as a source, not the object itself. INSTALLATION --------------- Please see INSTALL.txt for Installation and package dependencies TODO ___________ 1. Allow XMLImporter to be called through the HTML interface 2. Allow Exporting of Zope Objects to XML (expand current export functionality) 3. Allow XSLT special processing on other objects (through _getDom interface) 4. Allow external parameters into XSLTMethod 5. Fix minor UI bugs in XSLTMethod (copy, cut, paste) 6. Fix processing error when applying XSLT to the Zope Application