字段类型索

更新时间：2023-09-12 09:47:44

字段类型索引

关于字段类型

目前智企易码支持以下字段类型：

文本(text)：文字说明。
长文本(textarea)：可输入多段文字说明。
HTML文本(html)：超文本标记语言，页面内可包含图片、链接等。
选择框(select)：界面生成下拉框供用户选择，允许多选。
复选框(boolean)：界面生成勾选框，勾上即可用。
日期(date)：用户可以选择时间(年--月--日)。
日期时间(datetime)：用户可以选择更加具体的时间(年--月--日时--分)。
数值(number)：只能输入数值内容，可以指定小数位，默认保留2位小数。
金额(currency)：类似数值字段类型，默认保留2位小数。
百分比(password)：类似数值字段类型，提供百分比的显示方式。
密码(password)：密码输入框。
相关表(lookup)：引用其他对象，数据从关联表中选择，支持多选功能。
主表/子表(master_detail)：主表子表字段类型是相关表的一种扩展，将当前记录链接到主表成为子记录。
自动编号(autonumber)：由用户设置公式，设置后无需手动输入，由系统直接生成编号。
网址(url)：在只读时，点击会以窗口形式打开相应的网址。
邮件地址(email)：系统会校验邮件格式是否合法，点击会自动打开邮件客户端，并将字段值带入收件人中。
图片(image)：图片上传及预览。
公式(formula)：公式是通过用户定义的算法自动计算字段的值，系统会根据不同的数据类型来进行整合，取字段的时候要用“{ }”将字段名括起来，如：{字段1}+{字段2}。对于自动计算值的自定义公式字段，可以设置其字段类型为公式字段(formula)，并设置返回值类型和计算公式。如此设置后，这个字段无需用户手动输入，由系统自动计算得出值。
累积汇总(summary)：智企易码中目前支持五种汇总计算，分别是求和(sum)、求平均值（avg）、统计(count)、最大值(max)、最小值(min)。用户可以定义子表中的某个字段值，在主表中显示汇总值。累计汇总字段会计算相关记录中的值，例如统计子表中的数据。您可以创建累计汇总字段，它可根据某个子表中的字段值，在主表中显示汇总值。

主表/子表字段类型

在相关表字段的基础上，我们可以通过创建一个“主表/子表”字段来描述两个对象间的主从关系，需要注意的是应该把“主表/子表”字段添加到“子表”对象侧，来表示“子表”对象是通过这个字段来关联其“主表”的，而不是把“主表/子表”字段添加到“主表”对象侧。比如 “报价行条目” 都应该有对应的 “报价” 与之关联，此时我们可以在 ”报价行条目“ 对象上建立一个 “报价名称” 字段，类型为主表/子表跟 “报价” 对象关联起来。

区别：设置为主表/子表类型的字段可以在主表的“相关子表”里设置关联子表显示的列。

设置该对象相关子表：

引用对象：该相关表字段要关联到的另一个对象，这里设置了“客户”表示通过该相关表字段把“报价”与“客户”两个对象关联起来。
过滤器函数：默认情况下，用户在新建和编辑对象记录界面上填写相关表字段值时会列出相关表的所有记录供选择，可以在这里配置可选项范围，比如输入以下内容作为过滤器函数值可让用户在新建和编辑 “报价” 记录界面上填写“报价客户”字段值时只列出有效客户供选择。

function(filters, values){
  return [["state","=","active"]];
}

关于该函数返回值，目前推荐使用数组语法。

* **选择项函数**：与上述过滤器函数类似，你可以在这里描述用户在填写相关表字段值列出哪些选项供选择，比如输入以下内容作为选择项函数值可以实现上述过滤器函数中内容同样的效果。

