See release notes for changes (installation process simplified w/ release of 4DOM/4XSLT/4XPATH): -- Chimezie Thomas-Ogbuji 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. XmlDocument 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: 4Zope@fourthought.com Installing XMLDocument beta --------------------------- This document describes installing XMLDocument beta on Unix. Important Notes XMLDocument requires 4DOM which is covered by the ZDOM installation. Simply installing ZDOM should resolve this dependency XMLDocument also requires 4XPath and 4XSLT You can download the rpms from here: ftp://ftp.fourthought.com/pub/mirrors/python4linux/redhat/i386/4XPath-0.9.0-1.i386.rpm ftp://ftp.fourthought.com/pub/mirrors/python4linux/redhat/i386/4XSLT-0.9.0-1.i386.rpm Installing Download these files from our FTP server (ftp.fourthought.com): /pub/4Zope/XMLDocument/XMLDocument-beta.tgz /pub/4Zope/XMLDocument/XMLImporter-beta.tgz Installing XMLDocument and XSLTMethod: decompress XMLDocument-beta.tgz to your Zope directory Installing Demonstration: Import the testfolder.zexp file in $Zopeinstalldir$/Extensions. Point your browser to where you imported testfolder in the zope heirarchy and follow the directions. NOTE: The demonstration cyclicaly creates and destroys a ZDOM heirarchy in testfolder/, so if you stop it at mid point it may break if you try to restart it (if it's broken run the reset DTML Method: which simply removes folder1, folder2, and ZDOMtester) 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 Assuming you've satisfied the dependencies, you should be done! questions? email: 4Zope@fourthought.com RELEASE NOTES 5/30/2000 1) Solved __call__ problem, XSLTMethods can be invoked programatically 2) Added a default view for XMLDocuments that can return the XML as: syntax highlighted HTML raw XML plain text this can be specified by the output property 3) fixed the copy paste bug 4) added demonstration/example to package 5/16/2000 Moved ClobXMLDocument and XSLTMethod to seperate products changed ClobXMLDocument to XMLDocument _______________________ 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