<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//MAKUMBA//DTD Documentation V2.0//EN" "document-v20-mak.dtd"><document>
    <header>
        <title>mak:searchForm tag documentation</title>
    </header>
    <body>
        <section id="description">
      
      
          <title>Description</title>      <p>
    Produces a form to search for records in the database.</p>      <p>
    Search forms are in principal related to mak:forms, i.e. attributes allowed there are also allowed in search
    forms. Additionally, the following attributes are defined.
</p>    </section>
        <section id="attributes">
            <title>Attributes</title>
            <table>
                <tr>
                    <th>Name</th>
                    <th>Required</th>
                    <th>Request-time</th>
                    <th>Description</th>
                    <th>Comments</th>
                </tr>
                <tr>
                    <td>in</td>
                    <td class="center required">true</td>
                    <td class="center">false</td>
                    <td>The MDD to search in</td>
                    <td>Fixed, mandatory</td>
                </tr>
                <tr>
                    <td>name</td>
                    <td class="center required">true</td>
                    <td class="center">true</td>
                    <td>Name of the form</td>
                    <td>As in mak:forms, but mandatory. Name is used in connection with mak:resultList, and is the prefix for
        several pageContext attributes set, which can be used to perform searching manually.</td>
                </tr>
                <tr>
                    <td>message</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td>The message that is displayed in the response page</td>
                    <td>Fixed. Defaults to "Search done!".</td>
                </tr>
                <tr>
                    <td>action</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td>the response page of the form</td>
                    <td>Mandatory if a &lt;mak:action&gt; is absent</td>
                </tr>
                <tr>
                    <td>method</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td>the HTTP method (get or post)</td>
                    <td>Defaults to get</td>
                </tr>
                <tr>
                    <td>db</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td>The makumba database to connect to. The format is Host_SQLEngineType_DatabaseName
        If not present, the default database is used. See database configuration and lookup.</td>
                    <td>Fixed, cannot contain attributes, for now. 
The default database is chosen if this argument is not set. 
Can only be set for top-level (root) query tags
Can be a Rtexpr &lt;%= ...%&gt;</td>
                </tr>
                <tr>
                    <td>target</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td rowspan="3" class="generic">Form-specific HTML tag attribute</td>
                    <td rowspan="3" class="generic">The content is copied to the resulting &lt;form...&gt; tag. Careful with (escaping) quotes.</td>
                </tr>
                <tr>
                    <td>onReset</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onSubmit</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>styleId</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td>Generic HTML tag attribute</td>
                    <td>results in id="..."</td>
                </tr>
                <tr>
                    <td>styleClass</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td>Generic HTML tag attribute</td>
                    <td>results in class="..."</td>
                </tr>
                <tr>
                    <td>style</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                    <td rowspan="12" class="generic">Generic HTML tag attribute</td>
                    <td rowspan="12" class="generic">The content is copied to the resulting html tag. Careful with (escaping) quotes.</td>
                </tr>
                <tr>
                    <td>title</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onClick</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onDblClick</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onKeyDown</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onKeyUp</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onKeyPress</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onMouseDown</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onMouseUp</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onMouseMove</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onMouseOut</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
                <tr>
                    <td>onMouseOver</td>
                    <td class="center">false</td>
                    <td class="center">true</td>
                </tr>
            </table>
        </section>
        <section id="example">
      
          <title>Example</title>      <source>
      <![CDATA[
<mak:searchForm in="general.Person" name="searchPerson">
    ....
</mak:searchForm>
      ]]>
  </source>    </section>
        <section id="seeAlso">
            <title>See also</title>
            <ul>
                <li>
                    <a href="/doc/taglib/makresultList.html">mak:resultList</a>
                </li>
                <li>
                    <a href="/doc/taglib/makcriterion.html">mak:criterion</a>
                </li>
                <li>
                    <a href="/doc/taglib/makmatchMode.html">mak:matchMode</a>
                </li>
                <li>
                    <a href="/doc/taglib/maksearchField.html">mak:searchField</a>
                </li>
            </ul>
        </section>
    </body>
</document>