跳到主要内容

工作表分享

可将工作表按照用户或用户组进行分享管理。

添加分享人/组​

定义：把工作表分享给人/组
接口：/tb/add_share

请求参数格式：

字段含义格式备注
tb_id工作表idstring必填
user_ids用户id列表json/list选填（user_ids和group_ids至少填写一项）
group_ids组id列表json/list选填（user_ids和group_ids至少填写一项）
col_filter列过滤条件json/list选填，默认分享所有列
row_filter行过滤条件string选填，过滤条件与与sql语法一致

post数据示例如下： 

{
    "tb_id": "tb_392c17f271b342ffa5a2da20fb77daed",
    "user_ids": "["id_123","id_456"]"
    "group_ids": "["9d4d816e4189251690d6711bad697f29"]",
    "col_filter": "["fk7cceb55e", "fkab2f3bde", "fk9f3e0f7e"]",
    "row_filter": "fk5a5fcd69 > 10"
}

返回值：

{
    "status": "0",
    "errstr": "",
    "result": "",
    "trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}

错误代码说明：
21：无工作表访问权限；

删除分享人/组​

定义：删除工作表的分享人/组
接口：/tb/del_share

请求参数格式：

字段含义格式备注
tb_id工作表idstring必填
user_ids用户id列表json/list选填（user_ids和group_ids至少填写一项）
group_ids组id列表json/list选填（user_ids和group_ids至少填写一项）

post数据示例如下： 

{
    "tb_id": "tb_392c17f271b342ffa5a2da20fb77daed",
    "user_ids": "["id_123","id_456"]"
    "group_ids": "["9d4d816e4189251690d6711bad697f29"]"
}

返回值：

{
    "status": "0",
    "errstr": "",
    "result": "",
    "trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}

错误代码说明： 19005：工作表被使用，无法取消分享；

修改分享表过滤条件​

定义：修改已分配出去的工作表的过滤方式

接口：/tb/modify_share

请求参数格式：

字段含义格式备注
tb_id工作表idstring必填
user_ids用户id列表json/list选填（user_ids和group_ids至少填写一项）
group_ids组id列表json/list选填（user_ids和group_ids至少填写一项）
col_filter列过滤条件json/list选填，默认分享所有列
row_filter行过滤条件string选填，过滤条件与与sql语法一致

post数据示例如下：

{
    "tb_id": "tb_392c17f271b342ffa5a2da20fb77daed",
    "user_ids": "["id_123","id_456"]"，
    "group_ids": "["9d4d816e4189251690d6711bad697f29"]",
    "col_filter": "["fk7cceb55e", "fkab2f3bde", "fk9f3e0f7e"]",
    "row_filter": "fk5a5fcd69 > 10"
}

返回值：

{
    "status": "0",
    "errstr": "",
    "result": "",
    "trcid": "1af069f4-bc91-3068-83d1-1f791f7dac88"
}

错误代码说明： 31005：SQL过滤条件不正确；