Lotus Notes常用Formula总结（1）

Lotus 公式 (一)

l        访问用户环境
用户环境是包含数据库的服务器或工作站，数据库包括以下内容： 复制公式、由新邮件到达时或定时触发的代理、选择公式或列公式。否则，用户环境是用户运行公式的 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) 对字符串加密。加密后别人无法从中得到最初的字符串。

l        访问当前数据库和视图
可以直接访问正在运行公式的数据库（便捷图标除外，因为它没有数据库环境）。也可以在视图环境中直接访问正在运行公式的视图。同样，在文档环境中可直接访问打开文档的视图。
数据库和视图属性
下表列出返回数据库和视图属性的函数。
函数 描述
@DbManager 返回当前对数据库有“管理者”权限的用户、群组和服务器。返回一个列表。
@DbName 返回当前 Notes 服务器和数据库的名称。返回二个元素的列表。
@ViewTitle 返回当前视图的标题。

l        窗口标题和列公式 @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。

 
l        使用 @function 通过 LS:DO 访问外部数据库
以下 @function 通过 ODBC 访问外部数据库并返回一个值或值的列表：
@DbColumn 返回表的一列中的全部值，或者全部的不同的值。
@DbLookup 返回表的一列中通过关键字匹配选定的值。
@DbCommand 将一个命令传递给外部的数据库管理系统（DBMS）并返回结果。
@DbColumn 与 @DbLookup 都只能提取数据。它们不能增加、删除、修改数据或执行其他操作。@DbCommand 能提取数据或发送其他可以更改数据的 SQL 语句。LotusScript 提供了包括更新外部数据库的更加强大的功能。
前四个参数对于三个函数是同样的，通过 ODBC 建立访问数据库。这些参数是：
"ODBC" 是字符常量；或 "ODBC" : "NoCache"
定义在数据源表格中的数据源名称（在 Windows 中的 ODBC.INI）
用户标识符，两个用户标识符列表，或者一个空串，根据外部数据源而定
口令，两个口令列表，或者一个空串，根据外部数据源而定
(@DbColumn 和 @DbLookup) 要访问的表的名称
(@DbCommand) 要执行的命令
(@DbColumn 和 @DbLookup) 要访问的列的名称
处理由数据源返回的空数据的选项  
(@DbLookup) 包含关键字的列名
(@DbLookup) 适当的数据类型的关键字值，或者是一个列表
(@DbColumn 和 @DbLookup) 两个元素的列表：“Distinct”作为关键字或空串；“Ascending”或“Descending”作为一个关键字
在需要用 IDS 和口令的地方，您可以指定空串并让用户在执行函数时提供它们。

 
l        使用 @function 通过 LS:DO 访问外部数据库
1. 该公式取得 MANUAL 表中的 PARTNO 列。
@DbColumn("ODBC";"Oracle";"";"";"MANUALS";"PARTNO";"":"Ascending")
2. 该公式从 MANUALS 表的行中取得 TITLE，在该行中 PARTNO 是 17-895A。
@DbLookup("ODBC";"Oracle";"";"";"MANUALS";"TITLE";"PARTNO";"17-895A")
3. 该公式从 MANUALS 表中的 ONHAND 列的数字值小于 100 的每行中取得 PARTNO 列值。
@DbCommand("ODBC";"Oracle";"";"";"SELECT PARTNO FROM MANUALS WHERE ONHAND <100")

 
l        转换数据类型
在对数据操作时类型必须是正确的。以下的函数用来转换数据和测试数据类型。
函数 描述
@Text(value) 将一个值转换为文本字符串。
@Text(value; format) 根据指定的格式将一个数字或时间-日期值转换成文本字符串。
@TextToNumber(string) 将文本字符串转换成一个数字。
@TextToTime(string) 将文本字符串转换成一个日期-时间值。
@IsText(value) 如果值是文本字符串或文本字符串列表，则返回“真”值 (1)。
@IsNumber(value) 如果值是数字或数字列表，则返回“真”值 (1)。
@IsTime(value) 如果一个值是时间-日期或时间-日期列表，则返回“真”值 (1)。
@Char(number) 将一个 IBM 代码页 850 代码转换为对应的字符。

 
l        连接、比较和判定长度
运算符 + 用来连接字符串。运算符 =、<>、!=、=!、><、<、>、<= 和 >= 用来比较字符串。以下的函数用来判定字符串的长度和比较字符串：
函数 描述和用法
@Length (string) 以字符为单位返回字符串的长度。
@Length(stringlist) 以字符为单位，返回字符串列表中每个元素的长度。
@Matches (string; pattern) 判定两个字符串是否匹配。可以用通配符来扩展比较的范围。
@Like (string; pattern) 判定两个字符串是否匹配。遵循 ANSI SQL 标准。
@Like(string; pattern; esc) 与上面的一样只是多了一个转义字符。  
@Matches @Matches 用“?”来匹配任意一个单独的字符，用“*”来匹配任意的字符序列，@Matches 使用“\”作为转义字符。
@Like 按照 ANSI X3.135-1992 标准，使用“_”（下划线）来匹配任意一个单独的字符，用“%”（百分号）来匹配任意的字符序列。
 

