页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。


Markdown
## 1.说明

在第三方系统中新建 Smartbi 的某种资源,其访问地址如下。通过在 URL 后带各种参数,创建不同类型的资源。

```html
http://localhost:18080/smartbi/vision/createresource.jsp
```

上述方式支持的资源类型有:数据模型、交互式仪表盘、即席查询、透视分析、自助ETL、WEB电子表格、数据挖掘、Excel导入模板、业务主题以及旧数据集(自助数据集、可视化数据集、原生SQL数据集、SQL数据集、JAVA数据集、存储过程数据集)、即席查询(旧)、透视分析(旧)、仪表分析、多维分析。

==使用旧数据集需拥有授权包含相应模块功能的License文件,否则会提示License验证失败,如尝试打开新建JAVA数据集:==

![License](https://wiki.smartbi.com.cn/download/attachments/51942608/image2021-8-26_17-26-38.png?version=1&modificationDate=1629970000000&api=v2)

## 2.基本参数

下面的三个参数是创建==任何资源类型==时,都必须传入的参数。但如果已经 [单点登录](https://wiki.smartbi.com.cn/pages/viewpage.action?pageId=51942631&src=contextnavpagetreemode) 过,就不需要在 URL 中再传递用户名和密码了,除非希望以一个新的用户去创建资源。

### 2.1基本参数描述

| 参数 | 描述 |
| ------ | ----------- |
| user | 登录 Smartbi 的用户名
| password | 登录 Smartbi 的密码
| restype | 资源类型。具体取值说明,请参看“附加参数”部分,资源分类说明表中的第三列 restype 值。

### 2.2基本参数使用示例
传递上述三个参数,创建 Smartbi 可视化数据集的访问地址,如下所示。

```html
http://localhost:18080/smartbi/vision/createresource.jsp?restype=VISUAL&user=admin&password=manager
```

![](https://wiki.smartbi.com.cn/download/attachments/51942608/%E5%88%9B%E5%BB%BA%20Smartbi%20%E5%8F%AF%E8%A7%86%E5%8C%96%E6%9F%A5%E8%AF%A2%E6%BC%94%E7%A4%BA.gif?version=1&modificationDate=1591605102000&api=v2)

## 3.可选参数
除了基本参数外,各种资源类型还有一些其它参数可供设置。分别说明如下。

| Field | Description |
| ------ | ----------- |
| resid | 指定资源ID,该值为空时新建资源,指定相应资源ID时则进入该资源的编辑界面
| saveFolderId | 保存资源的目录id,传递该参数后,保存资源时直接定位到该目录节点下
| sourceid | 表示基于以sourceid为资源ID的数据模型(或者旧数据集、业务主题、数据源)新建资源。
| bizqueryid | 业务查询ID,在新建分析报表时可以选用。如果bizqueryid为空,则出现选择已有数据集(包括可视化数据集、SQL数据集、存储过程数据集)的页面;否则直接进入新建分析报表页面。
| datasourceid | 对于业务查询是数据源ID,对于多维分析是立方体ID,新建业务查询和多维分析时可以选用。如果datasourceid为空,则出现选择数据源或立方体的页面;否则直接进入新建页面。
| bizthemeid | 业务主题ID,在新建业务查询时可以选用。如果bizthemeid为空,则出现选择业务主题的页面;否则直接进入新建业务查询的页面。


## 4.各资源类型对应的 restype 值及可选参数
restype 可取的值对应的各种资源类型,及其可选参数见下表:

| restype | 资源类型 | 可选参数 | 特别说明
| ------------ | ------------ | ----------- | -------------- |
| AUGMENTED_DATASET | 数据模型 |<li>resid</li><li>sourceid</li>| sourceid 为数据源id |
| SMARTBIX_PAGE | 交互式仪表盘 |<li>resid</li><li>sourceid</li><li>saveFolderId</li><li>isLargeScreen</li>| <li>sourceid 对应数据模型、旧数据集或者业务主题id</li><li>isLargeScreen=true(默认)为自由布局;isLargeScreen=false为自适应布局</li>
| DETAILED_QUERY | 即席查询 | <li>resid</li><li>sourceid</li><li>saveFolderId</li> | 无
| AD_HOC_ANALYSIS | 透视分析 | <li>resid</li><li>sourceid</li><li>saveFolderId</li> | 无
| SMARTBI_DATAPROCESS | 自助ETL | resid | 无
| WEB_SPREADSHEET_REPORT | WEB电子表格 | <li>resid</li><li>saveFolderId</li> | 无
| SMARTBI_MINING | 数据挖掘 | resid | 无
| excelimport | Excel导入模板 | 无 | 无
| themewizard | 业务主题 | saveFolderId | 无
| SMARTBIX_DATASET | 自助数据集 | 无 | 无
| VISUAL | 可视化数据集 | <li>datasourceid</li><li>bizthemeid</li><li>saveFolderId</li> | 无
| RAWSQL | 原生SQL数据集 | <li>datasourceid</li><li>saveFolderId</li> | 无
| SQL | SQL数据集 | <li>datasourceid</li><li>saveFolderId</li> | 无
| JAVA | JAVA数据集 | saveFolderId | 无
| PROC | 存储过程数据集 | <li>datasourceid</li><li>saveFolderId</li> | datasourceid对应存储过程ID
| COMBINED_QUERY | 即席查询(旧) | saveFolderId | 无
| INSIGHT | 透视分析 | saveFolderId | 无
| meter | 仪表分析 | saveFolderId | 无
| olap_report | 多维分析 | <li>datasourceid</li><li>saveFolderId</li> | 无


例如编辑业务主题资源:

```html
http://localhost:18080/smartbi/vision/createresource.jsp?restype=themewizard&resid=THEME.demo2019.CSAC
```

## 5.常见集成示例
### 5.1指定保存目录创建即席查询

```html
http://localhost:18080/smartbi/vision/createresource.jsp?restype=DETAILED_QUERY&saveFolderId=SELF_ADMIN
```

### 5.2指定数据模型创建自助仪表盘

```html
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBIX_PAGE&sourceid=I8aaa8015017d97839783ea38017d980a686901b2
```

### 5.3创建自适应布局自助仪表盘

```html
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBIX_PAGE&isLargeScreen=false
```

## 6.注意事项
新建存储过程数据集时,datasourceid 应该设置为存储过程ID,而不是数据源ID。存储过程ID可以通过点击存储过程的右键 **"属性 -> 节点ID"** 取得。

![](https://wiki.smartbi.com.cn/download/attachments/51942608/image2020-6-9%2015%3A37%3A24.png?version=1&modificationDate=1591688245000&api=v2)