June 1999 - Zope - Zope lists

Z Classes Tutorial: Rough Draft
by Amos Latteier 10 Jun '99

10 Jun '99

Hello Zope Fans: Here's the first rough draft of a Z Classes Tutorial. Take a look and let me know what you think. Please note that Z Classes are an *experimental feature* of Zope at this time. We debated about whether to make a release now or wait until Z Classes were more fully cooked (and until we had more bandwidth to answer questions about Z Classes). We decided to make a release now. I think that if you play with Z Classes you'll agree that they represent a very exciting development. Have fun, and send me your feed back on the tutorial, I'd love to improve it. -Amos -- Introducing Z Classes About this document Z Classes are an exciting addition to Zope which made their debut in the 1.11 release. This document is an introduction to using and understanding Z Classes. This information will be added to the Zope Manager's Guide soon. Important Warning *IMPORTANT NOTE: Z Classes are currently (as of Zope 1.11.0pr1) an experimental, unsupported feature in Zope.* Bugs still exist in the current Z Classes implementation. In addition new features will probably be added and existing features may be changed in the near future. We fully intend to make Z Classes rock solid, but we're just not there yet. Introduction What are Z Classes? Z Classes herald a big change in Zope. Classes allow you to build your own objects through the web. In effect, instead of being limited to existing objects like Folders, DTML Documents, when building your site, you can now define your own objects. For example, if your site includes things like employee manuals, bug reports, shopping malls, etc., then you can actually create Employee Manual objects, and Bug Report objects, and all the rest. In short, Z Classes let you create and store "your kinds of things" instead of Zope things. You define your Classes in the Control Panel, and then you can create and manipulate your objects just as you create and manipulate Folders, DTML Documents, and all the other standard Zope objects. As you change and update your Classes, all the existing instances of those classes are updated. So if you add a new method to your Employee Manual class, all your Employee Manual objects will be updated. You can even export your Classes and use them in different Zope installation, thus allowing you to leverage your work across Zope installations. Basically Zope classes make extending Zope much easier. In fact there is no Python programming required. This is a big change from the days of using the Product API and Python to extend Zope. Now building new Classes is easy enough that you justify making several specialized Classes to solve specific problems. Necessary Background To start with you should be familiar with creating Products though the Zope Control Panel. This process is outlined in the Zope Manager's Guide. http://www.zope.org/Documentation/Guides/ZMG/ Working with Zope classes builds on Zopes existing Product Creation facilities but extends it in important ways. The basic difference between creating traditional Products through the Control Panel and creating Z Class Products through the Control Panel is that with Classes, your objects retain a connection to their Classes. So when you make changes to your Class, your instances are updated. With traditional Control Panel Products, no such link between the Control Panel and the created object is retained. Getting Started Overview Let's begin using ZClasses by building a simple example Class that represent a music CD. In this scenario, we want to let people fill out forms that collect information about CDs in their music collection. To create new "records", people just choose your newly-defined "thing" from the kinds of "things" to add to their folder. Overview of Steps 1. Create a Z Class. 2. Provide some meta-information about the Z Class. 3. Define a property sheet for the Z Class. 4. Create a View. 5. Create a Factory. Creating a Simple ZClass Start by going to the Control Panel and creating a new Product. Choose "Product" from the add form and call it 'CDProduct'. Now go the the 'CDProduct' Product Folder and create a ZClass. For the Class 'id' specify 'CDClass'. Don't worry about the 'Selected Base Classes' widget. Click 'Add', and you've just created your first ZClass. Now let's set up our newly minted CD Class. Click on the 'CDClass' object inside the 'CDProduct' Folder. Now you are presented the the 'Basic' Class management screen. For now let's restrict ourselves to just supplying a 'meta-type' for our class. For the Class 'meta-type' specify 'CD'. 'meta-type' basically means Zope Product type. Creating a PropertySheet Now let's give our Class some properties. We can do this by creating one or more PropertySheets for our Class. A PropertySheet is a schema that describes what kind of properties instances of our Class will have. To create a PropertySheet click on the 'PropertySheets' tab. This takes you to the PropertySheets management screen. Let's create a PropertySheet by selecting 'Common Instance Property Sheet' from the Product add list. Then specify 'cd_info' as the id of the PropertySheet. Now you should have a new PropertySheet object listed on the PropertySheets management screen. Click on 'cd_info' to edit our PropertySheet. Now you should see a familiar Zope property setting management screen. It's important to remember that right now we are not setting the properties of an individual CD, but we are defining what properties which all CDs will have. So let's create a few properties. Create a 'title' and 'artist' property, both of type string. Then create a text property named 'description'. Creating a View Now let's add a View to our class which will let use manage these properties. A View is a management screen which is available via a management tab. Click the 'Views' tab to edit a Class's views. Now you should see that our Class currently has only one View, 'Security'. This view calls the Class's 'manage_access' method. Let's create a new view named 'Properties' which calls the Class's 'propertysheets/cd_info/manage' method. Fill out the 'New' form and then click 'Add'. Now you should see that our class has two Views. Let's make the 'Properties' View the first or default view by checking the checkbox next to it and clicking 'First'. Now Properties should be at the top of the list of Views. Creating Instances of the ZClass So far so good. We've created all the basic stuff we need to get our class working. Now we need to create a way to make instances of our Class. This process is basically identical to what is described in the Zope Manager's Guide. We'll need to build an add form and then create a Factory which will make our add form available from the Product add list. Let's build a very basic add form. Go to the 'CDProduct' Folder and create a new DTML Method. Give it an id of 'addForm' and give it these contents::  <H2>Add CD</H2> <table> <form action="CDClass"> <tr> <th>Id</th> <td><input type="text" name="id"></td></tr> <tr><td></td><td><input type="submit" value="Add"></td></tr> </form> </table>  This DTML Method basically displays a form which gathers the CD's id and then calls the Class. The Class will create an instance and plug it into the Folder from which the add method is called. The final step is to create a Factory to put this add form into the Product add list. Choose 'Zope Factory' from the Product add list and create a Factory with id 'CDFactory', add list name 'CD' and method 'addForm'. OK, now you should be able to create a CD object from most anywhere in Zope, by selecting 'CD' from the Product add list and filling out the add form. Using ZClass Instances. To find out more about our Class, let's explore an instance. Leave the Control Panel and create a CD object. Now click on the CD object you just created. You'll note that you can edit the CD's properties with the 'Properties' tab. You can also access your object's attributes via DTML. For example, suppose you created a CD object called 'SuperOldies_vol42'. In a DTML Document you can query this object like so:: <p>Information about a CD:</p>  <p>Title: </p> <p>Artist: </p> <p>Description: </p>  In other words, your CD object is a normal Zope object and you can access its properties just like you access a Folder's properties. You can also manipulate its properties in the same way you manipulate the properties of other Zope objects. For example, here's a DTML fragment that changes some properties of our CD object::  Instances of ZClasses inherit all the methods of their base classes. In our simple example, our CD class inherits the basic methods available to all simple Zope Products automatically without having to specify this. More Complex ZClass Topics Now that we have a basic example of a working ZClass, let's return to some of the details that we glossed over the first time. Basic ZClass Attributes On the 'Basic' ZClass management screen you can set the Class's icon in addition to defining a ZClass's 'meta-type'. This icon is used in the Zope management interface to identify instances of the ZClass. You should use a GIF file for your icon which is 16 by 16 pixels. It should have a transparent background. You can set a Class's icon by uploading the icon file. This will create the icon and define the icon's URL. You can change the icon by uploading new icon files. If you need to, you can change the URL of the icon, but in general this shouldn't be necessary. ZClasses and Inheritance When you first create a ZClass you are presented with a complex widget which allows you to specify your Class's base classes. You ZClass inherits the methods and attributes of all its base classes. If you do not specify any base classes your class will still inherit basic Zope features which are defined by the 'SimpleItem' class. This is generally what you want, and this allows instances of your class to perform normal Zope functions such as properties management. If you want your Class to be able to contain other objects, like a Folder does, then you'll have to subclass 'Object Manager'. This will provide you with all the standard methods to support object containment. Other base classes may be available in the future. You can also subclass other ZClasses. This is a very powerful feature. It allows you to build complex and related classes. Another thing to notice is that you can subclass more than one base class. This is one way in which Python differs from many other object-oriented languages. When you subclass more than one class, the order of the base classes is important, because it determines the order in which classes are searched when acquiring method and attributes. Creating Methods A Class's heavy lifting is done by its methods. In addition to defining a property schema, your main task in crafting a ZClass will be to build a collection of methods which manipulate your Class's properties and do useful work. To create methods for your Class, you simply create objects in the 'Methods' tab management view. For the most part your methods will consist of DTML Method objects, SQL Method objects and External Method objects. These Zope objects will provide all instances of your Class with services just as they would provide services to their enclosing Folders if they were not defined as ZClass methods. In other words, there is nothing new or unusual about method objects--they are simply made available to Class instances through the ZClass rather than through acquisition. One useful method to create is the special 'index_html' method which is used to display an object when called from the web. Just as Folder's manage their default view with an 'index_html' object, so you can control the default representation of your class. For example our CD class might define a DTML Method 'index_html' like so::  <h2>CD</h2> <p>Title: </p> <p>Artist: </p> <p>Description: </p>  Creating Views We've already covered almost all there is to creating Views. The only thing to add is that by default your ZClass starts with the same views as its subclasses. Creating Permissions Zope manages security though a system of permissions and roles. Users are assigned roles which are in bound to permissions for given objects. See the Zope Managers Guide for more information about security. For our purposes, you should understand that a Class's permissions define collections of methods which are grouped together in functional groups. Using Classes your job is not to set access controls on your Class, but to define permissions so that access controls can be set on instances of your Class. So you must define to permissions before they can be bound to roles. The first step in defining your Class's permissions should be to to create methods for your class. After your class can do something, then you should decide how to describe what it can do in terms of permissions. You must figure out if your methods should be covered by existing permissions of whether it would be better to create new permissions. For example if your class has an 'index_html' method, this method is used to view instances of the class, so you can probably use the existing 'View' permission with this method. If your class defines a number of methods for accessing remote servers, you might want to create a new permission for these methods called something like 'Access remote server'. To control what permission a given method is bound to, click the 'Security' tab while managing the Class's permission. You will be presented with a form which maps the method's permissions to the Class's permissions. This looks complex but in general you will only want to bind one permission of the method to a permission. In the case of DTML Methods this will be the 'View' method. The reason for this is that you really only want instances of your class to be able to 'View' a DTML Method. An instance should not be able to perform other actions on its methods such as editing. By going to the 'Permissions' management tab you can define your Class's permissions. You can create new permissions with the 'Add a new permission' form, and you may delete existing permissions. In general you should limit the number of new permissions you create, to the smallest reasonable number. By doing so you make it easier for managers to control the security settings of instances of your Class. Subobjects If you create an a ZClass which is a subclass of 'Object Manager' you'll be able to control what types of objects it can contain. The task is performed by clicking the 'Subobjects' management tab. From this management screen you can select object types which can be added to instances of your Class as subobjects. If the 'Objects should appear in folder lists' option is checked then instances of the class will appear expandable in the Zope management interface. In general this option is appropriate when you wish to make your object act like a normal Zope container. Conclusion The information here should be enough to get you going with Z Classes. We hope to expand this documentation soon and include much larger examples to show how you can build systems with multiple Z Classes that work together. Have fun!

