Dans l'essai précédent ? Développement C# du portail et de l'application WeChat (17) - Gestion du département de gestion du carnet d'adresses et développement du compte d'entreprise WeChat ?, la gestion des opérations pertinente du département du carnet d'adresses a été présentée. gestion et gestion des membres., gestion des balises en trois parties, cet article présente principalement les opérations de gestion des membres, y compris plusieurs points clés des opérations tels que la création, la suppression, la mise à jour, l'obtention et l'obtention des membres du département.

1. Opération de création de membres

Pour plus de commodité, nous pouvons créer une structure organisationnelle départementale, qui est une condition préalable au développement. Car la gestion de notre carnet d'adresses repose également sur une structure organisationnelle, tout comme le niveau de structure organisationnelle présenté dans l'article précédent. Ici, je crée une structure racine de Guangzhou Aiqidi, puis j'y crée des structures organisationnelles, comme le montre la figure ci-dessous.

Vous pouvez ajouter des personnes via des opérations fonctionnelles en arrière-plan. Cet article présente principalement comment appeler l'API du compte WeChat Enterprise pour les opérations de gestion du personnel.

La définition API du créateur est la suivante.

• Instructions de demande

Méthode de demande HTTPS?: POST

https://qyapi.weixin.qq. com/cgi-bin/user/create?access_token=ACCESS_TOKEN

La structure du package de requête est?:

{
???"userid":?"zhangsan",
???"name":?"張三",
???"department":?[1,?2],
???"position":?"產(chǎn)品經(jīng)理",
???"mobile":?"15913215421",
???"gender":?1,
???"tel":?"62394",
???"email":?"zhangsan@gzdev.com",
???"weixinid":?"zhangsan4dev"
}

• Description du paramètre

• 權(quán)限說明

管理員須擁有“操作通訊錄”的接口權(quán)限，以及指定部門的管理權(quán)限。

• 返回結(jié)果

{
???"errcode":?0,
???"errmsg":?"created"
}

?我們在C#里面，需要定義對應(yīng)給的接口，然后根據(jù)需要構(gòu)造對應(yīng)的傳遞實體信息。

這里我把人員管理的接口全部定義好，接口定義如下所示。

????????#region?部門成員管理????????///?<summary>
????????///?創(chuàng)建成員????????///?</summary>
????????CommonResult?CreateUser(string?accessToken,?CorpUserJson?user);????????///?<summary>
????????///?更新成員????????///?</summary>
????????CommonResult?UpdateUser(string?accessToken,?CorpUserUpdateJson?user);????????///?<summary>
????????///?刪除成員????????///?</summary>
????????CommonResult?DeleteUser(string?accessToken,?string?userid);????????///?<summary>
????????///?根據(jù)成員id獲取成員信息????????///?</summary>
????????CorpUserGetJson?GetUser(string?accessToken,?string?userid);????????///?<summary>
????????///?獲取部門成員????????///?</summary>
????????CorpUserListJson?GetDeptUser(string?accessToken,?int?department_id,?int?fetch_child?=?0,?int?status?=?0);????????#endregion

然后根據(jù)信息定義，創(chuàng)建一個承載人員信息的CorpUserJson實體對象，創(chuàng)建人員的實現(xiàn)操作代碼如下所示。

????????///?<summary>
????????///?創(chuàng)建成員????????///?</summary>
????????public?CommonResult?CreateUser(string?accessToken,?CorpUserJson?user)
????????{????????????string?urlFormat?=?"http://m.miracleart.cn/{0}";????????????var?data?=?new
????????????{
????????????????userid?=?user.userid,
????????????????name?=?user.name,
????????????????department?=?user.department,
????????????????position?=?user.position,
????????????????mobile?=?user.mobile,
????????????????gender?=?user.gender,
????????????????tel?=?user.tel,
????????????????email?=?user.email,
????????????????weixinid?=?user.weixinid
????????????};????????????var?url?=?string.Format(urlFormat,?accessToken);????????????var?postData?=?data.ToJson();????????????return?Helper.GetCorpExecuteResult(url,?postData);
????????}

?

2、成員的更新操作

成員的數(shù)據(jù)更新和創(chuàng)建操作類似，它的企業(yè)號定義如下所示。

• 請求說明

Https請求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token=ACCESS_TOKEN

請求包示例如下（如果非必須的字段未指定，則不更新該字段之前的設(shè)置值）:

{
???"userid":?"zhangsan",
???"name":?"李四",
???"department":?[1],
???"position":?"后臺工程師",
???"mobile":?"15913215421",
???"gender":?1,
???"tel":?"62394",
???"email":?"zhangsan@gzdev.com",
???"weixinid":?"lisifordev",
???"enable":?1
}

由于它的操作數(shù)據(jù)類似，因此它的實現(xiàn)代碼也差不多，如下所示就是。

????????///?<summary>
????????///?更新成員????????///?</summary>
????????public?CommonResult?UpdateUser(string?accessToken,?CorpUserUpdateJson?user)
????????{????????????string?urlFormat?=?"http://m.miracleart.cn/{0}";????????????//string?postData?=?user.ToJson();
????????????var?data?=?new
????????????{
????????????????userid?=?user.userid,
????????????????name?=?user.name,
????????????????department?=?user.department,
????????????????position?=?user.position,
????????????????mobile?=?user.mobile,
????????????????gender?=?user.gender,
????????????????tel?=?user.tel,
????????????????email?=?user.email,
????????????????weixinid?=?user.weixinid,
????????????????enable?=?user.enable
????????????};????????????var?url?=?string.Format(urlFormat,?accessToken);????????????var?postData?=?data.ToJson();????????????return?Helper.GetCorpExecuteResult(url,?postData);
????????}

