自动显示汇率插件

betsy_yan发表于:2017年11月24日 11:07:45更新于:2021年04月01日 16:36:31

概要

本篇向大家介绍快速显示汇率的插件。
之前制作出差报告、购买进口办公用品等需要使用到汇率的应用,使用lookup的话操作步骤比较多,数据量大时,就会显得麻烦且效率降低。有了这个插件,只需要制作一个汇率总表,安装此插件的应用连接这个表就能很方便快速的显示出汇率了。
功能概要如下。

  • 可与另一应用“汇率录入表”(此应用名称可根据实际需要而定,以下“汇率录入表”即指此应用)关联。

  • 可根据不同的时间或币种显示出相应的汇率值。

  • 输入初始时间和币种就能自动显示汇率。

  • 汇率可作为普通字段,或者是多个表格(subTable)内的字段。

  • 添加子表行数可自由显示多个币种的汇率。

设置页面(设置范例)

0015a7018d23c365fe7f39c4421dd87

记录编辑页面

0015a17a8ddcf918687f2fc44c6dc6b

记录列表编辑页面

0015a581bfba3df30cc02b28115d852

设置汇率录入表

※ 请在使用此插件前务必制作“汇率录入表”,且字段代码需按上述设置,否则设置插件时会出错。

STEP1:设置表单

设置应用的表单。配置下面的字段。

项目名称说明
汇率开始日期

・日期类型的字段。
・字段名称:汇率开始日期,可变换此名称。
・字段代码:startDate。
・必填项。

汇率结束日期・日期类型的字段。
・字段名称:汇率结束日期,可变换此名称。
・字段代码:endDate。
・必填项。
兑换币种・字符串类型的字段。
・字段名称:兑换币种,可变换此名称。
・字段代码:currency。
・必填项。
100外币换本货币汇率・数值类型的字段。
・字段名称:100外币换本货币汇率,可变换此名称。
・字段代码:exchangeRate。
・必填项。

0015a17ae1f9d2f91f5578fe866d0b8

STEP2:添加数据

给汇率录入表添加数据。

0015a17bc55778fa56e29d9f29af5be

STEP3:AppID

记下此应用的AppID,待“自动显示汇率”插件关联时使用。

0015a56c459b0f507e9e6e1541ff36d

使用自动显示汇率插件

STEP1:设置表单

设置应用的表单。配置下面的字段。

  • 结算日期字段(日期类型的字段)。

  • 表格字段代码(表格类型)。

  • 币种选择字段(单行文本框、单选框、下拉菜单类型的字段)。

  • 汇率显示字段(数值类型的字段)。

STEP2:在应用中添加插件

在应用中添加自动显示汇率插件(可在后文的链接中下载)。关于插件的添加方法请参考kintone 帮助。
添加插件

STEP3:设置插件

  1. 在应用管理页面中点击“插件”,然后点击自动显示汇率插件的齿轮图标。

  2. 设置各项。

    项目名称说明
    关联AppID・输入需要关联的“汇率录入表”的应用ID。(请将之前记下的AppID填入)
    ・必填项。
    结算日期字段・日期类型的字段。
    ・汇率计算的时间点,比如出差日期、购买日期等。(用于查找此时间点所在时间段的汇率)
    ・必选项。
    ・应用列表编辑页面中不可编辑。
    表格(subTable)字段代码・表格类型。
    ・显示表格的字段代码。
    ・选了相应子表的字段代码,后续币种选择字段、汇率显示字段会显示此子表中含有的相应格式的字段。
    ・可选项。
        ※ 如选择表格字段代码,如:出差费用subTable,后续2个选择项将显示该表格(subTable)字段(币种选择字段、汇率显示字段)。
        ※ 如不选择(默认值“-----”),后续2个选择项将显示非表格字段。

    币种选择字段・单行文本框、单选框、下拉菜单类型的字段。
    ・显示需要兑换的币种。
    ・单选框、下拉菜单类型需要预先设置内容。比如:“美元”、“欧元”等。
        ※ 此字段所填或所选内容必须与“汇率录入表”的“兑换币种”字段内数据的内容相一致。
            比如:此字段中的数据内容是“美元”,“汇率录入表”的“兑换币种”字段中的数据内容是“美元(USD)”,2个字段内容不一致就无法匹配到正确的汇率数据。
    ・根据“表格(subTable)字段代码”的选择内容显示相应内容(在表格内或不在表格内)。
    ・必选项。
    汇率显示字段・数值类型的字段。
    ・显示汇率的字段。
    ・根据“表格(subTable)字段代码”的选择内容显示相应内容(在表格内或不在表格内)。
    ・必选项。
    ・应用中不可编辑。

    按下“保存”按钮。

  3. 在”应用的设置“页面,完成“更新应用”,插件的设置即生效。

STEP4:使用插件

记录添加或编辑页面时的处理

  • “结算日期”默认显示当前日期或上一次保存的日期,可编辑。

  • “币种”默认空或上一次保存的数据,可编辑。

  • “汇率”禁用,无法编辑。

记录添加或编辑页面更改字段值时的处理

  • 在添加或编辑“结算日期”或“币种”记录后,“汇率”会立即显示相应的汇率数据。

  • 如无法找到相应数据,汇率字段的内容显示为“0”。

  • 例如更改“结算日期”为“2018-01-01”时,若“汇率录入表”无此日期数据,汇率字段的内容显示为“0”。

0015a582d4304980895abb7e5a3c27b

记录添加或编辑页面增加子表行时的处理

  • “汇率”禁用,无法编辑。

记录列表页面的行内编辑开始时的处理

  • “结算日期”显示上一次保存的日期,禁用,无法编辑。

  • “币种”显示上一次保存的数据,可编辑。

  • “汇率”显示上一次保存的数据,禁用,无法编辑。

记录列表页面更改字段值时的处理

  • 更改“币种”后,“汇率”会立即显示对应汇率数据。

  • 如无法找到相应数据,汇率字段的内容显示为“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的插件功能只可在标准版使用,简易版不可使用这点请大家注意一下。