第四十一章 构建数据库应用程序 - 带有CSP Search标签的CSP搜索页面

第四十一章 构建数据库应用程序 - 带有<CSP: Search>标签的CSP搜索页面

search标记创建一个通用搜索页面，可以将其与绑定表单一起使用以执行查找操作。

应用程序用户可以从包含绑定表单的页面访问CSP Search页面，并使用它在数据库中查找匹配一组标准的对象。
然后，用户可以选择其中一个对象并编辑它。

Search标记生成一个显示搜索页面的客户端JavaScript函数。搜索页面由%CSP.PageLookup在类中显示。

Search标记包括使能够控制搜索页面操作的属性。这些措施包括：

csp:search Tag Attributes

Attribute	Description
CAPTION	可选的。标准搜索页面中显示的标题字符串。
CLASSNAME	必需的。要对其执行搜索的类的名称。
FEATURES	可选的。当使用弹出搜索窗口时，字符串包含传递给JavaScript window.open方法的Feature参数。这使您可以更好地控制弹出窗口的显示方式。
MAXROWS	可选。指定要在搜索结果表中显示的最大行数。默认值为100。
NAME	必需的。调用搜索页面的生成的客户端JavaScript函数的名称。
OBJID	调用搜索页面时显示的对象的对象ID值。这用于在用户取消搜索时重新显示旧页面。
ONSELECT	可选。在弹出搜索页面中，当用户选择特定搜索结果时要调用的JavaScript函数的名称。使用所选对象的对象ID值调用此函数。
OPTIONS	可选。搜索页面选项的逗号分隔列表。这些选项包括创建弹出搜索窗口的“popup”和显示搜索谓词下拉列表的“predicate”。
ORDER	可选。作为搜索结果排序依据的字段名称。
SELECT	可选。要在搜索结果表中显示的以逗号分隔的字段列表。如果未指定，则将WHERE列表用作选择列表。
STARTVALUES	可选。调用搜索页的表单中控件名称的逗号分隔列表，其内容用作搜索页中的种子值。列表中名称的顺序与搜索页面中的条件字段(由WHERE属性指定)相对应。
TARGET	可选。在非弹出搜索页面中，指定搜索结果窗口中的链接指向的页面的名称。这是用户做出选择时显示的页面。默认值是调用搜索的页面。
WHERE	必需的。用作搜索页面标准的以逗号分隔的字段列表。除非指定了SELECT属性，否则这些字段也会显示在搜索结果表中。

例如，以下代码定义了一个名为MySearch的JavaScript函数；该函数将显示一个弹出搜索窗口，用于搜索Sample.Person在按名称对象：

<csp:search NAME="MySearch" WHERE="Name" CLASSNAME="Sample.Person"
 OPTIONS="popup" STARTVALUES="Name" ONSELECT="MySearchSelect">

此搜索页面的ONSELECT回调函数如下所示。

<script language="JavaScript">
function MySearchSelect(id)
{
    #server(..MyFormLoad(id))#;
    return true;
}
</script>

该函数使用CSP #server()#指令调用服务器端方法MyFormLoad。MyFormLoad方法是使用cspind将HTML表单MyForm绑定到对象后自动生成的。此方法使用对象ID为id的对象的属性值填充表单的内容。

有关其他示例，请参阅CSP示例页Form.csp在新选项卡中打开并在新选项卡中打开popform.csp.