3 3

RE: [Zope] Squishdot and Portal Toolkit
by Michel Pelletier 10 Jun '99

10 Jun '99

> -----Original Message----- > From: Tom Deprez [mailto:Tom.Deprez@uz.kuleuven.ac.be] > Sent: Thursday, June 10, 1999 12:42 PM > To: zope(a)zope.org > Subject: [Zope] Squishdot and Portal Toolkit > > > Hi all, > > just looked at these two great products (squishdot and Portal > Toolkit). Is > it possible that these two overlap each other? Or is this > again something I > need to learn? I still have problems understanding all these > www terms and > definitions.... > No overlap, but very complimetary product. The portal toolkit deals with things like membership and cataloging, whereas squisdot is a discussion like system ala slashdot. One way in which the two product could work together better is if squishdot made sure all of it's objects get cataloged so as to be site wide searched. I suspect, but I don't know, that squidot uses the searching machinery of Confera, which is similar to what the catalog uses. I guess squishdot could be patched to use it's indexing machinery if a catalog is not present, and the catalog's if it is. -Michel > Great work! > > Tom. > > _______________________________________________ > Zope maillist - Zope(a)zope.org > http://www.zope.org/mailman/listinfo/zope > > (For developer-specific issues, use the companion list, > zope-dev(a)zope.org - http://www.zope.org/mailman/listinfo/zope-dev ) >

