LOTUS NOTES编程公式大全与应用指南

LOTUS NOTES公式归类 

用户环境是包含数据库的服务器或工作站，数据库包括以下内容： 复制公式、由新邮件到达时或定时触发的代理、选择公式或列公式。否则，用户环境是用户运行公式的 Notes 工作站。 
用户名可以是专有名称也可以是非专有名称，专有名称可以是规范或缩写的，使用 @Name 可更改用户名的格式。 
以下函数返回或处理用户环境的信息。 
函数 描述 
@UserName 返回用户名或服务器名。 
@Name([key]; name) 更改用户名的格式。关键字包含 [CN] 以从一个专有名字中解析出公共名，[Abbreviate] 缩写规范格式的专有名字，[Canonicalize] 与上述作用相反，[ToKeyword] 将名字各部分按相反顺序排序，用反斜杠分开（用于分类视图）。 
@UserRoles 对于服务器上的数据库，返回当前用户的角色列表。 
@MailDbName 返回用户邮件数据库的服务器名和路径名。该 @function 计算出一个包含两元素的列表。 
@OptimizeMailAddress(address) 从地址中删除无用的网络域。 
@Platform 返回用户当前运行的平台：Macintosh、 NetWare、 OS2V1、 OS2V2、 UNIX、 Windows/16 或 Windows/32。 
@Version 返回正在运行的 Notes 版本（字符串）。 
@Password(string) 对字符串加密。加密后别人无法从中得到最初的字符串。 


访问当前数据库和视图 

可以直接访问正在运行公式的数据库（便捷图标除外，因为它没有数据库环境）。也可以在视图环境中直接访问正在运行公式的视图。同样，在文档环境中可直接访问打开文档的视图。 
数据库和视图属性 
下表列出返回数据库和视图属性的函数。 
函数 描述 
@DbManager 返回当前对数据库有“管理者”权限的用户、群组和服务器。返回一个列表。 
@DbName 返回当前 Notes 服务器和数据库的名称。返回二个元素的列表。 
@ViewTitle 返回当前视图的标题。 
窗口标题和列公式 @function 
许多 @function 提供了关于视图的答复层次和其他方面的信息。在视图中，主文档以 1、2、3 等编号。每组答复文档或答复的答复文档则有第二个和第三个层次的从 1 开始的编号。缺省情况下，完整的答复文档的编号以小数形式出现。例如：第三个主文档的第二个答复文档编号为 3.2，而它下面的第一个答复文档编号为 3.2.1。 
这些函数仅工作于窗口标题和列公式中，有一些会被限制。返回值都是一个字符串。 
函数 描述 
@Responses 返回当前视图中当前文档的答复文档的编号（只限于窗口标题公式）。 

@DocLevel 返回在当前视图中当前文档的级别。 
@DocSiblings 返回与当前文档同级的文档编号（包含当前文档）。 
@DocNumber 返回当前视图中的当前文档或分类的编号。 
@DocNumber(sep) 同上，只是用 sep，而不是句点来分隔编号。 
@DocNumber("") 同上，只是仅返回编号的最右边部分。 
@DocParentNumber 返回当前视图中当前文档或分类的父文档或父分类的编号。 
@DocParentNumber(sep) 同上，只是用 sep，而不是句点分隔编号。 
@DocParentNumber("") 同上，只是仅返回编号的最右部分。 
@DocDescendants 返回后续文档的编号。包含当前文档的子文档，子文档的子文档。 
@DocDescendants(def) 同上，只是返回 def。在 def 中使用 % 以表示编号。 
@DocDescendants(zero; def) 同上，只是如果没有后续文档的话则返回 zero。 
@DocDescendants(one, zero; def) 同上，如果只有一个后续文档的话，则返回 one。 
@DocChildren 返回当前文档的直接子文档的编号。 
@DocChildren(def) 同上，仅返回 def。在 def 中使用 % 以表示编号。 
@DocChildren(zero; def) 同上，只是如果没有后续文档的话，则返回 zero。 
@DocChildren(one, zero; def) 同上，如果只有一个后续文档的话，则返回 one。 
@IsCategory 如果当前行的当前域右边任何域是一个分类，则返回一个星号。 
@IsCategory(True) 同上，只是返回 Frue 代替星号。 
@IsCategory(True; False) 同上，但是如果没有分类域，则返回 False。 
@IsExpandable 如果当前行是可展开的，则返回一个加号。 
@IsExpandable(True) 同上，只是返回 True 代替加号。 
@IsExpandable(True; False) 同上，但是如果当前行是不可展开的，则返回 False。 

使用 @function 通过 LS:DO 访问外部数据库 

以下 @function 通过 ODBC 访问外部数据库并返回一个值或值的列表： 
@DbColumn 返回表的一列中的全部值，或者全部的不同的值。 
@DbLookup 返回表的一列中通过关键字匹配选定的值。 
@DbCommand 将一个命令传递给外部的数据库管理系统（DBMS）并返回结果。 
@DbColumn 与 @DbLookup 都只能提取数据。它们不能增加、删除、修改数据或执行其他操作。@DbCommand 能提取数据或发送其他可以更改数据的 SQL 语句。LotusScript 提供了包括更新外部数据库的更加强大的功能。