 +  );
 +
 +  /**
-+   * This facade works with rdbms.DataSet subclasses.
++   * This facade works with rdbms.DataSet subclasses. This class forms 
++   * the base for facade subclasses.
++   *
++   * Example of the most simple use-case:
++   * <code>
++   *  #[@dataset('net.xp_framework.db.caffeine.News')]
++   *  class NewsManagementFacade extends DataSetFacade {
++   *  
++   *  }
++   * </code>
 +   *
 +   * @purpose  Facade implementation
 +   */
-+  class DataSetFacade extends AbstractState implements Facade {
++  abstract class DataSetFacade extends AbstractState implements Facade {
 +
 +    /**
 +     * Helper method

===================================================================
--- facade/dataset/DataSetHandler.class.php	(revision 0)
+++ facade/dataset/DataSetHandler.class.php	(revision 0)
@@ -0,0 +1,109 @@
+<?php
+/* This class is part of the XP framework
+ *

+    /**
+     * Handle submitted data.
+     *
+     * The following exceptions from the getEntity() are handled and added as
+     * formresult error
+     * <pre>
+     *   Exception                      Error type
+     *   ------------------------------ --------------------------------
+     *   SQLStatementFailedException    sql+stmt:[ERROR-CODE]
+     *   SQLException                   sql+generic:[EXCEPTION-NAME]
+     * </pre>
+     * The field is set to '*' and the exception message is passed as detail.
+     *
+     * @param   scriptlet.xml.XMLScriptletRequest request
+     * @param   scriptlet.xml.workflow.Context context
+     * @return  boolean
