维格是什么?
维格表(https://vika.cn/ )是“长得很像Excel电子表格的关系型数据库”(抄一下官方描述),你可以自由搭建多维表格,存储和管理各种类型(数字、字符串、布尔值、图片、文件等)的数据。
CoCo的控件商城之后会上线几个维格表相关的控件,你可以在维格表内创建表格存储和管理数据,通过控件在你创作的APP内新建、更新、读取、删除维格表的数据,强强联合!
使用步骤
一、注册账号
注册一个维格表账号: https://vika.cn/
二、创建数据表
在维格表中,按如下格式创建数据表:
第一列:列名为键,列类型为单行文本
第二列:列名为值,列类型为单行文本
第三列:列名为类型,列类型为单行文本(用于区分值为字数还是字符串,比如值为’123’(字符串)时,类型为空,值为123(数字)时,类型为1)
三、新增控件
打开 https://coco.codemao.cn/,在控件商城中添加维格云字典控件,添加成功后,拖入控件到舞台中新增控件实例。
从控件商城添加
四、设置控件
打开维格表,获取 API Token和表格ID
1、获取 API Token
- 登录维格表,点击左下角的个人头像,进入「用户中心」,前往「开发者配置」界面。
- 点击「+」号生成 API Token。注意:首次生成时需要绑定邮箱。
- 复制 API Token。
注意: 请妥善保管你的 API Token,如果 API Token 泄露,他人可能随意篡改你的表格中的数据。 如果 API Token 意外泄露,你可以在「开发者配置」界面重新生成 Token,保证数据安全。
2、获取表格 ID
打开一张维格表,在 URL 地址栏中找到以 dst 开头的一段字符串,便是这张维格表的 ID。
回到COCO编辑器,将获取到的 API Token 和 表格 ID 填写到属性面板中,就可以开始使用维格云表格啦~
五、编写代码
维格云字典的积木用法基本与云微数据库一致,不同的是有两种方式可以增删改查数据库:
- 缓存到本地再调用(积木带闪电图标,图上红框内)
- 直接调用云端(积木带云图标,图上蓝框)
第1种方式需要使用,从云端(维格表上看到的表格)拉取数据存到本地(如果在电脑上运行,则是缓存在浏览器缓存;如果是手机上运行,则是缓存在手机本地缓存),再使用从本地查询数据。
第2种方式则是直接从云端获取或更新数据,直接使用即可。
两种方式各有优缺点,适合不同的方式,你可以根据实际情况选择其中一种使用。
调用方式 | 优点 | 缺点 | 适用场景 |
---|---|---|---|
第一种 缓存本地 |
快速,不太受网络情况影响 | 本地数据和云端数据不实时同步,可以能存在一致导致出错 | - 数据更新频率低 - 实时性要求不高 - 网络环境差 |
第二种 调用云端 |
保证获取最新数据 | 比较慢,可能受网络环境影响 | - 数据更新频繁 - 要求获取实时数据 - 千万不要频繁调用(每个表格限制为5s/次),比如把它嵌入重复执行里 |
示例
在云字典中新建一个键值对:
修改字典中已经存在的键的值: