BaaS使用指南


目录

BaaS介绍


BaaS是Backend as a Service的缩写,是后端即服务的意思。BaaS给移动应用开发者提供可选的基础服务,如在线数据库、在线文件存储。

应用key


应用key页面用来查看与设置应用的身份信息。可以查看App Id,App Key,Master Key,并且可以点击“重置”来重新生成一个Master Key。

  • App Id:每个应用都有全局唯一的Id,不可变更。
  • App Key:每个应用有一个唯一的Key,适应于所有平台,用于应用的基本安全认证。
  • Master Key:适用于所有平台,并不受权限设定限制,拥有的权限超过App Key( 相当于超级管理员,请不要泄露哦! )。

应用key

短信服务


短信模板类型(type): 开发者可任意混合使用各个模板(即:重置密码时可以用 类型:login(登录短信模板)等)

  • repwd:重置密码短信模板,reg:注册短信模板,login:登录短信模板,default:默认短信模板。

短信服务

邮件服务


邮件模板类型(type): 注册用户邮箱验证模板,重设密码邮件模板。

邮件服务

安全中心


安全中心用来查看和设置数据存储服务SDK的访问权限。
设置说明:

  • 允许通过api接口修改数据库结构:开启了此选项后,通过 Master Key 使用SDK可以对表、表的列进行调整。如:删除表、修改列等功能。如未开启,则只能通过网页控制台操作。
  • 允许一般用户修改数据库结构:开启了此选项后,不用通过 Master Key 即可对表、表的列进行调整。如:删除表、修改列等功能。
  • 短信服务:只有开启了此选项,才能在手机注册、手机验证码重置密码、手机登录功能中使用短信功能。
  • 邮件服务:只有开启了此选项,才能使用邮箱功能。

安全中心

应用设置


应用设置页面包含多项应用权限的选项设置。

短信相关设置:

  • 禁止未验证手机号码用户登录:控制未进行手机绑定的用户登录。
  • 允许用户使用手机短信登录:用于忘记密码等情况。
  • 启用短信验证服务(针对 validmobile 接口):开启了此选项,才能用 validmobile(短信验证) 接口。
  • 开启自动修改用户电话,手机状态:开启了此选项后,用户修改电话号码时,需要重新认证。
  • 开启通过用户名,邮箱,电话登录:开启了此选项后,用户可以用用户名、邮箱、电话任意一种方式登陆。
  • 禁止未验证邮箱登录:开启了此选项后,用户注册邮箱未验证前,是不能登陆的。

应用设置

数据服务-新建表


1.点击左侧菜单中的“创建表”按钮,弹出新建表对话框,如图:

新建表

2.填写创建表信息,点击“创建表”按钮,在左侧菜单中将会显示新建表的信息,如图:

新建表成功

注:表名是4-24个字母、数字和下划线组成,且必须以字母开头。

数据服务-删除表


1.点击列表上方“更多”按钮后->弹出菜单选项->点击“删除表”,弹出删除表确认对话框,点击“确定”按钮,将删除本表及表中的数据,如图:

删除表

删除表成功

数据服务-添加列


1.点击列表上方的“添加列”按钮,弹出添加列对话框,如图:

添加列

2.按要求填写添加列信息,点击“添加列”按钮,在下方列表中将会看到新添加的列,如图:

添加列成功

注:列名是4-24个字母、数字和下划线组成,且必须以字母开头。

数据服务-编辑列


1.点击需编辑列右侧的 倒三角 按钮,弹出按钮菜单,如图:

编辑列

2.点击“编辑”按钮,弹出列的编辑对话框,用户可修改除表字段名和类型外的其他字段信息,如图:

编辑列对话框


数据服务-删除列


1.点击需删除列右侧的 倒三角 按钮,弹出按钮菜单,点击“删除”按钮,弹出确认删除对话框,点击“确定”按钮,将删除本列及本列下的数据,如图:

删除列

删除列确认框

注:系统内置的列"_id"、“_edtm”,“_euser”不可删除。

数据服务-添加行


1.点击列表上方的“添加行”按钮,弹出添加行对话框,如图:

添加行弹窗

2.按要求填写完成,点击“确定”按钮,在列表中将会看到这条数据。如图:

添加行成功

注:“_id”作为表的唯一标识,需要用户填写;其他列是用户自己添加的,需按要求填写。

数据服务-删除行


1.在列表中选择需要删除的行(可全选)后,点击上方的“删除行”按钮,将弹出删除确认提示框,如图:

删除行

数据服务-清空表


1.点击上方“更多”按钮后->弹出菜单选项->点击“清空表”,弹出清空表确认对话框,点击“确定”按钮,将清空当前表的数据,如图:

清空表

清空表确认框

数据服务-导入表


1.点击上方“更多”按钮后->弹出菜单选项->点击“导入表”,弹出导入表对话框,如图:

导入表

导入表弹窗

2.选择导入的数据,必须是.json的文件,点击“确定”按钮后,即可查看导入的数据,如图:

导入数据成功

注:导入的数据必须是json格式的,不超过20M,如果导入的列多于表中的列,将在表中新建该列。

格式如:

{
  "cloud": [
    {
      "_id": "cbc8d02e12eac07e998f6411",
      "name": "李四",
      "_cdtm": 1456983856,
      "_cuser": "686433047582736384",
      "_edtm": 1456983856,
      "_euser": "686433047582736384",
      "_tabname": "705264245708947456_Class"
    },
    {
      "_id": "cc0e1c2e12eac07e998f6656",
      "name": "王五",
      "_cdtm": 1456983889,
      "_cuser": "686433047582736384",
      "_edtm": 1456983889,
      "_euser": "686433047582736384",
      "_tabname": "705264245708947456_Class"
    },
    {
      "_id": "cbc8d02e12eac07e998f6456",
      "name": "张三",
      "_cdtm": 1456984014,
      "_cuser": "686433047582736384",
      "_edtm": 1456984014,
      "_euser": "686433047582736384",
      "_tabname": "705264245708947456_Class"
    }
  ],
  "count": 3
}  

数据服务-导出表


1.点击上方“更多”按钮后->弹出菜单选项表->点击“导出库”,弹出导出库对话框,如图:

导出表

2.选择时间区间及要导出的表,如果没有选择将默认导出所有表中的所有数据,点击“确定”按钮即可。

导出表确认框

注:导出的数据将会发送到用户预留的邮箱中。

数据服务-设置字段显示


目的:用于屏蔽不需要显示的字段。

1.点击右上方 三横线 按钮,弹出 设置需要显示的列 对话框,如图:

设置字段按钮

设置需要显示的列弹窗

2.选择需要屏蔽的字段,点击保存后,效果如图:

设置需要显示的列成功

数据服务-收缩展开


1.点击右上方“收缩展开”按钮,可收缩展开页面视图,如图:

展开

收缩

数据服务-条件查询


1.点击上方“查询”按钮后,弹出查询条件对话框,如图:

查询按钮

查询弹窗

注:查询条件中间栏有3个选项:第一个选项为字段名称,第二个选项为查询符号,第三个选项为查询字段值。

2.弹出窗口右上方“中文/English”为查询符号的中文/英文的切换按钮。

  • 例如:单击“中文”按钮,下列第二个选择下拉框中所有的符号变为中文显示,如图: 查询符号切换(中文)

  • 单击“English”按钮,下列第二个选择下拉框中所有的符号变为英文显示,如图: 查询符号切换(英文)

2.查询字段类型为: 字符串(String)时,查询符号有:等于、不等于、存在、不存在、以此开头、以此结尾。例如:“_id”,如图: 字符串的所有类型

整数(Number)时,查询符号有:等于、不等于、存在、不存在、小于、大于、小于等于、大于等于。例如:自定义字段“_edtm”,如图: 整数的所有类型

布尔(Boolean)时,查询符号有:等于、不等于、存在。例如:自定义字段“boolean”,如图: 布尔的所有类型

数组(Array)时,查询符号有:存在、不存在、包含字符串、不包含字符串、包含数字、不包含数字。例如:自定义字段“array”,如图: 数组的所有类型

对象(Object)时,查询符号有:等于、不存在。例如:自定义字段“object”,如图: 对象的所有类型

日期(Date)时,查询符号有:等于、不等于、存在、不存在、小于、大于、小于等于、大于等于。例如:自定义字段“object”,如图: 日期的所有类型

一对一(Oto)时,查询符号有:等于、不等于、存在、不存在。例如:自定义字段“c_oto”,如图: 一对一的所有类型

一对多(Otm)时,查询符号有:存在、不存在。例如:自定义字段“c_otm”,如图: 一对一的所有类型

3.查询示例: 3.1 查询“_id”等于 0001的结果集。如图: 描述

成功返回数据,如图: 描述

3.2 查询“_id”不等于 0001的结果集。如图: 描述

成功返回数据,如图: 描述

3.3 查询“testColumnExist”存在 的结果集。

1.首先,增加测试字段“testColumnExist”; 2.其次,编辑相应行字段“testColumnExist”的值。如图: 描述

3.查询“testColumnExist”存在 的结果集,如图: 描述 成功返回数据,如图: 描述

4.查询“_edtm”小于 1457340994 的结果集,如图: 描述 成功返回数据,如图: 描述

5.查询“_id” 以 “0”开头的结果集。 5.1 先增加测试数据:如图: 描述

查询“_id” 以 “0”开头的结果集。如图: 描述 成功返回数据,如图: 描述

6.查询“_id” 以 “1”结尾的结果集。如图: 描述

成功返回数据,如图: 描述

7.多条件查询。如图: 描述

成功返回数据,如图: 描述

数据服务-一对一


定义:A 表中的一组数据与B表中一组数据具有关联关系,他们的关系为一对一关系。且对应关系必然是一张表中的一个属性值对应另外一张表的_id属性的值。

例:

新建两张表class001和class002。class001中的一个字段c_oto (自定义字段名称,类型为Oto,关联表为class002),其值为class002表中指定的_id值,获取表class002中指定_id的一条数据。具体操作如下:

首先为class002添加几条数据,这次的目的是获取_id为c2_001的这条数据:

Images

然后为class001添加一列,添加一对一字段步骤:

1、选择类型:Oto

Images

2、选择关联表:class002

Images

Images

3、新增字段成功:

Images

添加一行: 其中表示一对一关系字段c_oto的值只能是其所关联表中数据的_id,当要设置c_oto为空时,不填任何值。

下图所示c_oto的值是class002中的数据的_id:

Images

添加一行成功:

Images

这是表class001的数据,当单击c_oto的值时出现的是其关联的数据:

Images

数据服务-一对多


定义:A表中的一组数据与B表中多组数据具有关联关系,他们的关系为一对多关系。且对应关系必然是一张表中的一个属性值对应另外一张表的多组_id属性的值。

例:

新建一张表通过class003,通过class003中的一个字段c_otm (自定义名称),其中值是一个数组,数组每个元素都是class002表中一行的_id,在表class002中获取,class003中字段c_otm值所指定class002中_id的每条数据。

具体操作如下,添加一列,创建一对多字段,操作步骤:

1、选择类型一对多:Otm

Images

2、选择关联表:class002

Images

Images

添加成功:

Images

添加一行: 其中表示一对多关系字段c_otm的值只能是其所关联表中数据的_id,当要设置c_otm为空时,不填任何值。

下图所示c_otm的值是class002中的数据的_id,以数组表示:

Images

Images

当单击c_otm的值时出现的是其关联的数据:

Images

数据服务-权限设置


注:权限设置只对 REST API 接口起作用!!!

       权限验证过滤时,先验证“黑名单”,再验证“白名单”

  1. 首先进入数据服务页面,选择存储表下面需要设置的,点击更多菜单下的权限设置按钮,弹出相关表权限设置弹窗。如图:

alt text

弹窗左侧栏列出了对该表现有的相关操作权限:

  • cretae:创建权限
  • delete:删除权限
  • find:查询权限(一组)
  • get:查询权限(一条)
  • edit:编辑权限

5种操作权限默认都是public权限(即所有人都可执行该操作)。

点击左侧任意权限菜单,切换至设置页面,如图:

alt text

白名单(黑名单)分为 所有用户指定用户

  • 所有用户:即当前权限(左侧栏已选中的权限)对所有人开放;
  • 指定用户:特指某一类用户。具体又分为角色用户,如图:

alt text

alt text

这里的 角色_role 表中的角色, 用户_user 表中的用户。 输入框中输入用户名或_id时,有相关智能提示,如图:

alt text

添加用户自定义指定角色至白名单(黑名单)中:

alt text

“角色”又分为 登陆用户用户私有

  • 登陆用户:即所有登陆的用户才有对该表的相关操作权限
  • 用户私有:即只有当前用户才有对该表的相关操作权限

alt text

alt text

添加用户自定义指定用户至白名单(黑名单)中:

alt text