中文
Index
概要
众所周知我们可以将文件上传至Kintone上，并随时随地的进行下载。但是随着业务量的逐渐增加，上传的文件量也随之增加，这时Kintone分配的存储空间就感觉有点不够用了。
为此，今天给大家带来一个小小的福利，那就是可以在Kintone APP内把文件上传至腾讯COS上，也可以根据需求随时在Kintone APP内进行下载。而且上传和下载速度很快哦！
什么是腾讯COS
腾讯COS即 “ 对象存储（Cloud Object Storage）”是由腾讯云推出的无目录层次结构、无数据格式限制、可容纳海量数据和文件且支持HTTP/HTTPS协议访问的分布式存储服务。
官方网址https://cloud.tencent.com/product/cos
如何使用插件
Step1: 在Kintone中导入插件
在Kintone中导入插件(Tencent Cos for Kintone)。关于插件的导入方法，请参考Kintone帮助文档在kintone中安装插件。
Step2: 在应用中添加插件
在应用中添加插件(Tencent Cos for Kintone)。关于插件的添加方法，请参考Kintone帮助文档在应用中添加插件。
Step3: 配置插件
Form设置
添加一个单行文本框，两个空白栏作为插件所需要的表单控件。
插件设置
1. 在应用管理页面中点击[插件]，然后点击Tencent Cos for Kintone插件的齿轮图标。
2. 设置如下图&表中的各项配置。
※ 设置页面可根据登录用户设置的语言自动切换成中文、或英语（日文语言时显示中文）。
项目名称 | 说明 |
|---|---|
COS 身份识别ID | 调用COS API所需要的身份识别ID，请从腾讯云平台设置后获取。详细参考下文 “COS的设置” 注意：该信息涉及安全性，请妥善保管。 |
COS 身份密钥 | 调用COS API所需要的身份识别密钥，请从腾讯云平台设置后获取。详细参考下文 “COS的设置” 注意：该信息涉及安全性，请妥善保管。 |
COS 存储桶名 | 文件保存的位置，请从腾讯云平台设置后获取。详细参考下文 “COS的设置” 注意：如果切换存储桶，则与APP中原始记录相对应的目录中的文件列表将不会正常显示，因为原始记录相对应的目录只存在于原先的存储桶下。 |
COS 地域信息 | 文件保存的地域，请从腾讯云平台设置后获取。详细参考下文 “COS的设置” 地域的选择，影响文件上传和下载的速度，上海地区一般选择ap-shanghai |
COS CDN地址 | 文件的CDN域名地址，请从腾讯云平台设置后获取。详细参考下文 “COS的设置” 为了减少下载所产生的流量费用，我们使用CDN分发的方式进行下载。 不包含HTTP或者HTTPS |
目录字段 | 选择目录所关联的App项目code, 项目类型为单行文本框 |
上传区域字段 | 选择上传区域所关联的App项目code, 项目类型为空白栏，该值不能和文件列表区域字段选择的值相同。 |
文件列表区域字段 | 选择文件列表区域所关联的 App项目code, 项目类型为空白栏，该值不能和上传区域字段选择的值相同。 |
3.点击[保存]。
4.点击[应用的设置]页面上的[更新应用]，插件的设置即可生效。
Step4：使用插件
1.创建文件夹
打开刚才使用了"Tencent Cos for Kintone"插件的APP记录添加页面，直接点击[保存]按钮（无需填写任何信息），一条腾讯COS关联的文件夹结构记录就生成了，并且此文件夹结构已自动同步到腾讯云COS上。（可以在腾讯云上”存储桶列表-->文件列表 “页面中看到新建的文件夹结构）。
文件夹格式：[AppId]/[LoginUserName]/[createdTime].
2. 文件上传
打开APP记录编辑页面，通过点击[Browser]按钮选择上传文件，点击[保存]按钮，文件上传至腾讯COS上。
3.文件下载与删除
打开APP记录详情页面，可以看到当前文件夹下的文件列表，可点击[下载]或[删除]按钮对文件进行操作。
COS的设置
在使用插件前，请先申请腾讯云账号并开启COS服务，接着我们需要配置自己的COS服务才能够让插件顺利运作。
腾讯云地址Link
详细的配置方法请参考官网Link
STEP1: 创建存储桶
1.在腾讯云控制平台点击[存储桶列表]，然后点击[创建存储桶]。
2. 设置各项目。
"所属区域": 根据自己所处的地域选择，影响上传和下载的速度。
"访问权限": 一般我们选择私有读写。
"存储桶标签": 随便填写。
"服务端加密": 一般我们选择不加密。
3.点击[确认]，保存存储桶信息。完成后我们记下”存储桶名“和“所属地域信息”，这两个信息需要设置到插件设定中。
STEP2：设置跨域请求
我们要设置跨域请求规则，才可以在Kintone中向COS发送请求，这一步很重要。
1.在腾讯云控制平台点击[存储桶列表]，选择刚才创建好的存储桶，点击[基础配置]，然后点击"跨域访问COSR设置"内的[添加规则]，按照下图范例进行设定。
2.点击[提交]
STEP3：生成身份密钥
我们需要生成COS身份密钥，才能在Kintone中调用COS的API，这一步也很重要。
在腾讯云控制平台点击[密钥管理]， 然后点击 [云API密钥]，接着点击 [新建密钥]，密钥就自动生成了。
完成后我们记下SecretId和SecretKey，要设置到插件设定中。
注意API密钥是构建腾讯云 API 请求的重要凭证，使用腾讯云 API 可以操作您名下的所有腾讯云资源，为了您的财产和服务安全，请妥善保存和定期更换密钥！
STEP4:设置CDN
由于COS的外网下行流量太过于昂贵，我们这里采用CDN分发的下载方式，费用可以节省很多。
在腾讯云控制平台点击[存储桶列表]，选择刚才创建好的存储桶, 点击 [域名管理]， 然后点击“默认 CDN 加速域名” 里的 [编辑]，开启CDN加速，并保存
完成后我们记下“源站域名”，要设置到插件设定中。
完成这4步后我们将所记录的SecretId，SecretKey，存储桶名称，所属地域信息，源站域名 设置到Tencent Cos for Kintone插件中后，就可以使用插件了。
最后
完成前面所有操作后，在Kintone中就有了一个类似“文件管理”的APP。可以通过分享记录的链接来共享文件信息。
如果您有使用过携带"文件管理"功能的OA协同办公类产品，此时想必已经知道如何熟练的在实际办公场景中运用这个APP。
资源下载
Tencent Cos for Kintone:
其它文件存储类服务整合插件
又拍云：源代码
注意事项
本插件不直接提供COS产品，请在使用本插件前自行购买腾讯COS产品，产生的费用一般包括，存储费用，CDN回源流量费用，API请求数费用。具体解释请参照官方Link
如果您在IE11浏览器下使用本插件，碰到文件列表不刷新，需要F5重新刷新的问题时，请修改IE设置 如下图
本示例代码不保证其运行。
我们不为本示例代码提供技术支持。
