通用计算器插件

aki发表于:2017年08月25日 17:37:27更新于:2021年04月01日 16:38:47

概要

kintone的计算字段具有很强大的计算功能,除了四则运算,还可以对表格的某列进行合计、合并字符串、计算时间等。但实际业务中,特别是外贸、财务等等可能还会涉及到更加复杂的计算,比如对每个值进行四舍五入等,这时候kintone的计算字段就有点力不从心了。

  今天给大家介绍可对各个字段进行四舍五入的更加通用的计算器插件。

设置页面(设置范例)

※ 设置页面可根据登录用户设置的语言自动切换成中文、日文或英语。

00159a3a9a60f85131739b024c3af05

记录详情页面(编辑记录)

00159a3b1565a6f4caa3ef40de85ead

使用插件

STEP1:在应用中添加插件

在应用中添加通用计算器插件(Calc)。关于插件的添加方法,请参考kintone帮助。

添加插件

STEP2:设置插件

1.在应用管理页面中点击“插件”,
  然后点击通用计算器插件的齿轮图标。

2.设置各项。

项目名称说明
计算字段

选择用于显示计算结果的字段。

编辑可否

设置该行的计算字段是否可编辑。勾选时为不可编辑。

计算公式

输入计算公式。

可输入eval函数能处理的公式以及函数。公式中包含字段代码时,请用##字段代码##括起来。

例如,要计算A字段+B字段,计算结果四舍五入保留两位后,显示在C字段上时,在“计算字段”下拉框选择字段C,然后在“计算公式”栏输入:

Math.round(##A字段代码##+##B字段代码##*100)/100

事件触发字段

指定当哪些字段的值发生变更时执行计算。

Shift+鼠标点击:连续多选

Ctrl+鼠标点击:不连续多选

3.点击[保存]。

4.点击[应用的设置]页面上的[更新应用],插件的设置即可生效。

STEP2:使用插件

记录添加页面、记录编辑页面以及记录列表页面,确认设置为不可编辑的字段是否可编辑,是否当事件触发字段的值发生更改时会执行计算处理。
如不能正确计算,请检查输入的公式是否正确。

※ 在记录列表页面,因为表格内的数据不可编辑,因此即使表格内有字段被设为不可编辑或事件触发字段,也不执行任何处理。

范例插件

访问plugin-sdk ,下载整个文件夹。文件夹内的「examples/Calc」是这次要使用的文件包。
文件结构如下。

Calc/
 css/
   -config.css
   -51-modern-default.css
 html/
   -config.html
 image/
   -Calc.png
 js/
   -config.js
   -desktop.js
 manifest.json

请参考插件的开发步骤  打包 ,打包“Calc”。

更新信息

  • 于2017/09/08发布了ver1.01,更改了如下内容:
    在插件未设置的情况下,用户页面的console里会输出错误的问题。

  • 于2018/08/08发布了ver2.0,更改了如下内容:
    修复了部分bug。

其他限制事项

  • 不支持智能手机。

注意事项

  • 本范例程序,不保证运行绝对正确。

  • 另外不对本范例程序提供技术上的支持。

  • ⚠本程序使用eval函数来处理输入的公式,如使用不当具有一定危险性!
    比如您输入一些可调用外部服务API的代码或者循环调用kintone API的代码或其他具有危险性的代码,可能导致系统瘫痪或信息泄露等严重事件。
    请在知晓此危险性的前提下谨慎输入内容。如因为输入不当而导致的公司信息泄露、系统瘫痪以及一切可能引起的损失,才望子(cybozu)不予承担任何责任。

  • kintone的插件功能只可在标准版使用,简易版不可使用这点请大家注意一下。