Web端开发（公式语言2）

WEB端开发（公式语言 2）
@command
Web 支持下面列出的 @command；此处未提及的 @command 不能用于 Web。应该了解，这些 @command 可能有些限制或在 Web 上的表现与在 Notes 客户机中不同。
CalendarFormat
CalendarGoto
Compose
EditClear
EditDocument
EmptyTrash
FileCloseWindow
FileOpenDatabase
FileSave
Folder
MoveToTrash
NavigateNext
NavigateNextMain
NavigatePrev
NavigatePrevMain
OpenDocument
OpenFrameset
OpenHelpDocument
OpenNavigator
OpenPage
OpenView
RemoveFromFolder
ToolsRunMacro
ViewChange
ViewCollapse
ViewCollapseAll
ViewExpand
ViewExpandAll
ViewRefreshFields
ViewShowSearchBar
CalendarFormat
CalendarFormat @command 更改日历视图显示的天数。Web 选项是：
@Command([CalendarFormat] ; \"1\"
@Command([CalendarFormat] ; \"2\"
@Command([CalendarFormat] ; \"7\"
@Command([CalendarFormat] ; \"14\"
@Command([CalendarFormat] ; \"30\"
@Command([CalendarFormat] ; \"365\"
此 @command 相当于如下格式的 URL 命令：
http://host/database/universalID?OpenView&Grid=n&Date=yyyy-mm-dd
CalendarGoto
CalendarGoto @command 转至日历视图中的指定日期。以下样例转至今天的日期：
@Command([CalendarGoTo]; @Today)
此 @command 相当于如下格式的 URL 命令：
http://host/database/universalID?OpenView&Grid=n&Date=yyyy-mm-dd
Compose
Compose @command 新建文档。
要在当前数据库中创建主文档，可仅指定 form 参数并在视图、页面或浏览器中执行 Compose 命令。下面的样例实现为一种视图操作，基于“主文档”表单创建主文档。
@Command([Compose]; \"Main Document\"
要创建答复文档，可如上所示指定 @command，但要在打开的文档中执行它。例如，如果以下代码作为“主文档”表单上的一种操作来实现，则打开一个基于该表单的文档并按下按钮将创建一个答复文档：
@Command([Compose]; \"Response Document\"
要在另一数据库中创建主文档，可指定 database 和 form 参数。由于浏览器不能访问另一个服务器，必须将 server 指定为空字符串。以下样例在“document examples.nsf”中基于该数据库中的“Main Topic”表单创建新文档。
@Command([Compose]; \"\" : \"document examples.nsf\"; \"Main Topic\"
这些 @command 相当于以下格式的 URL 命令：
http://host/database/view?OpenForm
http://host/database/form?OpenForm&ParentUNID=mainunid
EditClear
EditClear @command 删除当前打开的文档：
@Command([EditClear])
对于 Web 应用程序，可以只在表单中执行该 @command。删除之后，标有文本“已删除”的文档将替换当前文档。
在 Notes 客户机中，此 @command 标记文档为要删除或者删除文本（取决于其中的设计元素）。
此 @command 相当于如下格式的 URL 命令：
http://host/database/view/universalID?DeleteDocument
EditDocument
EditDocument @command 切换文档的“阅读”和“编辑”模式。
@Command([EditDocument])
对于 Web 应用程序，不能使用 mode 和 previewpane 参数。
此 @command 相当于如下格式的 URL 命令：
http://host/database/view/universalID?EditDocument
EmptyTrash
EmptyTrash @command 删除被标记为要删除的文档并刷新当前视图。
@Command([EmptyTrash])
仅当“使用 Java 小程序”有效时，此 @command 才能用于 Web 上的视图。
FileCloseWindow
在浏览器中，FileCloseWindow @command 通过装载另一页来模拟关闭一个窗口，通常是前一页显示。
要提交一个打开之后进行编辑的文档，可先发出 FileSave 命令，再发出 FileCloseWindow 命令。可将该命令作为一种表单操作或按钮来实现。
@Command([FileSave]);
@Command([FileCloseWindow])
如果文档不包含 $$Return 域，则浏览器显示带有“表单已处理”消息的页。如果文档包含 $$Return 域，则浏览器显示其 HTML 或显示一个链接。通常情况下，$$Return 是“显示时计算”文本域。要返回创建或打开文档的视图，可将 $$Return 域的公式指定为包含在括号中的 OpenView URL 命令，例如：
db := @ReplaceSubstring(@ReplaceSubstring(@Subset(@DbName; -1);
\"\\\\\"; \"/\"; \" \"; \"+\";
\"[/\" + db + \"/Main+View?OpenView]\"
详细信息，请参阅《Application Development with Domino Designer》中的“为 Web 定制‘表单已处理’确认信息”。
FileCloseWindow 不能用于 Web，除非在数据库属性中已设置了“当生成页面时使用 JavaScript”。这是缺省设置。
FileOpenDatabase
在 Web 上，只能如下所示将 FileOpenDatabase @command 与 OpenDocument 一起使用。
FileSave
FileSave @command 保存当前文档，该文档必须处于打开以进行编辑的状态。
关于将 FileSave 与 FileCloseWindow 一起使用以提交文档的信息，请参阅 FileCloseWindow。
FileSave 不能用于 Web，除非在数据库属性中设置了“当生成页面时使用 JavaScript”。这是缺省设置。
Folder
Folder @command 将所选文档从一个视图或文件夹拷贝或移动到另一个文件夹。以下样例中第一个为拷贝，第二个为移动。
@Command([Folder]; \"Favorite Stuff\"; \"0\"
@Command([Folder]; \"Archive\"; \"1\"
只有当“在浏览器中使用小程序”对正在执行的视图或文件夹有效时，此 @command 才可用于 Web。
MoveToTrash
MoveToTrash @command 将视图或文件夹中所选的文档标记为删除。
@Command([MoveToTrash])
只有当“在浏览器中使用小程序”对正在执行的视图或文件夹有效时，此 @command 才可用于 Web。
NavigateNext
NavigateNext @command 打开当前视图或文件夹中的下一文档。
@Command([NavigateNext])
对于 Web 应用程序，只可以在表单上使用此 @command；不能在视图或文件夹中使用它。
此 @command 相当于如下格式的 URL 命令：
http://host/database/universalID?OpenDocument
NavigateNextMain
NavigateNextMain @command 打开当前视图或文件夹中的下一个主文档。
@Command([NavigateNextMain])
对于 Web 应用程序，只可以在表单上使用此 @command；不能在视图或文件夹中使用它。
此 @command 相当于如下格式的 URL 命令：
http://host/database/universalID?OpenDocument
NavigatePrev
NavigatePrev @command 打开当前视图或文件夹中的前一个文档。
@Command([NavigatePrev])
对于 Web 应用程序，只可以在表单上使用此 @command；不能在视图或文件夹中使用它。
此 @command 相当于如下格式的 URL 命令：
http://host/database/universalID?OpenDocument
NavigatePrevMain
NavigatePrevMain 命令打开当前视图或文件夹中的前一个主文档。
@Command([NavigatePrevMain])
对于 Web 应用程序，只可以在表单上使用此 @command；不能在视图或文件夹中使用它。
此 @command 相当于如下格式的 URL 命令：
http://host/database/universalID?OpenDocument
OpenDocument
OpenDocument 命令与 OpenView 一起使用，打开当前数据库中的现有文档。视图必须已排序且 OpenView 命令必须精确地指定关键字（除不必考虑大小写外）。例如，以下代码打开“主视图”（第一个排序列包含值“one”）中的第一个文档：
@Command([OpenView]; \"Main View\"; \"one\";
@Command([OpenDocument])
与 Notes 客户机的不同存在于以下几方面：
在 Notes 客户机中，可以在没有前述的 OpenView 或未指定关键字的情况下指定 OpenDocument 来打开视图中的当前文档。在 Web 上这样做会失败。
在 Notes 客户机中，可以指定部分关键字，例如，指定“o”或“on”来代替“one”。在 Web 上关键字必须精确匹配。
对于 Web 应用程序，可以使用关键字“$first”来打开视图中的第一个文档：
@Command([OpenView]; \"Main View\"; \"$first\";
@Command([OpenDocument])
要以“编辑”模式打开文档，可将 OpenDocument 的 writeOrReadOnly 参数指定为“1”。例如：
@Command([OpenView]; \"Main View\"; \"one\";
@Command([OpenDocument]; \"1\"
对于 Web 应用程序，不能使用 OpenDocument 的 UNID 和 width:height 参数。
OpenDocument 命令与 FileOpenDatabase 一起使用，可打开另一数据库中的现有文档。以下样例打开“document examples.nsf”的“所有文档”视图中的第一个文档：
@Command([FileOpenDatabase];
\"\" : \"document examples.nsf\"; \"All Documents\"; \"$first\";
@Command([OpenDocument])
这些 @command 相当于以下格式的 URL 命令：
http://host/database/view/key?OpenDocument
http://host/database/view/key?EditDocument
OpenFrameset
OpenFrameset @command 打开一个帧结构集。
@Command([OpenFrameset]; \"WebToDoFS\"
此 @command 相当于如下格式的 URL 命令：
http://host/database/frameset?Op ... otesView&Src=source
OpenHelpDocument
OpenHelpDocument @command 打开“帮助”数据库或指定数据库中的指定文档。以下样例打开“Designer 帮助”的“搜索”视图中的“OpenDocument”主题：
@Command([OpenHelpDocument]; [DesignerHelp]; \"Search\"; \"OpenDocument\"
此 @command 相当于如下格式的 URL 命令：
http://host/database/frameset?OpenFrameSet&Frame=Topic&Src=source
OpenNavigator
OpenNavigator @command 打开一个导航器。
@Command([OpenNavigator]; \"Main Navigator\"
在 Web 应用程序中不能使用 solo 参数。
此 @command 相当于如下格式的 URL 命令：
http://host/database/navigator?OpenNavigator
OpenPage
OpenPage @command 打开一个页面。
@Command([OpenPage]; \"Page One\"
此 @command 相当于如下格式的 URL 命令：
http://host/database/page?OpenPage
OpenView
OpenView @command 打开当前数据库中的一个视图。例如，以下代码打开“主视图”：
@Command([OpenView]; \"Main View\"
如果指定了关键字，则视图必须排序而且 OpenView 命令必须精确指定关键字（除不必考虑大小写外）。在 Web 上，打开视图时包含关键字的行位于顶部。以下代码打开“主视图”，且其第一行包含值“one”：
@Command([OpenView]; \"Main View\"; \"one\";
@Command([OpenDocument])
在 Notes 客户机中，可以指定部分关键字，例如，指定“o”或“on”来代替“one”。在 Web 应用程序中，关键字必须精确匹配。
在 Web 应用程序中，用于关键字的“$first”是指第一行。
这些 @command 相当于以下格式的 URL 命令：
http://host/database/view?OpenView
http://host/database/view/OpenView?StartKey=one
RemoveFromFolder
RemoveFromFolder @command 从文件夹删除所选文档。
@Command([RemoveFromFolder])
只有当“在浏览器中使用小程序”对正在执行的视图或文件夹有效时，此 @command 才可用于 Web。
ToolsRunMacro
ToolsRunMacro @command 运行当前数据库中的代理。例如，以下代码运行代理“Status = open”：
@Command([ToolsRunMacro]; \"Status = open\"
代理在包含数据库的 Domino 服务器上而不是在浏览器计算机上运行。请参阅“Web 代理”。
ViewChange
ViewChange @command 打开当前数据库中的视图。例如，以下代码打开“主视图”：
@Command([ViewChange]; \"Main View\"
在 Web 应用程序中，不能遗漏 view 参数。
此 @command 相当于如下格式的 URL 命令：
http://host/database/view/OpenView
ViewCollapse
ViewCollapse @command 折叠视图中当前分类或当前主文档下的所有内容。
@Command([ViewCollapseAll])
仅当“使用 Java 小程序”有效时，此 @command 才能用于 Web 上的视图。
ViewCollapseAll
ViewCollapseAll @command 折叠视图使其只出现最高级别的分类名称。
@Command([ViewCollapseAll])
此 @command 相当于如下格式的 URL 命令：
http://host/database/viewy/OpenView&Start=1&Count=30&CollapseView
ViewExpand
ViewExpand @command 展开视图中当前分类或当前主文档下的所有内容。
@Command([ViewCollapseAll])
仅当“使用 Java 小程序”有效时此 @command 才能用于 Web 上的视图。
ViewExpandAll
ViewExpandAll @command 展开视图以显示所有级别。
@Command([ViewExpandAll])
此 @command 相当于如下格式的 URL 命令：
http://host/database/By+Category ... Count=30&ExpandView
ViewRefreshFields
ViewRefreshFields @command 重新计算当前打开的文档中所有计算域的值：
@Command([EditRefreshFields])
仅当“在浏览器中使用小程序”对正在执行的视图或文件夹有效时，此 @command 才可用于 Web。
ViewShowSearchBar
在 Web 应用程序中，ViewShowSearchBar @command 打开搜索视图。
@Command([ViewSearchBar])
在 Notes 客户机中，此 @command 切换视图中搜索条的显示。
此 @command 相当于如下格式的 URL 命令：
http://host/database/universalID/$searchForm?SearchView