使用“Tencent Cos for Kintone” 插件实现腾讯云+kintone文件管理

cybozu发表于:2020年05月20日 11:31:40更新于:2021年04月01日 15:23:48

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设置

    添加一个单行文本框,两个空白栏作为插件所需要的表单控件。

    0015ec4a19983b2f7d7101e18b301bc

    插件设置

    1. 在应用管理页面中点击[插件],然后点击Tencent Cos for Kintone插件的齿轮图标。

    2. 设置如下图&表中的各项配置。

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

    0015ec4a2823ad6223e051d0bd358d8

项目名称

说明

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上。

0015ec4d06a4b317d81e9455289f772

    3.文件下载与删除

    打开APP记录详情页面,可以看到当前文件夹下的文件列表,可点击[下载]或[删除]按钮对文件进行操作。

COS的设置

在使用插件前,请先申请腾讯云账号并开启COS服务,接着我们需要配置自己的COS服务才能够让插件顺利运作。

腾讯云地址Link

详细的配置方法请参考官网Link

STEP1: 创建存储桶

0015ec4d2396d8a70764581f0d184ec

    1.在腾讯云控制平台点击[存储桶列表],然后点击[创建存储桶]。

    2. 设置各项目。

        "所属区域":      根据自己所处的地域选择,影响上传和下载的速度。

        "访问权限":      一般我们选择私有读写。

        "存储桶标签":  随便填写。

        "服务端加密":  一般我们选择不加密。

    3.点击[确认],保存存储桶信息。完成后我们记下”存储桶名“和“所属地域信息”,这两个信息需要设置到插件设定中。

    0015ec4d4c0104f11fed3df85275c31

STEP2:设置跨域请求

我们要设置跨域请求规则,才可以在Kintone中向COS发送请求,这一步很重要。

    1.在腾讯云控制平台点击[存储桶列表],选择刚才创建好的存储桶,点击[基础配置],然后点击"跨域访问COSR设置"内的[添加规则],按照下图范例进行设定。

0015ec4d5eea9b959a3e45d088ae9df

    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设置 如下图0015ec4db21189ef43a712ca9bd2909

  • 本示例代码不保证其运行。

  • 我们不为本示例代码提供技术支持。

    注意:贴代码时请注意格式并使用"代码语言",与本文无关的问题请至“讨论社区”提问。