1 0

Squishdot and Portal Toolkit
by Tom Deprez 10 Jun '99

10 Jun '99

Hi all, just looked at these two great products (squishdot and Portal Toolkit). Is it possible that these two overlap each other? Or is this again something I need to learn? I still have problems understanding all these www terms and definitions.... Great work! Tom.

1 0

RE: [Zope] ever wanted to reverse the  tag?
by Martijn Pieters 10 Jun '99

10 Jun '99

>No kidding. I hope Marijn's patch made it into 2.0.0, can one of you >check the CVS and sniff it down? If it isn't, mail me and I'll put the >patch in myself. > >(to busy to check on it though, just point me ;) Wasn't done yet, but Brian checked it in about an hour ago. -- Martijn Pieters, Web Developer | Antraciet http://www.antraciet.nl | Tel: +31-35-7502100 Fax: +31-35-7502111 | mailto:mj@antraciet.nl http://www.antraciet.nl/~mj | PGP: http://wwwkeys.nl.pgp.net:11371/pks/lookup?op=get&search=0xA8A32149 ------------------------------------------

1 0

FYI: Zope Weekly News
by Amos Latteier 10 Jun '99

10 Jun '99

Hi, Probably the top news this week is the release of an alpha of mod_pcgi by Python big-wig Andrew Kuchling. His efforts will lead to much better Zope/Apache integration in the future. Lots of other folks continued to make other important contributions too. * Andrew Kuchling announced an alpha version of mod_pcgi to allow Apache to easily communicate with Zope via PCGI. ftp://starship.python.net/pub/crew/amk/new/mod_pcgi.tgz http://www.zope.org/pipermail/zope/1999-June/005083.html * Amos Latteier announced the availability of a Portal Toolkit Demo. The demo describes the forthcoming Portal Toolkit and includes animated GIFs to show it in action. http://www.zope.org/Products/PortalToolkit/Tour/ http://www.zope.org/pipermail/zope/1999-June/005008.html * Ross Lazarus announced an experimental Zope to static HTML external method. http://www.zope.org/pipermail/zope/1999-June/005060.html * A few people discussed "recursive acquisition" or using acquisition to create indirect paths to objects. This feature is confusing to some, but Anthony Baxter explained how he finds it incredibly useful. http://www.zope.org/pipermail/zope/1999-June/005156.html * Zope Documentation Project contributor, Tom Deprez, announced a "Zope Commercial", or site which describes how he uses Zope. http://www.master.cit.be/c8/default.html http://www.zope.org/pipermail/zope/1999-June/005131.html * Anthony Baxter announced an alpha of Zope Dataminer, which is an interesting looking system for dynamically constructing SQL queries via URLs. http://www.interlink.com.au/anthony/dmc-0.1.tgz http://www.zope.org/pipermail/zope/1999-June/005173.html * Alex Rice first asked about searchable Zope documentation, then solved the problem himself by setting up a Zope documentation search site. http://www.swcp.com/~alrice/zope/ http://www.zope.org/pipermail/zope/1999-June/005190.html * Rik Hoekstra announced the formation of a usergroup for Dutch speaking Zope users called "Zope in the low countries". http://www.zope.org/pipermail/zope/1999-June/005231.html http://sw.fsw.leidenuniv.nl/cgi-bin/WebSite.exe/zopegroep * A couple programming hints for preparing for Zope 2 were posted by DC folks this week. http://www.zope.org/pipermail/zope-dev/1999-June/000533.html http://www.zope.org/pipermail/zope-dev/1999-June/000530.html -Amos -- Amos Latteier mailto:amos@digicool.com Digital Creations http://www.digicool.com