Lotus 公式 (二)

 
l        查找并提取子串
样例
以下函数查找并提取子串：
函数 描述
@Contains(string; sub) 判定一个字符串是否包含一个子串。
@Contains(string; list) 判定一个字符串是否包含一个列表中的子串。
@Begins(string; sub) 判定一个字符串是否以一个子串开始。
@Ends(string; sub) 判定一个字符串是否以一个子串结束。
@Left(string; n) 从一个字符串中提取最左边的 n 个字符。
@Left(string; sub) 从一个字符串中提取最左边的字符，直到一个子串为止，从左到右搜索。
@LeftBack (string; n) 从一个字符串中提取最左边的字符，直到从右边开始的第 n 个字符为止。
@LeftBack(string; sub) 从一个字符串中提取最左边的字符，直到一个子串为止，从右到左搜索。
@Right(string; n) 从一个字符串中提取最右边的 n 个字符。
@Right(string; sub) 从一个字符串中提取最右边的字符，直到一个子串为止，从左到右搜索。
@RightBack (string; n) 从一个字符串中提取最右边的字符，直到从左边开始的第 n 个字符为止。
@RightBack(string; sub) 从一个字符串中提取最右边的字符，直到一个子串为止，从左到右搜索。
@Middle(string; off; n) 从一个字符串中提取 n 个字符，从一个偏移量开始，从左到右搜索。
@Middle(string; sub; n) 从一个字符串中提取 n 个字符，从一个子串开始，从左到右搜索。
@Middle(string; off; sub) 从一个字符串中提取字符，从一个偏移量开始，到一个子串结束，从左到右搜索。
@Middle(string; sub; sub) 从一个字符串中提取字符，从一个子串开始，到另一个子串结束，从左到右搜索。
@MiddleBack(str; off; n) 从一个字符串中提取 n 个字符，从一个偏移量开始，从右到左搜索。
@MiddleBack(str; sub; n) 从一个字符串中提取 n 个字符，从一个子串开始，从右到左搜索。
@MiddleBack(str; off; sub) 从一个字符串中提取字符，从一个偏移量开始，到一个子串结束，从右到左搜索。
@MiddleBack(str; sub; sub) 从一个字符串中提取字符，从一个子串开始，到另一个子串结束，从右到左搜索。
@ReplaceSubstring(source; from; to) 在 source 中用 from 的内容替换 to 的内容。如果 from 和 to 都是列表，按次序替换对应的项目。
@Word(string; sep; n) 从 string 提取单词 n，其中单词是在指定的分隔符之间的文本。
@Word(list; sep; n) 从列表中的每个字符串中提取单词 n，其中单词是在指定的分隔符之间的文本。

l        修剪、重复、添加新行，并改变大小写
样例
以下函数修剪字符串、重复字符、添加新行（回车），并改变大小写：
函数 描述
@Trim(string) 从字符串中删除开头、结尾和多余的空格。
@Trim(list) 从字符串列表的每个元素中删除开头、结尾和多余的空格，并从列表中删除空白元素。
@Repeat(string , number) 将字符串重复若干次。
@NewLine 在文本字符串中插入一个新行（回车）。
@LowerCase(string) 将字符串中所有的大写字符转换成小写。
@UpperCase(string) 将字符串中所有的小写字符转换成大写。
@ProperCase 将字符串中每个单词的第一个字符转换成大写，并将其余的字符转换为小写。

