Changes between Initial Version and Version 1 of HowTos/HowToUseScaffolds/BroadcastsResultsandViewsinScaffolds

Timestamp:

04/15/09 19:43:29 (17 years ago)

Author:

trac (IP: 127.0.0.1)

Comment:

--

HowTos/HowToUseScaffolds/BroadcastsResultsandViewsinScaffolds

@@ +1 @@
+= Using Broadcasts, Results and Views in Scaffolds =
+
+As we've seen in "How To Add A Scaffold," a single scaffold tag simply serves to define multiple event handlers. In order to keep the Model-Glue XML format easy to learn, the scaffold tag supports the same child tags (broadcasts, views, and results) as an event handler tag.
+
+Any broadcasts, views, or results tags added beneath a scaffold tag are applied to all event handlers a given scaffold creates. (To learn more about creating broadcasts, views, and results see the Quickstart guide).
+
+This allows us to extend the functionality of scaffolds in powerful ways.
+
+For example, to apply the sitewide template from the Model-Glue Application Template to all of the event handlers created by a given scaffold, we can simply add a result tag:
+
+{{{
+<scaffold object="Contact">
+
+<results>
+
+<result do="view.template" />
+
+</results>
+
+</scaffold>
+}}}
+
+By splitting the types of scaffolds created amongst multiple scaffold tags for the same object, we can even apply message broadcasts to specific scaffold-generated event handlers.
+
+In a given application where anyone can view contacts but only administrators can update contacts, we could use the following XML in !ModelGlue.xml to protect the edit, commit, and delete event handlers from unauthorized access (assuming a message listener for "!UserMustBeAdministrator" performs security functionality and adds a result named "!SecurityViolation" in the event of bad access):
+
+{{{
+<scaffold object="contact" type="list,view" />
+
+<scaffold object="contact" type="edit,commit,delete">
+
+<broadcasts>
+
+<message name="UserMustBeAdministrator" />
+
+</broadcasts>
+
+<results>
+
+<result name="SecurityViolation" do="SecurityViolation" redirect="true" />
+
+</results>
+
+</scaffold>