5 5

RE: [Zope] Optional date properties (Zope 1.11)
by Alexander Staubo 10 Jun '99

10 Jun '99

Okay, admittedly that is so -- but I'd still like to pass a default value. Most date/time systems have a way of specifying a "zero" date value that be tested for equality. Right now what I'm doing is testing against "1900/01/01 00:00:00.0000 GMT+1", which feels a little stupid. -- Alexander Staubo http://www.mop.no/~alex/ "`Ford, you're turning into a penguin. Stop it.'" --Douglas Adams, _The Hitchhiker's Guide to the Galaxy_ >-----Original Message----- >From: Brian Lloyd [mailto:Brian@digicool.com] >Sent: 10. juni 1999 16:56 >To: 'Alexander Staubo'; Zope Mailing List (E-mail) >Subject: RE: [Zope] Optional date properties (Zope 1.11) > > >> I thought I could add an optional date property to my Z >> Class' property >> sheet, but no -- it seems Zope requires that you fill in a >valid date. >> Is there a workaround? >> >> Isn't this inconsistent with other properties' behaviour, though? >> Wouldn't it be logical that an empty date value as entered in Zope's >> management screens would represent "None" or at least a >generic "zero" >> date? >> >> -- >> Alexander Staubo > >I don't think that this is necessarily inconsistent - for example, >if you try to add an int, float, etc. with no value you get: > >exceptions.ValueError: >Empty entry when integer expected > >String and string-ish fields may _seem_ to act slightly >differently in that they accept an empty value, but this >is really not so different when you consider that '' is a >valid string (in the same way that 0 would be a valid, >but "empty" integer). > > >Brian Lloyd brian(a)digicool.com >Software Engineer 540.371.6909 >Digital Creations http://www.digicool.com >> >