?

3、成員的刪除、成員的獲取、部門成員的獲取操作

這些操作和上面的類似，不在贅述，主要就是根據(jù)需要定義他們對應(yīng)的返回數(shù)據(jù)信息，然后解析Json數(shù)據(jù)即可轉(zhuǎn)換為對應(yīng)的實體。

1）刪除人員的定義如下：

• 請求說明

Https請求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/delete?access_token=ACCESS_TOKEN&userid=lisi

• 參數(shù)說明

• 返回結(jié)果

{
???"errcode":?0,
???"errmsg":?"deleted"
}

2）成員的獲取定義如下：

• 請求說明

Https請求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&userid=lisi

• 參數(shù)說明

• 返回結(jié)果

{
???"errcode":?0,
???"errmsg":?"ok",
???"userid":?"zhangsan",
???"name":?"李四",
???"department":?[1,?2],
???"position":?"后臺工程師",
???"mobile":?"15913215421",
???"gender":?1,
???"tel":?"62394",
???"email":?"zhangsan@gzdev.com",
???"weixinid":?"lisifordev",??
???"avatar":?"http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
???"status":?1
}

3）部門成員的獲取定義如下：

• 請求說明

Https請求方式: GET

https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=1&fetch_child=0&status=0

• 參數(shù)說明

• 權(quán)限說明

管理員須擁有’獲取部門成員’的接口權(quán)限，以及指定部門的查看權(quán)限。

• 返回結(jié)果

{
???"errcode":?0,
???"errmsg":?"ok",
???"userlist":?[
???????????{
??????????????????"userid":?"zhangsan",
??????????????????"name":?"李四"
???????????}
?????]
}

這個返回值我們定義一個實體對象用來存儲數(shù)據(jù)即可。

????///?<summary>
????///?獲取部門成員返回的數(shù)據(jù)????///?</summary>
????public?class?CorpUserListJson?:?BaseJsonResult
????{????????public?CorpUserListJson()
????????{????????????this.userlist?=?new?List<corpusersimplejson>();
????????}????????///?<summary>
????????///?返回的錯誤消息????????///?</summary>
????????public?CorpReturnCode?errcode?{?get;?set;?}????????///?<summary>
????????///?對返回碼的文本描述內(nèi)容????????///?</summary>
????????public?string?errmsg?{?get;?set;?}????????///?<summary>
????????///?成員列表????????///?</summary>
????????public?List<corpusersimplejson>?userlist?{?get;?set;?}
????}</corpusersimplejson></corpusersimplejson>

?

7、綜合例子調(diào)用代碼

上面介紹了一些企業(yè)號的接口定義和我對API的C#封裝接口和部分實現(xiàn)代碼，實現(xiàn)了功能后，我們就可以在代碼中對它進行測試，確信是否正常使用。

????????///?<summary>
????????///?人員管理綜合性操作（創(chuàng)建、修改、獲取信息、刪除）????????///?</summary>
????????///?<param>
????????///?<param>
????????private?void?btnCorpUser_Click(object?sender,?EventArgs?e)
????????{
????????????CorpUserJson?user?=?new?CorpUserJson();
????????????user.userid?=?"test";
????????????user.name?="測試用戶";
????????????user.department?=?new?List<int>(){2};
????????????user.email?=?"test@163.com";

????????????ICorpAddressBookApi?bll?=?new?CorpAddressBookApi();
????????????CommonResult?result?=?bll.CreateUser(token,?user);????????????if?(result?!=?null)
????????????{
????????????????Console.WriteLine("創(chuàng)建成員:{0}?{1}?{2}",?user.name,?(result.Success???"成功"?:?"失敗"),?result.ErrorMessage);????????????????string?name?=?"修改測試";
????????????????user.name?=?name;
????????????????CorpUserUpdateJson?userUpdate?=?new?CorpUserUpdateJson(user);
????????????????result?=?bll.UpdateUser(token,?userUpdate);????????????????if?(result?!=?null)
????????????????{
????????????????????Console.WriteLine("修改名稱:{0}?{1}?{2}",?name,?(result.Success???"成功"?:?"失敗"),?result.ErrorMessage);
????????????????}

????????????????CorpUserGetJson?userGet?=?bll.GetUser(token,?user.userid);????????????????if?(userGet?!=?null)
????????????????{
????????????????????Console.WriteLine("成員名稱:{0}?({1}?{2})",?userGet.name,?user.userid,?user.email);
????????????????}

????????????????result?=?bll.DeleteUser(token,?user.userid);????????????????if?(result?!=?null)
????????????????{
????????????????????Console.WriteLine("刪除成員:{0}?{1}?{2}",?name,?(result.Success???"成功"?:?"失敗"),?result.ErrorMessage);
????????????????}
????????????}
????????}</int>

獲取部門人員的操作代碼如下所示。

????????///?<summary>
????????///?獲取部門人員????????///?</summary>
????????private?void?btnCorpUserList_Click(object?sender,?EventArgs?e)
????????{????????????int?deptId?=?1;
????????????ICorpAddressBookApi?bll?=?new?CorpAddressBookApi();
????????????CorpUserListJson?result?=?bll.GetDeptUser(token,?deptId);????????????if?(result?!=?null)
????????????{????????????????foreach(CorpUserSimpleJson?item?in?result.userlist)
????????????????{
????????????????????Console.WriteLine("成員名稱:{0}?{1}",?item.name,?item.userid);
????????????????}
????????????}
????????}

?

更多Développement C# du portail et de lapplication WeChat - Gestion des membres de la gestion du carnet dadresses et développement du compte dentreprise WeChat相關(guān)文章請關(guān)注PHP中文網(wǎng)！