概要
本篇向大家介绍快速显示汇率的插件。
之前制作出差报告、购买进口办公用品等需要使用到汇率的应用,使用lookup的话操作步骤比较多,数据量大时,就会显得麻烦且效率降低。有了这个插件,只需要制作一个汇率总表,安装此插件的应用连接这个表就能很方便快速的显示出汇率了。
功能概要如下。
可与另一应用“汇率录入表”(此应用名称可根据实际需要而定,以下“汇率录入表”即指此应用)关联。
可根据不同的时间或币种显示出相应的汇率值。
输入初始时间和币种就能自动显示汇率。
汇率可作为普通字段,或者是多个表格(subTable)内的字段。
添加子表行数可自由显示多个币种的汇率。
设置页面(设置范例)
记录编辑页面
记录列表编辑页面
设置汇率录入表
※ 请在使用此插件前务必制作“汇率录入表”,且字段代码需按上述设置,否则设置插件时会出错。
STEP1:设置表单
设置应用的表单。配置下面的字段。
项目名称 | 说明 |
---|---|
汇率开始日期 | ・日期类型的字段。 |
汇率结束日期 | ・日期类型的字段。 ・字段名称:汇率结束日期,可变换此名称。 ・字段代码:endDate。 ・必填项。 |
兑换币种 | ・字符串类型的字段。 ・字段名称:兑换币种,可变换此名称。 ・字段代码:currency。 ・必填项。 |
100外币换本货币汇率 | ・数值类型的字段。 ・字段名称:100外币换本货币汇率,可变换此名称。 ・字段代码:exchangeRate。 ・必填项。 |
STEP2:添加数据
给汇率录入表添加数据。
STEP3:AppID
记下此应用的AppID,待“自动显示汇率”插件关联时使用。
使用自动显示汇率插件
STEP1:设置表单
设置应用的表单。配置下面的字段。
结算日期字段(日期类型的字段)。
表格字段代码(表格类型)。
币种选择字段(单行文本框、单选框、下拉菜单类型的字段)。
汇率显示字段(数值类型的字段)。
STEP2:在应用中添加插件
在应用中添加自动显示汇率插件(可在后文的链接中下载)。关于插件的添加方法请参考kintone 帮助。
添加插件
STEP3:设置插件
在应用管理页面中点击“插件”,然后点击自动显示汇率插件的齿轮图标。
设置各项。
项目名称 说明 关联AppID ・输入需要关联的“汇率录入表”的应用ID。(请将之前记下的AppID填入)
・必填项。结算日期字段 ・日期类型的字段。
・汇率计算的时间点,比如出差日期、购买日期等。(用于查找此时间点所在时间段的汇率)
・必选项。
・应用列表编辑页面中不可编辑。表格(subTable)字段代码 ・表格类型。
・显示表格的字段代码。
・选了相应子表的字段代码,后续币种选择字段、汇率显示字段会显示此子表中含有的相应格式的字段。
・可选项。
※ 如选择表格字段代码,如:出差费用subTable,后续2个选择项将显示该表格(subTable)字段(币种选择字段、汇率显示字段)。
※ 如不选择(默认值“-----”),后续2个选择项将显示非表格字段。币种选择字段 ・单行文本框、单选框、下拉菜单类型的字段。
・显示需要兑换的币种。
・单选框、下拉菜单类型需要预先设置内容。比如:“美元”、“欧元”等。
※ 此字段所填或所选内容必须与“汇率录入表”的“兑换币种”字段内数据的内容相一致。
比如:此字段中的数据内容是“美元”,“汇率录入表”的“兑换币种”字段中的数据内容是“美元(USD)”,2个字段内容不一致就无法匹配到正确的汇率数据。
・根据“表格(subTable)字段代码”的选择内容显示相应内容(在表格内或不在表格内)。
・必选项。汇率显示字段 ・数值类型的字段。
・显示汇率的字段。
・根据“表格(subTable)字段代码”的选择内容显示相应内容(在表格内或不在表格内)。
・必选项。
・应用中不可编辑。按下“保存”按钮。
在”应用的设置“页面,完成“更新应用”,插件的设置即生效。
STEP4:使用插件
记录添加或编辑页面时的处理
“结算日期”默认显示当前日期或上一次保存的日期,可编辑。
“币种”默认空或上一次保存的数据,可编辑。
“汇率”禁用,无法编辑。
记录添加或编辑页面更改字段值时的处理
在添加或编辑“结算日期”或“币种”记录后,“汇率”会立即显示相应的汇率数据。
如无法找到相应数据,汇率字段的内容显示为“0”。
例如更改“结算日期”为“2018-01-01”时,若“汇率录入表”无此日期数据,汇率字段的内容显示为“0”。
记录添加或编辑页面增加子表行时的处理
“汇率”禁用,无法编辑。
记录列表页面的行内编辑开始时的处理
“结算日期”显示上一次保存的日期,禁用,无法编辑。
“币种”显示上一次保存的数据,可编辑。
“汇率”显示上一次保存的数据,禁用,无法编辑。
记录列表页面更改字段值时的处理
更改“币种”后,“汇率”会立即显示对应汇率数据。
如无法找到相应数据,汇率字段的内容显示为“0”。
例如更改“币种”为“英镑”时,若“汇率录入表”无此币种数据,汇率字段的内容显示为“0”。
范例插件
访问plugin-sdk,其中的 “automatic_exchange_rate_display” 是这次要使用的文件包。
“automatic_exchange_rate_display”的文件结构如下。
automatic_exchange_rate_display/ css/ -51-current-default.css -config.css html/ -config.html image/ -icon.png -ico_warn.png js/ -config.js -customize.js manifest.json
请参考插件的开发步骤 打包 ,打包 “automatic_exchange_rate_display” 。
限制事项
不可在智能手机上使用。
注意事项
本范例程序,不保证运行绝对正确。
另外不对本范例程序提供技术上的支持。
本插件是在新风格的基础上做成的,在旧风格是使用可能会有处理异常的情况,请注意。
※kintone的插件功能只可在标准版使用,简易版不可使用这点请大家注意一下。