```javascript
function(values){
  var result = [];
  var queryFilters = [["state", "=", "active"]];
  var steedosFilters = require("@steedos/filters");
  var odataFilter = steedosFilters.formatFiltersToODataQuery(queryFilters);
  var options = {
    $select: 'name'
  };
  options.$filter = odataFilter;
  var accounts = Creator.odata.query('accounts', options, true);
  accounts.forEach(function (item) {
    result.push({
      label: item.name,
      value: item._id
    });
  });
  return result;
}

:::info 该字段类型的字段也被称为外键字段，其值保存的是关联对象记录的主键字段值而不是名称字段值，详细请参考后续小节名称字段及主键/外键字段。

:::

选择框字段类型

当需要字段值不能用户随意输入的时候，可以设置一个字段的类型为选择框，设置固定的值供用户选择，并设置选择框的值和背景颜色。如报价对象的“状态” 字段可以设置该类型。点击“新建”字段，填写必填项显示名称“状态”、字段名“status”、字段类型“选择框”、选择项（显示名：待审核，选项值：To audit，颜色：90EE90），可添加多条选项。

显示名：选项名，由用户自定义。
选项值：该选项记录在数据库中的值。
颜色：选择后的背景颜色，只支持16进制颜色值，如90EE90。

点击保存即完成，创建后的使用效果如下：

自动编号字段类型

自动编号，是一种特殊的数据规范，表单或报表中经常需要使用序列号，比如单号、编号等，当需要定义一个规则来自动生成所需的序列号时，我们称之为自动编号。

自动编号公式

要自动编号需要我们引用相关公式，公式一般有两种，一种是日期编号，第二种是序号编号。

日期： {YYYY}表示当年四位年（如2020），{YY}表示当年两位年（如20） {MM}表示当月 {DD}表示当日
序号： {0000}表示4位序号,{00}表示2位序号等，不足前面会补0，每增加一个编号数值递增1，默认起始编号为1，比如使用公式{0000}时，第一个编号为0001，第二个为0002。

可以单独显示日期或序号编号，也可以结合起来运用，方便后期查找。例如我们可以新建一个合同编号字段，在字段类型选择框选择自动编号，在公式一栏输入{YYYY}-{0000}, 当新建一个合同时，会自动生成如2021-0001这样的编号。

也可以加入其他的字符串，例如“SN{YYYY}{MM}{DD}{000}” 或是“采购合同[{YYYY}]{000}号”。结果会显示为类似“采购合同2021-0001”这样的数据。

关于起始编号

默认起始编号为1，需要变更起始编号时可以修改目标”自动编号“的“当前编号值”内容，设置方法就是下面的“自动编号配置”。

公式生效范围

使用{YYYY}等日期公式时，可以设置其生效范围，当无效时公式返回空字符串，设置方法就是下面的“自动编号配置”。

自动编号配置

需要变更起始编号或设置日期公式生效范围时需要编辑目标”自动编号“来配置相关属性，点开“设置-高级设置-自动编号”。

自动编号记录规则：当您为一个对象创建一个自动编号字段后，如果没有新建该对象记录，自动编号记录中不会生成该对象的自动编号记录。

如果您想变更起始编号，请在自动编号中新建一条记录，“对象名”、“自动编号字段”请输入对应您之前创建的那一个自动编号字段名及其对象名，“当前编号值”请输入起始编号。“日期范围开始日期”和“日期范围截止日期”如果不填就是默认当年的开始时间和结束时间。

如果您想中途变更编号，请在自动编号中筛选对应的记录，修改其“当前编号值”内容。

新建一条记录时，编号从1开始记录。如果输入的是100，表示从101开始记录。而且当前编号值会随着新增记录的增加而改变，比如已经有10条记录了，当前编号值会显示为10。

变更编号规则

描述需要变更编号规则时应该修改自动编号公式，如果这么做的话历史数据中已经有的记录无法重新编号。

名称字段

名称字段的作用是在对象列表中把该字段显示为链接，点击该链接可以跳转到记录详细页面。

在智企易码中对象上默认以名为name的字段作为”名称字段”。可以通过在对象设置界面编辑这个字段以外的其他字段的属性，勾选其“名称字段”属性来把其他字段设置为名称字段。

如果某个对象没有配置名称字段，那么该对象列表界面的列表中第一列，即序号列里面的序号值会显示为链接，点击这个链接一样可以跳转到记录详细页面。

支持配置为”名称字段“的字段类型有：文本、多行文本、自动编号、公式，请不要将其他类型的字段配置为名称字段。

主键/外键字段

与传统项目中表结构类似，智企易码中每个对象都必须有一个主键字段来唯一标识其每条记录，默认数据源使用MongoDB作为数据库，所有对象的主键字段都是名为_id的字段，外部数据源可能使用关系型数据库，所以可以在对象设置中编辑字段属性，勾选其“外部数据源”栏的“主键”勾选框来把该字段设置为主键字段。

上面我们有提到“相关表”和“主表/子表”两种特殊的字段类型，通过这两种字段类型的字段可以把两个对象关联起来，所以它们也被称为外键字段，需要注意的是这个外键字段是配置在主表对象一侧的，其字段值保存的是其引用对象的主键字段值。

比如联系人对象上有一个名为“所属客户”（account）的“主表/子表”字段，该字段引用的是一个名为“业务伙伴”（accounts）的对象，假设有一条联系人记录“张三”，其“所属客户”是“中国石油”，那么“张三”这条记录中会在其“所属客户“字段中保存“中国石油”这个“业务伙伴”记录的主键字段值，即_id字段值。

通过公式计算字段值

公式是从其他字段、表达式或值派生其值的一种算法。公式可帮助您根据其他字段自动计算一个字段的值。

在哪些地方可以使用公式?

智企易码的许多地方都可以使用公式。开始使用公式之前，请了解其用法的差别。

批准过程： 定义记录必须满足才能进入批准过程的条件。
批准步骤： 定义记录必须满足才能进入批准步骤的条件。
字段默认值： 在用户创建记录时向自定义字段应用一个值。使用公式可以定义默认值。用户可以更改默认值。默认值可以由使用您指定的值、合并字段或表达式的公式确定。
公式字段： 使用您指定的值、合并字段或表达式。自动计算自定义字段的值。用户不能更改公式字段的值。
验证规则： 防止用户在标准/自定义字段中输入无效值。验证规则可以基于公式，并在用户输入无效值时，向用户显示出错消息。
字段更新： 自动将字段值更改为您指定的值。公式中可以包括其他值、合并字段或表达式。可以将字段更新设置为因工作流规则或批准过程而发生。
工作流规则： 定义记录触发工作流规则时必须满足的条件。

常用公式过程

用法	何时执行？	只读？	可以指定空处理？
批准过程	记录提交待批准	不适用	否
批准步骤	记录提交待批准	不适用	否
字段默认值	创建记录时	否	否
公式字段	记录被保存后	是	是
验证规则	记录被保存前	不适用	否
字段更新	工作流或批准过程中	不适用	否
工作流规则	保存记录时	不适用	否

公式数据类型

公式的数据类型决定预期从公式返回的数据的类型。

文本： 返回字符串。除公式输出外，若还要显示文本，请将该文本放入引号中。对文本、多行文本、网址、邮件地址和自动编号等字段使用文本数据类型。
布尔： 返回 true（真）或false（假）。该字段在记录详细信息页面和报表中显示为复选框。使用 true 作为选中值，使用 false 作为未选中值。
金额： 只能输入数值内容，默认2位小数，也可以指定小数位数。
日期： 返回代表日历中某一天的日期。当前日期可通过在公式中调用内部函数 TODAY() 获得。
日期时间： 返回表示时间中某一时刻的数据。日期时间字段包括日期，还包括由小时、分钟和秒组成的一天中的时刻。您可以使用 NOW() 函数在公式中插入当前日期和时间。
数字： 返回正负整数或小数（最多 18 位）。智企易码对公式字段使用四舍五入平分规则。例如，12.345 变为 12.35 和 -12.345 变为 -12.35。
百分比： 返回后跟百分号的百分比格式数字（最多 18 位）。百分比数据存储为小数，值为除以 100 后得到的小数，即 90% 等于 0.90。
时间（暂不支持）： 返回表示时间中某一时刻的数据，没有日期。时间字段包含小时、分钟、秒和毫秒的时间。您可以使用 TIMENOW() 函数在公式中插入当前日期。

公式中的元素

公式可以包含对字段值、运算符、函数、文字表示值或其他公式的引用。使用任意或所有这些元素构建公式。

文字表示值

您输入的未经计算或更改的文本字符串或数字。

例如，如果您有一个总是要乘以金额的 2% 的值，公式将会包含该金额的 2% 的文字表示值：

ROUND((amount*0.02), 2)

此示例包含公式每个可能的部分：

一个称为 ROUND 的函数，用于返回一个数值舍入为指定小数位数的数值。
名为“金额”的字段引用。
一个运算符 *，告诉公式生成器用文字表示值 0.02 乘以金额字段的值。
一个文字表示数值 0.02。对所有百分数使用小数值。要在您的公式中包括实际文本，应将其括在引号内。
此公式中的最后一个数字 2 是确定要返回的小数位数的 ROUND 函数所需的输入。

函数

函数即系统定义的公式，可能需要您的输入值，并返回一个或几个值。例如，TODAY() 不需要输入值，但会返回当前日期。TEXT(value) 函数需要您输入百分比、数字或货币并返回文本。

运算符

一个符号，指定要执行的计算类型或其执行顺序。例如，“+”号指定两个值应相加。左括号和右括号指定想要先计算的表达式。

字段引用

使用合并字段引用另一个自定义字段或标准字段的值。

合并字段的语法对于标准字段是 field_name，对于自定义字段是 field_name__c。相关对象上合并字段的语法是 reference_to_field_name.field_name，必要时可在您的公式中插入合并字段，并且理论上支持无限层次的扩展引用，比如三层引用写法为reference_to1_field_name.reference_to2_field_name.field_name。

支持引用当前登录用户相关字段，写法是以$user开头来表示当前登录用户的引用，并用点符号来连接后续要扩展引用的属性，比如$user.name表示引用当前用户的名称，$user.organization.name表示引用当前用户所属组织的名称。

要引用关联字段指向的记录id只要用点符号来连接_id即可，比如reference_to_field_name._id，$user._id

公式中的运算符和函数

在构建公式时也可以使用运算符和函数。

如何构建公式字段

按照与创建自定义字段相同的方式开始构建一个公式字段，字段类型选择公式。
选择公式的数据类型。根据计算的输出值为您的公式选择适当的数据类型。
选择数值、金额或百分比数据类型的小数位数，数字长度最长为18位数。
如果您的公式引用任何数字、金额或百分比字段，则应选择一个选项以处理空白字段。
可以在公式中引用当前对象上的“相关表”或“主表/子表”字段来实现跨对象公式。
可以在公式中输入_id来引用当前记录的id值。
可以在公式中输入$user变量来引用当前登录用户的相关信息。
也可在描述框中输入公式字段描述，单击保存完成操作。

重算公式值

对于已经存在的历史记录数据，很多情况下公式字段值不会重新计算，此时您应该选择公式字段后台详细配置页面上的“重算公式值”按钮来手动重新计算该值。这些情况包括但是不限于以下情况：

更改公式字段定义（如小数位数，公式内容，数据类型、空白字段处理等）。
更改在公式内容中引用字段的相关属性，比如更改其字段类型、小数位数，更改其公式字段的数据类型、公式表达式或其他属性等。

在正式环境中请谨慎修改对象的某些字段属性，比如字段类型，字段公式表达式，下拉选择框可选项列表等，因为对于已经存在的历史记录数据可能不会重新触发字段值重算，对于公式字段值，只能通过手动操作这里的“重算公式值”按钮来修正历史数据。

使用日期和日期时间公式字段的提示

日期和日期时间字段不能交替使用。名称本身不能表示某个字段是日期还是日期时间。例如，创建日期和上次修改日期是日期时间字段，而上次活动日期是日期字段。使用 DATEVALUE 函数可将日期时间字段转换为日期字段。
将加和减运算符与日期或日期时间字段结合使用来计算持续时间。例如，从一个日期中减去另一个日期来计算两者之间相差的天数。同样，您可以从一个日期时间中减去另一个日期时间，获得以数字表示的两者之间相差的天数。有关建议的使用方法，请参阅NOW 或TODAY。
将加和减运算符与数字结合使用，返回其他日期或日期时间。例如，CreatedDate + 5 计算记录的创建日期之后五天的日期和时间。注意，表达式返回的数据类型与给定的数据类型相同；日期字段加上或减去某个数字会返回日期，日期时间字段加上或减去某个数字会返回日期时间。
在使用小数计算日期时，公式会忽略小数点后的所有数字。例如：
公式TEXT(TODAY())将返回当天的日期字符串，比如2020-09-30, TODAY是按utc时间取日期，这点跟TODAY()一样。
- 公式TODAY() + 1将返回当天日期+1天的日期值，即可以直接用+号运行运算。
- 公式TODAY() + 0.7将返回当天的日期值，而不是+1天的日期值，因为日期计算时小数部分会被忽略只取整数部分，公式TODAY() + 1.2将返回当天日期+1天的日期值。
- 公式TODAY() + 1.5 + 0.5或TODAY() + 0.5 + 1.5将返回当天日期+1天，而不是+2天的日期值，因为日期计算时所有的小数都部分都会被忽略不会累加，正确的写法是用括号让数值先计算：TODAY() + (1.5 + 0.5)。
- 公式NOW() + 1.1将返回当前时间增加1.1天后的时间值，即增加1天2小时24分（1天的0.1）。就是说时间类型是支持小数点计算的，单位是天。
- 公式T1 - T2，如果以上两个日期时间字段值之差是 5.52，将意味着两个值分隔 5 天、12 小时（1 天的 0.5）和 28 分钟（1 天的 0.02）。要先计算两个小数的值，应该用括号将它们组合在一起。例如：
- TODAY() + 0.5 + 0.5 与 TODAY() + 0 + 0 相同，即今天的日期。
- TODAY() + (0.5+0.5) 与 TODAY() + 1 相同，即明天的日期。关于时区，请参考在公式中使用日期、日期时间和时间值

使用数字公式字段的提示

在公式中使用百分比字段时，使用百分比的小数形式。例如，IF(Probability =1...) 表示 100% 可能性，IF(Probability =0.9...)表示 90% 可能性。
在公式中将自动编号字段作为文本字段引用。
您的公式的输出值必须小于 18 位数。
公式中可以包含数字、百分比和货币的混合：AnnualRevenue / NumberOfEmployees。
公式运算时把公式引用的其他字段作为变量传入以及智企易码界面显示公式字段时，都会识别字段上设置的小数位数，并使用四舍五入平分规则处理公式字段值。例如，12.345 变为 12.35 和 −12.345 变为 -12.35。但是公式字段本身的输出值不受这里设置的小数位数影响，所以公式中应该使用。
ROUND函数来处理计算结果的小数位数。
要视任意空白字段为零值，请选择将空白字段视为零。要将这些字段留空，请选择将空白字段视为空白，在智企易码中该属性默认为“空白字段视为零”。

使用文本公式字段的提示

要在公式字段中插入文本，用引号将文本引起来。例如，要显示“CASE: 123”，使用本公式 “CASE: “& CaseNumber__c.
在引号或反斜线之前使用反斜线 ( \ ) 字符，可在您的输出值中将其插入为文字值。例如，公式中的“Trouble\ \Case \"Ticket\": ” 会在详细信息页面显示 Trouble\Case “Ticket”:（暂不支持，即目前无法在公式中编写带引号或反斜线的字符串）

使用布尔公式字段的提示

部分函数是不支持输出boolean类型值的，已知不支持的函数有 BLANKVALUE, CASE, IF。

比如以下公式配置会报错：

IF(location_type = 'Van', true, false)

应该使用ocation_type = 'Van'来简化该公式。

同样的，以下公式配置也会报错：

CASE(Days_Open__c, 1,  true,false)

应该使用Days_Open__c = 1来简化该公式。

使用选项列表公式字段的提示

在公式中使用select字段类型时，有单选和多选两种，分别对应到公式中的单选选项列表picklist和多选选项列表multipicklist这两种数据类型，只有少量公式函数支持这两种数据类型。

支持单选选项列表的函数

ISPICKVAL: 将选项列表的值与单个值进行比较。
CASE：将选项列表的值与多个值进行比较。
TEXT：返回选项列表值的 API 名称，以便您可在支持文本值的函数（例如 CONTAINS）中使用对值的引用（即使显示值已更改）。
ISBLANK：判断字段值是否为空。

支持多选选项列表的函数

INCLUDES：决定多选选项列表字段中选择的任何值是否等于您所指定的文本文字。
ISBLANK：判断字段值是否为空。

跨对象公式

我们有时需要在当前对象上通过公式字段来引用其他关联对象上的字段值，这种跨越两个及以上的对象的公式我们称为跨对象公式。

可以在当前对象上配置“相关表”或“主表/子表”类型的字段来引用其他对象，相关规则请参考之前主键/外键字段小节，跨对象公式就是通过在公式中引用当前对象上这两种字段型，然后进一步引用其关联对象上的字段来实现跨对象公式。

跨对象公式一般形如fieldNameA.fieldNameB，其中fieldNameA是当前对象上的“相关表”或“主表/子表”字段名称，fieldNameB是fieldNameA字段关联到的对象上的某个字段名称，比如联系人对象上有一个名为“所属客户”（account）的“主表/子表”字段，引用了对象“业务伙伴”(accounts)，我们可以在联系人对象定义一个公式字段来输出联系人所属客户的网址，该公式字段的公式表达式应该配置为account.website。

可以在跨对象公式中用点符号连接各级对象上的外键字段以形成引用链，理论上支持无限层次的引用，但是出于性能考虑请避免引用层级过多，比如上面提到的联系人对象上可以配置公式account.created_by.name表示输出联系人所属客户的记录创建人的名称。

可以在公式中输入$user变量来引用当前登录用户的相关信息，作为跨对象公式的一种，你也应该在其后用点符号来扩展引用链，$user指向的是space_users表而不是users表，所以只能从 space_users 表中外键字段开始扩展其引用链，比如$user.organization.owner.name，更多可扩展属性请参考 space_users对象源码。

需要注意的是，跨对象公式最后一个引用链不可以是外键字段，即不可以是相关表”或“主表/子表”类型的字段，比如上面提到的联系人对象上的公式如果配置为account.created_by是表示输出联系人的创建人，但是这是不合法的，因为created_by是一个外键字段，它指向了关联创建人整条记录，而不是只输出关联创建人的某个字段值，所以正确的写法是需要再向created_by这个外键字段进一步扩展引用其下一级对象的字段，比如上面提到的account.created_by.name就是一个合法的跨对象公式。

如果是想让公式输出外键字段值本身，可以在最后扩展引用下其关联对象的主键字段（即_id）即可，也就是把公式表达式写成account.created_by._id就可以输出联系人所属客户的创建人_id值。

关于公式级联触发的提示

在一个公式字段A被另一个公式字段B引用的情况下，当某种原因触发字段A更新重算后，会级联触发公式字段B也更新重算。
当多个公式字段之间存在多层级联引用的情况下，其中一个字段被触发更新重算的话，会逐层触发级联更新重算。
如果累计汇总字段汇总的是一个公式字段，那么当公式字段值变更时，会触发该汇总字段重新汇总更新值。
如果累计汇总字段被一个公式字段引用，那么当汇总字段被更新时，也会触发该公式字段更新重算。

公式字段之间如果出现循环引用的话，智企易码是能智能识别并阻止相关字段配置生效的。

累计汇总计算

累计汇总字段会自动计算相关记录中的值。您可以创建累计汇总字段，使其值基于主表/子表关系中某个子表的字段值汇总，并在主记录中显示该汇总结果。子表记录必须通过主表/子表直接与主记录相关。例如，您要在客户的发票相关列表中显示所有相关发票自定义对象记录的发票总金额。您可在名为“发票总金额”的自定义金额字段中定义这一汇总信息。

可以使用累计汇总字段执行不同类型的汇总计算。比如可以计算与主记录相关的子记录的数量，也可以计算子记录中字段的总和、最小值或最大值。

创建累计汇总字段

在对象（位于主表/子表的主侧）上定义累计汇总字段。

如果关系已经不存在，请首先在子表侧创建一个主对象与子对象之间的主表/子表关系，用于表示正在汇总的记录的值与被汇总的记录之间的关系。

在您希望显示累计汇总字段值的对象上新建字段。汇总字段汇总了相关对象上的记录中的值，因此该对象（您在上面创建了该字段）应位于主表/子表关系的主侧。

所属对象：即主表/子表关系中的主对象。
显示名称：希望该汇总字段显示的名称。
字段名：该字段的唯一性api名称。
字段类型：请选择“累计汇总”。
默认值：因为字段值是计算得出的，所以默认值在此处无效。
字段分组：希望该字段显示在哪个分组上。
精度：数值字段的精度。
小数位数：希望该汇总结果保留的小数位数。
要汇总的对象：选择主表/子表关系中子表上的对象，该对象包含您要汇总的记录。
汇总类型：
- COUNT：汇总子表一共有多少条记录，返回记录总条数。
- SUM：对在“要聚合的字段”选项中选择的字段的值进行累加汇总。仅数字、金额和百分比字段类型可用。
- AVG：对在“要聚合的字段”选项中选择的字段的值进行总和平均值计算。仅数字、金额和百分比字段类型可用。
- MIN：对在“要聚合的字段”选项中选择的字段的值进行大小比较并取出最小值。仅数字、金额、百分比、日期和日期时间字段可用。
- MAX：对在“要聚合的字段”选项中选择的字段的值进行大小比较并取出最大值。仅数字、金额、百分比、日期和日期时间字段可用。
要聚合的字段：请选择子表上的某个字段，这个字段就是要进行SUM/AVG/MIN/MAX进行聚合计算的字段。对于除COUNT外的其他汇总类型，此项必填，反之不需要填写该字段。
过滤条件：如果要在汇总计算时，只包含特定的记录组，请在过滤条件中输入筛选条件，比如只汇总2021年1月1号早上8点前创建的记录。
其他：勾选上需启用的功能开关等，单击保存结束操作。

汇总时过滤条件

如果要在汇总计算时，只包含特定的记录组，可以在过滤条件中输入对应的筛选条件。

这些过滤条件过滤的是子表记录而不是主表记录。
字段输入框中列出的是子表对象中可用于过滤的字段名称供选择。
运算符输入框中列出的是基于左侧选中字段的字段类型所支持的过滤条件运算符，比如字符类型的字段有“包含”运算符，而金额类型没有。
值是一个纯文本输入框，当左侧字段类型不同时，请按不同的输入规范输入文本字符：
- 数值、金额、百分比：请输入合法的数值，比如1.2,3000。
- 布尔：请输入"true", "True", "TRUE", "1"表示真，或输入"false", "False", "FALSE", "0"表示假。
- 日期：请输入类似2020-02-12格式的值，它表示的值是2020-02-12T00:00:00.000Z，即这里转换为按utc的0点时间值来过滤。
- 日期时间：请输入类似2020-02-12 12:00格式的值，它表示的值是2020-02-12T04:00:00.000Z，即这里会按当前时区转换为utc时区下的时间值来过滤。
- 相关表：请输入记录的_id值，比如rbNxQ3mK6CFs8LWbr要表示要引用记录的ID值。
- 主表/子表：同相关表。
- 其他：按文本值过滤。
可以输入多个过滤条件，最终会按AND逻辑连接输出这些条件，不支持按OR或更复杂的逻辑过滤。

智企易码支持更丰富的过滤条件设置，比如支持按OR逻辑过滤，支持多个OR或AND嵌套使用。

批量重算汇总值

对于已经存在的历史记录数据，很多情况下累计汇总字段值不会重新计算，此时您应该选择累计汇总字段后台详细配置页面上的“批量重算汇总值”按钮来手动重新计算该值。这些情况包括但是不限于以下情况：

更改累计汇总定义（如对象、要聚合的字段、汇总类型、过滤条件等）。
更改在累计汇总字段“要聚合的字段”中引用字段的相关属性，比如更改其字段类型，更改其公式字段的表达式等。

在正式环境中请谨慎修改对象的某些字段属性，比如字段类型，字段公式表达式，下拉选择框可选项列表等，因为对于已经存在的历史记录数据可能不会重新触发字段值重算，对于累计汇总字段值，只能通过手动操作这里的“批量重算汇总值”按钮来修正历史数据。

实施提示

可在所有具有主表/子表关系的主侧对象上创建累计汇总字段，无论两侧对象是标准对象还是自定义对象。
当某个对象上无法创建累计汇总字段时，请先在该对象的子表上创建主表/子表关系。
累计汇总字段中能够计算的字段类型取决于汇总类型及其要聚合的字段的字段类型。例如：
- 当选择 SUM 或 AVG 作为累计类型时，数字、金额和百分比字段均可用。
- 当选择 MIN 或 MAX 作为累计类型时，数字、金额、百分比、日期和日期时间字段均可用。
- 当选择COUNT作为累计类型时，将直接汇总子表记录条数总合而与子表的字段无关，不需要选择“要聚合的字段”。
有时，您无法更改您在累计汇总字段中引用字段的字段类型，这是因为累计汇总字段中能够计算的字段类型依赖于要聚合的字段的字段类型，智企易码暂时未处理此类逻辑校验，请谨慎随意变更正式环境中的字段类型。
在对象上创建了累计汇总字段后，不能将该汇总字段依赖的子表对象中的主表/子表类型字段的字段类型变更为相关表或其他字段类型，智企易码暂时未处理此类逻辑校验，请谨慎随意变更正式环境中的字段类型。
累计汇总字段可以引用公式字段，即“要聚合的字段”可以选择公式字段类型的字段，当公式值变更后会触发累计汇总字段重新汇总计算并更新字段值。
公式字段中也可以引用累计汇总字段，当累计汇总字段值变更时会重新触发相关公式字段重算其字段值。
就目前来说，累计汇总字段中引用了包含派生即时值的跨对象字段引用或函数（如 NOW 或 TODAY的）公式字段时，智企易码按普通公式的方式处理，不加以区别对待，但是您不应该这么配置，这不只是实际需求中不应该有这种逻辑，更是因为这种配置会带来性能方面的极大损耗。
就目前来说，累计汇总字段值变更时，不会重新触发引用了该汇总字段的工作流规则、验证规则或其他自动规则中的公式计算。
在正式环境中请谨慎修改对象的某些字段属性，比如字段类型，字段公式表达式，因为对于已经存在的历史记录数据可能不会重新触发字段值重算。
计算累计汇总字段值可能需要 30 分钟或以下，取决于受影响的记录的数量和其他因素。
如果验证规则中引用了累计汇总字段，当汇总字段值在变更时也不会触发执行验证规则，比如主记录有一个验证规则，要求累计汇总字段值必须小于100。如果用户对相关子记录的更改将输入超过 100 的值，希望用户无法保存该子表记录，实际上子记录变更时主记录的验证规则是不会被触发的，要实现这个需求，通常的做法是把验证规则配置在子表而不是主表中，类似：lookup_mater_object_field.summary_value + current_value >= 100。

最佳实践

如果不想让用户看见累计汇总字段计算值，可以将字段设置为隐藏字段。详细记录上用户不能看见的字段仍然会在累计汇总字段中被计算。
如果具有验证规则，请考虑它们将如何影响累计汇总字段。子表记录中的值发生变更时，主表记录的累计汇总字段的值也会发生变更。所以保存主表/子表记录时会显示一个验证错误，请参考上述实施提示最后一条。
请注意从子表字段引用主表累计汇总字段与从主表字段引用自身的累计汇总字段是有区别的。从子记录引用的累计汇总字段可能拥有过时值，因为子记录保存时父记录尚未更新。但是，从父级记录中引用累计汇总字段的话，虽然累计汇总字段将始终拥有最新的更新值，但是子记录变更时主记录的验证规则是不会被触发的，请参考上述实施提示最后一条。
创建累计汇总字段之前，请规划其实施。一旦创建，就不能更改所选详细对象，也不能删除累计汇总定义中引用的任何字段。
创建累计汇总字段之前，请规划其实施。特别是在生产环境中，一旦产生有价值的历史数据，再修改对象的某些字段属性，比如字段类型，字段公式表达式的话，就需要手动执行批量重算汇总值来修正历史数据，这将增加不确认性风险。
累计汇总字段中不允许自动派生字段，如当前日期或当前用户。禁止字段包含可动态派生值的函数（如 DATEVALUE、NOW 和 TODAY）的公式字段。累计汇总字段中也不允许包含相关对象合并字段的公式字段。

在公式中使用日期、日期时间和时间值

日期使用了两种数据类型：日期和日期时间。数据类型时间不包括日期值，例如工作时间。处理日期时使用的大部分值都是日期数据类型，存储年、月和日。CreatedDate 等一些字段是日期时间字段，意味着它们不仅存储日期值，而且还存储时间值（以 GMT 存储，但以用户的时区显示）。当在记录详细信息页面查看时，日期、日期时间和时间字段以用户的区域设置格式化。时间值的精度以毫秒为单位。日期时间值的精度以秒为单位。

您可在日期、日期时间和时间值上使用加和减等运算符，以计算未来日期或两个日期或时间之间的已过去的时间。例如，如果您将一个日期减去另一个日期，由此得出的值将是两个初始值之差（天）（数字数据类型）。两个日期时间值之间的同一操作将返回十进制值，表示天、小时和分钟数之差。两个时间值的相同操作会返回毫秒。

例如，如果两个日期时间值之差是 5.52，这意味着两个值分隔 5 天、12 小时（1 天的 0.5）和 28 分钟（1 天的 0.02）。您还可以添加数字值到日期和日期时间。例如，操作 TODAY() + 3 将返回今天日期后的三天。

在整个示例中，使用了变量日期和日期时间以代替实际日期和日期时间字段或值。

today()、now() 和 timenow()

TODAY() 函数以日期数据类别返回当前日、月和年。对于希望了解自上一天过去的天数、未来某些天数中的日期或仅仅希望显示当前日期的公式，本函数非常有用。
NOW() 函数返回当前时刻的日期时间值。当关心当天的特定时间以及日期时，这将非常有用。
TIMENOW() 函数会返回 GMT 的值，并表示不带日期的当前时间。如果您需要当前小时、分钟、秒或毫秒，使用此函数，而不是 NOW() 函数。此值对跟踪时间（例如轮班或经过时间）有用。

date()函数

DATE() 函数返回日期值，给定年、月和日。数字 Y/M/D 值和 YEAR()、MONTH() 和 DAY() 函数是 DATE() 的有效参数。例如，DATE( 2013, 6, 1 ) 返回2013 年 6 月 1 日。同样，DATE( YEAR( TODAY() ), MONTH( TODAY() ) + 3, 1) 返回当年今天起三个月的第一天的日期值，假定该日期有效（例如，月份在 1 和 12 之间）。

如果输入的 Y/M/D 值导致无效的日期，DATE() 函数并不会报错，而是会返回一个可能错误的值，比如非闰年的DATE(2021,2,29)将返回2021-03-01，DATE(2021,121,29)将返回2031-01-29，因此错误检查是使用日期值的重要部分。您可在示例日期格式中阅读有关处理无效日期的方法。

在日期时间和日期之间转换

日期和日期时间是不可交换的数据类型，因此在日期和日期时间值之间执行操作时，您需要转换这些值，使它们具有相同的类型。一些函数（如 YEAR()、MONTH() 和 DAY()）还仅适用于日期值，因此必须首先转换日期时间值。

使用 DATEVALUE( datetime ) 函数返回日期时间的日期值。例如，要从日期时间获取年，使用 YEAR( DATEVALUE( datetime ) )。

您可以使用 DATETIMEVALUE( TEXT(date) ) 函数将日期值按GMT时区转换为日期时间。时间将设置为格林威治标准时间 (GMT) ，然后显示时会按用户所有时区显示。对于北京时间，DATETIMEVALUE( TEXT(TODAY()) ) 将返回当天的utc0点，智企易码界面上将显示为当天的上午8:00而不是当天的 00:00。

在日期时间和时间之间转换

TIMEVALUE() 函数返回的时间数据类型值的格式为 24 小时制的“HH:MM:SS.MS”(hours:minutes:seconds.milliseconds)数字 H/M/S/MS 值和 HOUR()、MINUTE()、SECOND() 和 MILLISECOND() 函数是 TIMEVALUE() 的有效参数。

使用 TIMEVALUE(text) 函数，把文本值、文本类型合并字段或表达式转换为时间类型。例如，使用 TIMEVALUE(LPAD(TEXT(HOUR(ClosedDate)), 2, "0") & ":" & LPAD(TEXT(MINUTE(ClosedDate)), 2, "0") & ":" & LPAD(TEXT(SECOND(ClosedDate)), 2, "0") & "." & LPAD(TEXT(MILLISECOND(ClosedDate)), 3, "0")) 从 ClosedDate 日期时间值中提取时间。

在日期和文本之间转换

如果希望将日期作为字符串一部分包含，在 TEXT() 函数中包含日期值以转换为文本。例如，如果希望将今天的日期转换为文本，使用： "Today's date is " & TEXT( TODAY() )

这将以格式“YYYY-MM-DD”而不是取决于区域设置的格式返回日期。先从日期中提取日、月、年，然后按所需格式重新组合，即可更改公式。例如： "Today's date is " & TEXT( MONTH( date ) ) & "/" & TEXT( DAY( date ) ) & "/" & TEXT( YEAR( date ) )

您还可以将文本转换为日期，以便将字符串值与您的其他日期字段和公式一起使用。您将希望文本的格式为“YYYY-MM-DD”。使用本公式以返回日期值： DATEVALUE( "YYYY-MM-DD" )

在日期时间和文本之间转换

您可使用 TEXT() 函数在字符串包含日期时间值，但需要小心时区。例如，考虑本公式： "The current date and time is " & TEXT( NOW() )

在本公式中，NOW() 偏移到 GMT。通常，NOW() 将在查看时转换成用户的时区，但由于被转换为文本，因此转换不会发生。因此，如果您在 8 月 1 日北京时间 (GMT-10) 下午6点执行本公式，结果是“The current date and time is 2021-08-01 10:00:00Z”。

当将日期时间转换为文本时，将在最后包含“Z”以表示 GMT。

要将字符串转换为日期时间值，使用 DATETIMEVALUE() 将以“YYYY-MM-DD HH:MM:SS”的格式传输字符串。本方法将返回 GMT 的日期时间值。

在时间和文本之间转换

如果您想要将时间作为字符串的一部分包含，在 TEXT() 函数中封装时间值，以将其转换为文本。例如，如果您想要将当前时间返回为文本，使用： "The time is " & TEXT( TIMENOW() ) 此函数会返回格式为“HH:MM:SS.MS”的时间。

您也可以将文本转换为时间数据类型，以便将字符串值与其他时间字段和公式一起使用。按 24 小时制将文本格式化为“HH:MM:SS.MS”。使用 TIMEVALUE() 函数： TIMEVALUE("17:30:45.125")

有关日期时间和时区的备注

日期和日期时间值以 GMT 存储。保存好记录后，字段值存储为 GMT时区下的值，然后在记录详细信息页面显示时以查看者的时区显示。不会因日期转换而造成问题，因为转换日期时间为日期会得到相同的日期值。

然而，当使用日期时间值时，转换始终以 GMT 而不是用户的时区完成。如果在两个日期时间字段之前比较不会有时区问题，因为这两个字段都在同一时区。然而，当计算中的一个值从文本或日期值转换为日期时间值时，结果将不同。

让我们假定北京用户在名为 Date_Time_c 的自定义日期时间字段输入 2020 年 8 月 2 日 9点的值。该值被存储为 2020-08-02 01:00:00Z，因为存在 GMT+8的时区差。在北京时间 8 月 2 日21:00，用户编辑记录时运行以下公式字段： Date_Time_c - NOW() 在计算中，NOW() 是 2020-08-02 13:00:00Z，然后从 2020-08-02 01:00:00Z 相减会返回 -0.5（-12 小时）的预期结果。

假定不使用 NOW()，公式将转换字符串“2020-08-02 21:00:00”为日期时间值： Date_Time_c - DATETIMEVALUE( "2020-08-02 21:00:00") 在这种情况下，DATETIMEVALUE( "2020-08-02 21:00:00")是 2020-08-02 21:00:00Z，最后运算结果会返回-0.8333333333333334（-20小时），与之前的-12小时不同。

假定当前时间还是北京时间2020年11月10日21点，即2020-11-10T13:00:00Z，把上面的NOW换为当天日期函数TODAY： TODAY() - DATEVALUE("2020-11-10T19:00:00Z") 运算结果为0，因为减号左右两侧都是北京时间11月10号，但是如果假定当前时间为北京时间2020年11月10日早上7点的话，因为北京时间时区差8小时，TODAY()将输出为2020-11-09号，两者相减将得到-1（-24小时）。

无法在公式中确定用户的时区。如果您的所有用户都在同一时区，则可以通过加或减用户的时区和 GMT 之间的时差以调整时区差别为您的已转换值。然而，由于时区会受夏令时的影响，同时每年的 DST 开始和结束日期都不同，因此很难在公式中管理。

< 上一篇：如何创建自定义应用程序

下一篇: 自动执行业务流程 >

人工智能

企业应用

大数据

区块链

物联网

低代码

文档目录

本页目录