l        执行算术运算
乘、除、加、减运算符（*/+-）。乘法和除法运算符的优先级高于加法和减法；运算顺序是从左到右。但可以使用括号更改运算顺序。以下列出的是算术运算函数。
函数 描述
@Abs(number) 计算一个数的绝对（无符号）值。
@Sign (number) 对于正数返回 1，对于负数返回 -1，对于零则返回 0。
@Sum(num; num; ...) 计算数字和数字列表的和。
@Integer(number) 去掉数字的小数部分，使它成为整数。
@Integer(numlist) 去掉数字列表所有元素的小数部分，使它们成为整数。
@Round(number) 对一个数字进行四舍五入。
@Round(number; factor) 以一个指定的因子规整数字。
@Round(numlist) 对数字列表中的每个数字进行四舍五入。
@Round(numlist; factor) 以一个指定的因子规整数字列表中的每个元素。
@Max(number; number) 取两个数中较大的一个。
@Max(numlist; numlist) 对两个数字列表进行矩阵式操作时，取两个数字中较大的一个
@Min(number; number) 取两个数中较小的一个。
@Min(numlist; numlist) 对两个数字列表进行矩阵式操作时，取两个数字中较小的一个。
@Modulo(number; number) 计算一个数字被第二个数字除后得出的余数。
@Modulo(numlist; numlist) 对两个数字列表进行矩阵式操作时，计算一个数字被第二个数字除后得出的余数。
@Power(base; exp) 指数计算。
@Sqrt (number) 计算平方根。
@Pi 取得圆周率。
@Log(number) 计算常用（以 10 为底）对数。
@Ln(number) 计算自然（以 e 为底）对数。
@Exp(number) 计算以 e 为底的指数。
@Random 返回一个 0 到 1 之间的随机数。
@Sin(angle) 计算角度的正弦（弧度）。
@Cos(angle) 计算角度的余弦（弧度）。
@Tan(angle) 计算角度的正切（弧度）。
@Asin(sine) 反正弦函数。
@Acos(cosine) 反余弦函数。
@Atan(tangent) 反正切函数。
@Atan2(x; y) 计算以 y/x 作为正切值的反正切函数。

l        答复列的公式
仅用于答复的列需要公式来生成总结答复文档的文本。
包含作者的信息
讨论数据库可以使用如下答复列的公式来显示答复文档的作者、日期和主题：
From + " added this comment: " + Subject + " (" + @Text(@Created) + ")"
按以下方式显示答复：
Stephanie Mahar added this comment: Great job! (10/10/97 04:43:15 PM)
跟踪文档状态
在雇员信息数据库中，答复列可以显示新雇员以及离职雇员的调查信息，作为“按雇员姓名”视图中常规的“雇员记录”的答复文档。下面公式根据答复文档使用的表单的不同，显示不同的消息，并且显示文档的邮递状态。
@If(Form = "Exit"; "Exit Form, "; "New Hire Information, ") + @If(Mailed = "Yes"; "mailed to employee " + @Text(@Date(PostedDate)); "not yet mailed")
如果答复文档使用 Exit 表单，那么答复行显示也许如下：
Exit Form, mailed to employee 08/26/97
如果答复文档使用 New Hire Information 表单，那么答复行显示也许如下：
New Hire Information, not yet mailed
跟踪答复的数目
可以使用 @DocDescendants 跟踪答复文档的数目，以便作者迅速知道收到多少答复文档。下面的主文档列（不是答复列）公式对于答复样式的视图非常有用。
Subject + " (" + @Name([CN]; From) + @DocDescendants(")"; ", % response)"; ", % responses)")
如果是主文档，那么列显示 Subject 域的内容、作者名称、答复以及答复的答复文档的数目。如果文档有一个答复，那么列显示“response”；否则显示“responses”。主文档行可作如下显示：
Need Help with Trade Show (Indy Montoya, 1 response)
Changing the Product Name (Sandy Braun, 2 responses)  

l        视图小程序编程
通过使用一些 @commands 命令可以对视图小程序编程。有以下命令：
@command 描述
ViewCollapse 折叠所选文档
ViewExpand 展开所选文档
ViewCollapseAll 折叠所有文档
ViewExpandAll 展开所有文档
ViewRefreshFields 刷新视图。
刷新时，视图小程序不删除标记为已删除的文档
MoveToTrash 使当前所选文档标记为已删除
EmptyTrash 永久删除标记为已删除的文档
Folder 将所选文档移动或拷贝到文件夹
RemoveFromFolder 从当前文件夹删除所选文档。