Lotus Notes 公式函数集

IBMLotusNotes常用公式简介【IT168技术】Lotus公式用户环境是包含数据库的服务器或工作站，数据库包括以下内容：复制公式、由新邮件到达时或定时触发的代理、选择公式或列公式。否则，用户环境是用户运行公式的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提供了包括更新外部数据库的更加强大的功能。前四个参数对于三个函数是同样的，通过ODBC建立访问数据库。这些参数是：ODBC是字符常量；或ODBC:NoCache定义在数据源表格中的数据源名称（在Windows中的ODBC.INI）用户标识符，两个用户标识符列表，或者一个空串，根据外部数据源而定口令，两个口令列表，或者一个空串，根据外部数据源而定(@DbColumn和@DbLookup)要访问的表的名称(@DbCommand)要执行的命令(@DbColumn和@DbLookup)要访问的列的名称处理由数据源返回的空数据的选项(@DbLookup)包含关键字的列名(@DbLookup)适当的数据类型的关键字值，或者是一个列表(@DbColumn和@DbLookup)两个元素的列表：“Distinct”作为关键字或空串；“Ascending”或“Descending”作为一个关键字在需要用IDS和口令的地方，您可以指定空串并让用户在执行函数时提供它们。使用@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;;;SELECTPARTNOFROMMANUALSWHEREONHAND100)转换数据类型在对数据操作时类型必须是正确的。以下的函数用来转换数据和测试数据类型。函数描述@Text(value)将一个值转换为文本字符串。@Text(value;format)根据指定的格式将一个数字或时间-日期值转换成文本字符串。@TextToNumber(string)将文本字符串转换成一个数字。@TextToTime(string)将文本字符串转换成一个日期-时间值。@IsText(value)如果值是文本字符串或文本字符串列表，则返回“真”值(1)。@IsNumber(value)如果值是数字或数字列表，则返回“真”值(1)。@IsTime(value)如果一个值是时间-日期或时间-日期列表，则返回“真”值(1)。@Char(number)将一个IBM代码页850代码转换为对应的字符。连接、比较和判定长度运算符+用来连接字符串。运算符=、、!=、=!、、、、=和=用来比较字符串。以下的函数用来判定字符串的长度和比较字符串：函数描述和用法@Length(string)以字符为单位返回字符串的长度。@Length(stringlist)以字符为单位，返回字符串列表中每个元素的长度。@Matches(string;pattern)判定两个字符串是否匹配。可以用通配符来扩展比较的范围。@Like(string;pattern)判定两个字符串是否匹配。遵循ANSISQL标准。@Like(string;pattern;esc)与上面的一样只是多了一个转义字符。@Matches@Matches用“?”来匹配任意一个单独的字符，用“*”来匹配任意的字符序列，@Matches使用“\”作为转义字符。@Like按照ANSIX3.135-1992标准，使用“_”（下划线）来匹配任意一个单独的字符，用“%”（百分号）来匹配任意的字符序列。查找并提取子串样例以下函数查找并提取子串：函数描述@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，其中单词是在指定的分隔符之间的文本。修剪、重复、添加新行，并改变大小写样例以下函数修剪字符串、重复字符、添加新行（回车），并改变大小写：函数描述@Trim(string)从字符串中删除开头、结尾和多余的空格。@Trim(lis