【基础教程】创建带参数的数据表（数据模型）

[大泰格]

1、新建系统变量

          系统变量：系统内置变量值，可在创建SQL表时任意使用该变量进行动态SQL编写。

          系统变量表Ibps. bi_system_variable，新建时type=‘Custom’、key和默认value必填，已存在的可以共用。

          现有系统变量如下：

注：各应用平台内置有预制参数，如果需要新建参数，请联系相应平台的管理员。

2、新建数据表

          下图中查询的变量值${org_id}就是上面表中的system_key用[]括起来。表中默认值是05，这里预览的查询结果就是查询extend1=05的数据。

 

3、建立数据模型

          没有其他区别，和其他建模一样

       

5、通过自主分析工具中参数传递

         

          1）选中需要绑定数据的组件；

          2）选中“组件”属性面板中的“数据”面板；

          3）数据面板中的“查询变量”即为SQL表的参数传递配置项；

          4）配置项可以传递两种参数：静态值、画面参数（如绑定画面参数，则画面参数更变时会自动重新拉取数据）。

 

6、通过接口调用

请求方式	Post
请求Url	/bi/data/model/previewData
请求参数:
字段名	类型	中文描述	说明
id	String	模型ID（必传）
systemVariables	String	变量（必传）
showLineNum	Int	返回数量（必传）
返回参数:
字段名	类型	中文描述	说明
code	Int	状态	成功：0
data	array	数据【根据模型不同返回不同数组】
date	string	时间
message	String	信息

          请求参数格式如下：

{"showLineNum":100,"id":"8aaa82037b056d0b017b05b5618c0006","systemVariables":"[{\"id\":\"${org_id}\",\"value\":\"00\"}]"}

          返回格式：（数据做了部分脱敏）

          返回值：

{
  "code": 0,
  "data": "[{\"id_\":\"1\",\"party_type_\":\"org\",\"party_alias_\":\"00\",\"name_\":\"有限公司\",\"parent_id_\":\"0\",\"path_\":\"1\",\"depth_\":1,\"create_by_\":\"1\",\"create_time_\":\"2020-07-07 11:37:28.123\",\"update_by_\":\"1\",\"update_time_\":\"2021-07-29 09:30:58.926\",\"sn_\":999,\"extend1\":\"00\"}]",
  "date": "2021-08-02 15:21:05",
  "message": "查询成功!"
}