[//]:use-markdown
## 1.说明
在第三方系统中新建 Smartbi 的某种资源,其访问地址如下。通过在 URL 后带各种参数,创建不同类型的资源。
```
http://localhost:18080/smartbi/vision/createresource.jsp
```
上述方式支持的资源类型有:数据模型、业务主题、即席查询、透视分析、自助ETL、Excel导入模板、自助仪表盘、WEB电子表格、数据挖掘以及旧数据集(自助数据集、可视化数据集、原生SQL数据集、SQL数据集、JAVA数据集、存储过程数据集)、仪表分析、多维分析、页面定制。
上述方式支持的资源类型有:数据模型、交互式仪表盘、即席查询、透视分析、自助ETL、WEB电子表格、数据挖掘、Excel导入模板、业务主题以及旧数据集(自助数据集、可视化数据集、原生SQL数据集、SQL数据集、JAVA数据集、存储过程数据集)、即席查询(旧)、透视分析(旧)、仪表分析、多维分析。
==使用旧数据集需拥有授权包含相应模块功能的License文件,否则会提示License验证失败,如尝试打开新建JAVA数据集:==

## 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 可视化数据集的访问地址,如下所示。
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=VISUAL&user=admin&password=manager
```

## 3.附加参数可选参数
除了基本参数外,各种资源类型还有一些其它参数可供设置。分别说明如下。
| Field | Description |
| ------ | ----------- |
| bizqueryid resid | 业务查询ID,在新建分析报表时可以选用。如果bizqueryid为空,则出现选择已有数据集(包括可视化数据集、SQL数据集、存储过程数据集)的页面;否则直接进入新建分析报表页面。指定资源ID,该值为空时新建资源,指定相应资源ID时则进入该资源的编辑界面
| datasourceid saveFolderId | 对于业务查询是数据源ID,对于多维分析是立方体ID,新建业务查询和多维分析时可以选用。如果datasourceid为空,则出现选择数据源或立方体的页面;否则直接进入新建页面。保存资源的目录id,传递该参数后,保存资源时直接定位到该目录节点下
| bizthemeid sourceid | 业务主题ID,在新建业务查询时可以选用。如果bizthemeid为空,则出现选择业务主题的页面;否则直接进入新建业务查询的页面。表示基于以sourceid为资源ID的数据模型(或者旧数据集、业务主题)新建资源。
| saveFolderId bizqueryid | 保存资源的目录id,传递该参数后,保存资源时直接定位到该目录节点下业务查询ID,在新建分析报表时可以选用。如果bizqueryid为空,则出现选择已有数据集(包括可视化数据集、SQL数据集、存储过程数据集)的页面;否则直接进入新建分析报表页面。
| resid datasourceid | 指定资源ID,该值为空时新建资源,指定相应资源ID时则进入该资源的编辑界面对于业务查询是数据源ID,对于多维分析是立方体ID,新建业务查询和多维分析时可以选用。如果datasourceid为空,则出现选择数据源或立方体的页面;否则直接进入新建页面。
| subtype | 只对交互式仪表盘有效。当在链接中增加“subtype=big”时新建的是自由布局的交互式仪表盘。restype 可获取的值对应的各种资源类型,及其可选参数见下表:bizthemeid | 业务主题ID,在新建业务查询时可以选用。如果bizthemeid为空,则出现选择业务主题的页面;否则直接进入新建业务查询的页面。
## 4.各资源类型对应的 restype 值及可选参数
restype 可取的值对应的各种资源类型,及其可选参数见下表:
| restype | 资源类型 | 可选参数 | 特别说明
| ------------ | ------------ | ----------- | -------------- |
| VISUAL | 可视化数据集 | datasourceid、bizthemeid、saveFolderId | 无
| SQL | SQL数据集 | datasourceid、saveFolderId | 无
| RAWSQL | 原生SQL数据集 | datasourceid、saveFolderId | 无
| JAVA | JAVA数据集 | saveFolderId | 无
| PROC | 存储过程数据集 | datasourceid、saveFolderId | datasourceid对应存储过程ID
| SMARTBIX_DATASET | 自助数据集 | saveFolderId AUGMENTED_DATASET | 数据模型 | resid | resid为空时新建资源,指定相应资源ID时进入该资源的编辑界面
| SMARTBIX_PAGE | 交互式仪表盘 | resid、sourceid | resid 为空时新建资源,指定相应资源ID时进入该资源的编辑界面。
| DETAILED_QUERY | 即席查询 | resid、saveFolderId、sourceid | resid 为空时新建资源,指定相应资源ID时进入该资源的编辑界面。
| AD_HOC_ANALYSIS | 透视分析 | resid、saveFolderId、sourceid | resid 为空时新建资源,指定相应资源ID时进入该资源的编辑界面。
| SMARTBI_DATAPROCESS | 自助ETL | resid | resid为空时新建资源,指定相应资源ID时进入该资源的编辑界面
| WEB_SPREADSHEET_REPORT | WEB电子表格 | saveFolderId、resid | resid 为空时新建资源,指定相应资源ID时进入该资源的编辑界面。
| SMARTBI_MINING | 数据挖掘 | resid | resid为空时新建资源,指定相应资源ID时进入该资源的编辑界面
| excelimport | Excel导入模板 | 无 | 无
| themewizard | 业务主题 | saveFolderId | 无
| SMARTBI_DATAPROCESS | 自助ETL | resid | resid为空时新建资源,指定相应资源ID时进入该资源的编辑界面
| AUGMENTED_DATASET | 数据模型 | saveFolderId、resid | resid为空时新建资源,指定相应资源ID时进入该资源的编辑界面
| SMARTBI_MINING | 数据挖掘 | resid | resid为空时新建资源,指定相应资源ID时进入该资源的编辑界面
| meter | 仪表分析 SMARTBIX_DATASET | 自助数据集 | 无 | 无
| VISUAL | 可视化数据集 | datasourceid、bizthemeid、saveFolderId | 无
| RAWSQL | 原生SQL数据集 | datasourceid、saveFolderId | 无
| SQL | SQL数据集 | datasourceid、saveFolderId | 无
| JAVA | JAVA数据集 | saveFolderId | 无
| olap_report PROC | 多维分析 存储过程数据集 | datasourceid、saveFolderId | 无datasourceid对应存储过程ID
| COMBINED_QUERY | 即席查询 即席查询(旧) | saveFolderId | 无
| INSIGHT | 透视分析 | saveFolderId | 无
| SMARTBIX_PAGE meter | 交互式仪表盘 仪表分析 | resid、subtype | resid 为空时新建资源,指定相应资源ID时进入该资源的编辑界面。在新建自助仪表盘的基础上,当“subtype=big”时指定交互式仪表盘为自由布局,不传递时为自适应布局。saveFolderId | 无
| WEBolap_SPREADSHEET_REPORT report | WEB电子表格 多维分析 | saveFolderId、resid | resid 为空时新建资源,指定相应资源ID时进入该资源的编辑界面。
| excelimport | Excel导入模板 | 无 | 无datasourceid、saveFolderId | 无
例如编辑业务主题资源:
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=themewizard&resid=THEME.demo2019.CSAC
```
## 4.注意事项
新建存储过程数据集时,datasourceid 应该设置为存储过程ID,而不是数据源ID。存储过程ID可以通过点击存储过程的右键 **"属性 -> 节点ID"** 取得。

## 5.集成示例常见集成示例
### 5.1数据模型
① 新建数据模型
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=AUGMENTED_DATASET
```
② 编辑数据模型
```
```
### 5.2自助数据集
① 新建自助数据集
1指定数据模型创建自助仪表盘
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBIX_DATASET
```
② 编辑自助数据集
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBIX_DATASET&resid=Iff80808101651d3f1d3fd3fb01651dcd3cdf0125PAGE&sourceid=I8aaa8015017d97839783ea38017d980a686901b2
```
### 5.3自助仪表盘① 新建自助仪表盘2指定保存目录创建即席查询
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBIX_PAGE
```
② 编辑自助仪表盘
格式为:http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBIX_PAGE&resid=【替换为需要编辑的资源ID】
```
```
③ 新建大屏可视化
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBIX_PAGE&subtype=big
```
④ 编辑大屏可视化
```
```
### 5.4自助ETL
① 新建自助ETL资源
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBI_DATAPROCESS
```
② 编辑自助ETL资源
```
```
### 5.5数据挖掘
① 新建数据挖掘
```
http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBI_MINING
```
② 编辑数据挖掘
格式为:http://localhost:18080/smartbi/vision/createresource.jsp?restype=SMARTBI_MINING&resid=【替换为需要编辑的资源ID】
```
```DETAILED_QUERY&saveFolderId=SELF_ADMIN
```
## 6.注意事项
新建存储过程数据集时,datasourceid 应该设置为存储过程ID,而不是数据源ID。存储过程ID可以通过点击存储过程的右键 **"属性 -> 节点ID"** 取得。
