Overriding field defaults dynamically¶
PloneFormGen allows you to supply dynamic field defaults by specifying a TALES expression in the Default Expression field of the overrides fieldset (sub-form). This how-to explains what that means, and offers a few examples.
Creating a dynamic field default means to have a form field's initial value change with context. We might, for example, wish to use a member's e-mail address, which would vary with the user. Or, we might be looking up some data via a catalog or RDBMS query, and wish to supply that to the user for correction.
Template Attribute Language Expression Syntax (TALES) is a simple notation that allows determination of a value via path (as in path/to/object), string or Python expressions. It is used in Zope's Template Attribute Language (TAL), and is ubiquitous in Plone templates. This how-to does not teach you TALES; for that, try the Zope Page Templates Reference.
Please note that it's easy to make a mistake when working with TALES fields that will cause an error when you try to display your form. Stay calm! Take note of the error message, and return to the field edit form to fix it. Don't be scared of this kind of error.
A quick example¶
Let's say you wish to put the member's id in a string field default. You may do that with the TALES expression:
This is a path expression. "id" is found in the "member" object and returned.
There's a gotcha here. What if the form is viewed by an anonymous visitor? They'll receive an error message. We can avoid that with the expression:
member/id | nothing
The vertical bar (|) marks alternate expression that is used if the left-hand expression is empty or can't be evaluated. Here we're saying to show nothing if member/id can't be evaluated. Using Python
You may also use Python expressions:
python: 5 + 3
would supply a value of 8. This is trivial, but what about:
python: DateTime() + 7
This would supply the current date/time plus seven days.
The name space¶
Here are the objects available when your expression is evaluated.
- The current object. A bit dangerous since this varies depending on context.
- This will be your form folder.
- The portal object.
- The REQUEST object. Note that request/form contains form input.
- The authenticated user's member data -- if any.
- Equivalent to Python None.
- URL of the form folder.
- URL of the site.
- Module importer.
Some of these identifiers are supplied by PloneFormGen and are not available in other contexts.
When you compose your TALES expression, keep in mind that it will need to return different types of data for different types of fields. For simple field defaults, return a string value; for the lines field, return a list or tuple.
Calling a Python script¶
You'll be frustrated fast if you try to do anything smart in a single TALES expression. If you need to do something more complicated, add a Python Script to your form folder and call it via TALES. For example, if you added a script with the id getEmail, you could call it with the expression:
Make sure your script returns the value you wish to use as a field default, in the appropriate format. Setting Many Defaults With One Script
If you need to dynamically set several fields, you may do it with one script. Call the script by specifying it in the Form Setup Script field of the form folder's overrides fieldset.
Set the form fields by putting them in the request/form dictionary. Make sure you don't overwrite anything that's already in the dictionary, as that is probably previously submitted input.
For example, we could create a Python Script (using the ZMI) in the form folder:
request = container.REQUEST request.form.setdefault('topic', 'value from python script')
If the script id was setTopicDefault, we'd call it by putting:
in the Form Setup Script field of the form folder's overrides fieldset.