1 0

RE: [Zope] Optional date properties (Zope 1.11)
by Michel Pelletier 10 Jun '99

10 Jun '99

> -----Original Message----- > From: Alexander Staubo [mailto:alex@mop.no] > Sent: Thursday, June 10, 1999 11:02 AM > To: Zope Mailing List (E-mail) > Subject: RE: [Zope] Optional date properties (Zope 1.11) > > > Okay, admittedly that is so -- but I'd still like to pass a default > value. Most date/time systems have a way of specifying a "zero" date > value that be tested for equality. Right now what I'm doing is testing > against "1900/01/01 00:00:00.0000 GMT+1", which feels a little stupid. > I beleive DateTime(0) (or ZopeTime(0)) gives you an effective 'lower bound'. -Michel > -- > Alexander Staubo http://www.mop.no/~alex/ > "`Ford, you're turning into a penguin. Stop it.'" > --Douglas Adams, _The Hitchhiker's Guide to the Galaxy_ > > >-----Original Message----- > >From: Brian Lloyd [mailto:Brian@digicool.com] > >Sent: 10. juni 1999 16:56 > >To: 'Alexander Staubo'; Zope Mailing List (E-mail) > >Subject: RE: [Zope] Optional date properties (Zope 1.11) > > > > > >> I thought I could add an optional date property to my Z > >> Class' property > >> sheet, but no -- it seems Zope requires that you fill in a > >valid date. > >> Is there a workaround? > >> > >> Isn't this inconsistent with other properties' behaviour, though? > >> Wouldn't it be logical that an empty date value as entered > in Zope's > >> management screens would represent "None" or at least a > >generic "zero" > >> date? > >> > >> -- > >> Alexander Staubo > > > >I don't think that this is necessarily inconsistent - for example, > >if you try to add an int, float, etc. with no value you get: > > > >exceptions.ValueError: > >Empty entry when integer expected > > > >String and string-ish fields may _seem_ to act slightly > >differently in that they accept an empty value, but this > >is really not so different when you consider that '' is a > >valid string (in the same way that 0 would be a valid, > >but "empty" integer). > > > > > >Brian Lloyd brian(a)digicool.com > >Software Engineer 540.371.6909 > >Digital Creations http://www.digicool.com > >> > > > > > _______________________________________________ > Zope maillist - Zope(a)zope.org > http://www.zope.org/mailman/listinfo/zope > > (For developer-specific issues, use the companion list, > zope-dev(a)zope.org - http://www.zope.org/mailman/listinfo/zope-dev ) >

