Request address

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

Request message

Request parameter

required parameter:xmlData (required)

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

<info>

<refs>

 <ref>

  <path>test-db1</path>

  <type>db</type>

 </ref>

 <ref>

  <path>test_db2</path>

  <type>db</type>

 </ref>

</refs>

<identity>

 <ref>

  <type>user</type>

  <name>test</name>

 </ref>

 <ref>

  <type>group</type>

  <name>test_group</name>

  <parent>test_group1/test_group2</parent>

 </ref>

</identity>

</info>

parametric description

1) refs-ref-path (required): the path of the report to be shared.

2) refs-ref-type (required): the type of report: db.

3) identity-ref-type (required): the type of sharing the report to the node, including users and groups.

4) identity-ref-name (required): The name of the node to share the report with.

5) identity-ref-parent (optional): the path of the group when sharing the report to the group.

Description:

1) Multiple reports can be added to refs, multiple users and groups can also be added to identity, and multiple reports can be shared to multiple users/groups.

Sample

function shareDB() {

        var xml = getXml();

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

           {xmlData : xml},

           function(result) {        

              writeXml(result);

           });

     }}

Response message

Response result

1) Successful operation

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

 <results>

  <result>

   <level>1</level>

   <message>Share successful</message>

  </result>

</results>>

2) Operation failed

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

<results>

 <result>

  <level>6</level>

  <message>The Users, Groups or Roles "test" does not exist.</message>

 </result>

</results>

or

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

 <results>

  <result>

   <level>6</level>

   <message>The resource or operation "test_db1" could not be found. </message>

  </result>

 </results>

Result description

The response result information is xml. direct parse.

1) Level return type, different values represent different return status, see appendix.

2) Message is the interface operation result information.