1.4 添加组

<< Click to Display Table of Contents >>

当前位置:  系统集成 > WebAPI 

1.4 添加组

Previous pageReturn to chapter overviewNext page

请求地址

http://ip:port/bi/api?action=saveNode&type=group&token=xxxx

请求消息

请求参数

请求参数:xmlData(必填)

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

<info>

 <group>

         <name>testgroup</name>

         <parent>g1</parent>

         <roles>role1,role2</roles>

 </group>

</info>

参数描述

请求参数为组信息:

1)name(必填):组名称,组名不能为特殊字符“\ /:*?"<>|;,.”。

2)parent(添加根目录下的组时不填,添加组下的组时必填):组所在的上级组,必须是系统存在的组。

3)roles(选填):包含的角色,必须是系统存在的角色,多个以逗号分隔,如:role1,role2,role3。

示例

function addGroup() {

  var xml = getXml();

  $.post("http://" + ip + ":" + port + "/" + project + "/api?action=saveNode&type=group&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>组已经存在。</message>

  </result>

</results>

或者

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

<results>

  <result>

         <level>6</level>

         <message>文件夹“g3"找不到。</message>

  </result>

</results>

结果描述

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

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

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