请求地址

http://ip:port/bi/api?action=shareDB&token=xxxx

请求消息

请求参数

请求参数：xmlData（必填）

<?xml version="1.0" encoding="UTF-8"?>

<info>

<refs>

<ref>

 <path>test-报告</path>

 <type>db</type>

</ref>

<ref>

 <path>test_分享</path>

 <type>db</type>

</ref>

</refs>

<identity>

<ref>

 <type>user</type>

 <name>test</name>

</ref>

<ref>

 <type>group</type>

 <name>测试组</name>

 <parent>测试组1/测试组2</parent>

</ref>

</identity>

</info>

参数描述

•refs-ref-path(必填)：需要分享的报告的路径。

•refs-ref-type(必填）：报告的类型，参数值包括db、adb、vividdb、portalCell（10.1开始支持adb、vividdb、portalCell）。

db：分析报告。

adb：即席分析报告。

vividdb：大屏报告。

portalCell：组合报告。

•identity-ref-type（必填）：将报告分享给节点的类型，包括用户、组。

•identity-ref-name（必填）：将报告分享给节点的名称。

•identity-ref-parent（选填）：将报告分享给组时，组的路径。

➢说明：

refs中可以添加多个报告，identity中也可以添加多个用户、组，支持将多个报告分享给多个用户/组。

示例

function shareDB() {

       var xml = getXml();

       $.post("http://" + ip + ":" + port + "/" + project + "/api?action=shareDB&token=xxxx",

          {xmlData : xml},

          function(result) {        

             writeXml(result);

          });

    }

响应消息

响应结果

•操作成功

<?xml version="1.0" encoding="UTF-8"?>

<results>

<result>

 <level>1</level>

 <message>分享成功</message>

</result>

</results>>

•操作失败

报告找不到

<?xml version="1.0" encoding="UTF-8"?>

<results>

<result>

<level>6</level>

<message>资源或操作“test_报告”找不到。</message>

</result>

</results>

用户或者组不存在

<?xml version="1.0" encoding="UTF-8"?>

<results>

<result>

<level>6</level>

<message>安全设置中包含不存在的用户、组或角色：test</message>

</result>

</results>

结果描述

响应结果信息为xml，直接parse即可。

•level 返回类型，不同数值代表不同返回状态，见附录。

•message为接口操作结果信息。