1 0

RE: [Zope] Optional date properties (Zope 1.11)
by Brian Lloyd 10 Jun '99

10 Jun '99

> I thought I could add an optional date property to my Z > Class' property > sheet, but no -- it seems Zope requires that you fill in a valid date. > Is there a workaround? > > Isn't this inconsistent with other properties' behaviour, though? > Wouldn't it be logical that an empty date value as entered in Zope's > management screens would represent "None" or at least a generic "zero" > date? > > -- > Alexander Staubo I don't think that this is necessarily inconsistent - for example, if you try to add an int, float, etc. with no value you get: exceptions.ValueError: Empty entry when integer expected String and string-ish fields may _seem_ to act slightly differently in that they accept an empty value, but this is really not so different when you consider that '' is a valid string (in the same way that 0 would be a valid, but "empty" integer). Brian Lloyd brian(a)digicool.com Software Engineer 540.371.6909 Digital Creations http://www.digicool.com >

1 0

Re: That Gadfly adapter.... *grin*
by Aaron Watters 10 Jun '99

10 Jun '99

Sean McGerty wrote: > > Bugger. I've been using the following construct with ODBC SQL dbs for years... There's >also matching examples in the Gadfly documentation, but Gadfly through Zope doesn't >seem to like it: > > :select * > :from A, B > :where A.recNum = B.recNum > > And both recNum fields are of the same type. Simple you say? I thought so. Except it's >coming back as blank and if I change the = to a <> all rows and columns are returned - >including those which an eyeball search says have matching recNum values. Which makes >one wonder if I'm missing something significant. My guess is that your eyeballs are deceiving you. Gadfly ignores declared sql types -- so if one side is the int 12 and the other side is the string "12" gadfly will print them the same and insist that they are not equal. Similar for "12 " and "12". Jim Fulton: >The version of gadfly that is used in our Zope ZGadflyDA is woefully out of date. Yes, but I've never had a complaint like this about any version of gadfly (that was a gadfly bug, modulo the missing type inforcement which is arguably a bug). -- Aaron Watters http://www.chordate.com === Partying is such sweet sorrow. -- Shakespeare (corrected)

1 0

RE: [Zope] Long running process
by Michel Pelletier 10 Jun '99

10 Jun '99

> -----Original Message----- > From: Mikhail Terekhov [mailto:terekhov@emc.com] > Sent: Thursday, June 10, 1999 9:58 AM > To: zope(a)zope.org > Subject: [Zope] Long running process > > > Hi, > > Suppose I've created Zope product which has a method whith heavy > computations inside it. Is it possible to monitor execution of such > method? I.e. not to wait until it finishes, but display the current > status of computations. > Yes, but if your not using 2.0 with ZODB3, this this computation will block all other requests. -Michel > Regards > Mike > > _______________________________________________ > Zope maillist - Zope(a)zope.org > http://www.zope.org/mailman/listinfo/zope > > (For developer-specific issues, use the companion list, > zope-dev(a)zope.org - http://www.zope.org/mailman/listinfo/zope-dev ) >

1 0