1.81给用户添加/删除组

<< Click to Display Table of Contents >>

当前位置:  部署与集成 > WebAPI 

1.81给用户添加/删除组

复制链接

支持的版本:10.0及以后

请求地址

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

请求消息

请求参数

请求参数:xmlData(必填)

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

<info>

<type>add</type>

<users>

       <user>

           <name>test1</name>

        </user>

       <user>

           <name>test1</name>

       </user>

</users>

<groups>

     <group>

          <name>测试组</name>

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

     </group>

     <group>

          <name>a组</name>

         <parent>a组1</parent>

   </group>

</groups>

</info>

参数描述

type:add表示给用户添加组,delete表示给用户移除组,移除组只是移除这部分用户和这些组的关联关系,不会删除组。

users:需要配置组的用户。

users-user-name:配置需要设置组的用户的用户名。

groups:需要给users中的用户添加/移除的组。

goups-group-parent:配置需要添加/移除的组的上级分组,如果这个分组直接处于根目录则此项填空。

groups-group-name:配置需要添加/移除的组的名称。

示例

function setUsersGroups() {

  var xml = getXml();

  $.post("http://" + ip + ":" + port + "/" + project + "/api?action=setUsersGroups&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>配置失败,用户{0}重复</message>

  </result>

</results>

操作失败,不存在需要配置的用户

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

<results>

  <result>

         <level>6</level>

         <message>配置失败,用户{0}不存在</message>

  </result>

</results>

操作失败,不存在的组路径

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

<results>

  <result>

         <level>6</level>

         <message>配置失败,路径{0}不存在</message>

  </result>

</results>

配置失败,不存在的组

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

<results>

  <result>

         <level>6</level>

         <message>配置失败,目标路径下不存在组{0}</message>

  </result>

</results>

结果描述

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

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

message为接口操作结果信息。