微信企业号开发(4)--管理通讯录(部门)

 [本文所描述的内容具有一定的时效性,请以实际开发所处环境为准]

迟到一天,非常抱歉,今天我们来讲解微信企业号中通讯录的管理。相比于其他微信公众号,企业号的通讯录功能是特殊存在的,它对应于我们企业内部实际的上下级关系。当然,作为一个管理工具,我们也可以将它为我们所用,而忽略这种限制。

-------------------------------------------------------------------------------------------------------------------------------------

正文开始:

在通讯录管理这部分中,我们发现其下的大部分功能实现都是类似的,因此,我们在此只给出一个部门创建的实例。希望各位读者能够自行举一反三,原理其实是一模一样的,就只有POST数据不同而已,所以请不要偷懒哦。

1.首先,来看企业号官方文档对创建部门的要求

微信企业号开发(4)--管理通讯录(部门)_第1张图片

惯例,重点内容,我们在回顾一遍:

http方法:POST

url地址:https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN

参数格式:JSON数据。是否必须,见上图。

2.首先,我们来看看JAVA如何将我们的参数封装成上述需求的函数。这里请大家注意,我们的代码请尽可能的包含有用的注释,这样在使用的时候便不用反复寻找方法调用的规范等,养成良好的代码规范,才能更好的在团队协作中,合作共赢。

	/**
	 * 创建部门
	 * @param name 部门名称。长度限制为1~64个字符
	 * @param parentid 父亲部门id。根部门id为1
	 * @param order 在父部门中的次序值。order值小的排序靠前。
	 * @param id 部门id,整型。指定时必须大于1,不指定时则自动生成
	 * */
	public String createDepartment(String name , String parentid,String order,String id){
		String Postjson = "{\"name\": %s,\"parentid\": %s,\"order\": %s,\"id\": %s}";
		return String.format(Postjson, name,parentid,order,id);
	}

3.有了数据封装函数,现在就可以调用微信的接口了。这里我们需要使用到微信企业号开发(2)--建立连接(主动)中的HttpRequest方法,在此,我们就不再写出这段代码,想要这部分代码的同学请翻看上面的这篇博文。

4.最后我们在给出单元测试的伪代码。注意,我们的URL都是默认大家已经正确填写,AccessToken也是正确获取的,获取方式同样请参见上文中AccessToken的获取

//示例
//	public static void main(String[] args) {
//		/**
//		 * 创建部门示例
//		 * */
//		// 调取凭证
//		//参见微信企业号开发(2)
//		// 拼装数据
//		String PostData = createDepartment("新建部门", "2","可以省略","可以省略");
//		// 提交数据,获取结果
//		//调用HttpRequest方法。
//		// 打印结果
//		if(0==result){
//			System.out.println("操作成功");
//		}
//		else {
//			System.out.println("操作失败");
//		}
//	}

5.运行测试main方法之后,应该能够看到微信后台对我们的服务请求给出的返回结果。如果发生错误,请大家参照企业号开发者接口文档中全局返回码的错误进行修改即可

-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

至此,微信企业号开发(4)--管理通讯录(部门)结束。


特别说明:

虽然微信相关开发的文档满天飞,博主所写的也不是优秀的实现。但是如果大家觉得这些文章有意义的话,请静下心来,多花1个小时时间认真理解其中一个的实现过程,后续的开发便会非常容易。谢谢大家!

参考资料:

[1]微信公众平台开发者文档:http://mp.weixin.qq.com/wiki/home/index.html

[2]企业号开发者接口文档:http://qydev.weixin.qq.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5





你可能感兴趣的:(微信公众号)