中文
概要
本篇向大家介绍快速显示汇率的插件。
之前制作出差报告、购买进口办公用品等需要使用到汇率的应用，使用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的插件功能只可在标准版使用，简易版不可使用这点请大家注意一下。
