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

发布于:2022-11-09 ⋅ 阅读:(12) ⋅ 点赞:(0) ⋅ 评论:(0)

第四十一章 构建数据库应用程序 - 带有<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属性,否则这些字段也会显示在搜索结果表中。

例如,以下代码定义了一个名为MySearchJavaScript函数;该函数将显示一个弹出搜索窗口,用于搜索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()#指令调用服务器端方法MyFormLoadMyFormLoad方法是使用cspindHTML表单MyForm绑定到对象后自动生成的。此方法使用对象IDid的对象的属性值填充表单的内容。

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