请求地址

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>

参数描述

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

2）refs-ref-type(必填）：报告的类型：db。

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

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

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

说明：

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

示例

function shareDB() {

        var xml = getXml();

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

           {xmlData : xml},

           function(result) {        

              writeXml(result);

           });

     }

响应消息

响应结果

1）操作成功

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

<results>

 <result>

  <level>1</level>

  <message>分享成功</message>

 </result>

</results>>

2）操作失败

报告找不到

<?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即可。

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

2)message为接口操作结果信息。