Changes between Version 4 and Version 5 of JoinedResourceController

Timestamp:

09/20/09 18:36:19 (16 years ago)

Author:

Fran Boon

Comment:

Options: s3.pdf, s3.xls & s3.filter

JoinedResourceController

@@ -59 +59 @@
 {{{
 def person():
-    crud.settings.delete_onvalidation=shn_pentity_ondelete
+    crud.settings.delete_onvalidation = shn_pentity_ondelete
     return shn_rest_controller(module, 'person', main='first_name', extra='last_name',
         pheader=shn_pr_pheader,
@@ -79 +79 @@
   * '''NOTE:''' Callbacks from CRUD settings (like in the example above) as well as onvalidation and onaccept callbacks are only invoked at requests on the main resource, but not at joined requests.
 
+There are some options which can be set before invoking the REST controller:
+{{{
+def kit():
+    "RESTlike CRUD controller"
+    s3.pdf = URL(r=request, f='kit_export_pdf')
+    s3.xls = URL(r=request, f='kit_export_xls')
+    if len(request.args) == 2:
+        crud.settings.update_next = URL(r=request, f='kit_item', args=request.args[1])
+    return shn_rest_controller(module, 'kit', main='code', onaccept=lambda form: kit_total(form))
+}}}
+
+The {{{s3.pdf}}} & {{{s3.xls}}} provide the {{{view/formats.html}}} with an alternate URL to provide a customised version of the PDF/XLS output available when clicking on the icon (s3.rss is also available).
+
+{{{
+def report_overdue():
+    "Report on Overdue Invoices - those unpaid 30 days after receipt"
+    response.title = T('Overdue Invoices')
+    overdue = datetime.date.today() - timedelta(days=30)
+    s3.filter = (db.fin_invoice.date_out==None) & (db.fin_invoice.date_in < overdue)
+    s3.crud_strings.fin_invoice.title_list = response.title
+    s3.crud_strings.fin_invoice.msg_list_empty = T('No Invoices currently overdue')
+    return shn_rest_controller(module, 'invoice', deletable=False, listadd=False)
+}}}
+
+The {{{s3.filter}}} provides a filter which is used in the list view to show the desired subset of records (note that the s3.crud_strings can also be customised). When done in the Controller like this, they are good for just this request)
 == Argument Lists ==