狠狠色丁香婷婷综合尤物/久久精品综合一区二区三区/中国有色金属学报/国产日韩欧美在线观看 - 国产一区二区三区四区五区tv

LOGO OA教程 ERP教程 模切知識(shí)交流 PMS教程 CRM教程 開發(fā)文檔 其他文檔  
 
網(wǎng)站管理員

C#開發(fā)微信門戶及應(yīng)用(17)-微信企業(yè)號(hào)的通訊錄管理開發(fā)之部門管理

admin
2014年12月2日 0:59 本文熱度 5423
前面一篇隨筆企業(yè)號(hào)的一些基礎(chǔ)信息,以及介紹如何配置企業(yè)號(hào)的回調(diào)方式實(shí)現(xiàn)和企業(yè)號(hào)服務(wù)器進(jìn)行溝通的橋梁。本篇主要還是繼續(xù)介紹企業(yè)號(hào)的開發(fā)工作的開展,介紹微信企業(yè)號(hào)通訊錄管理開發(fā)功能,介紹其中組織機(jī)構(gòu)里面如何獲取和管理部門的信息等內(nèi)容。

 1、企業(yè)組織的創(chuàng)建和配置


首先我們可以在企業(yè)號(hào)的管理后臺(tái)里面創(chuàng)建一個(gè)組織機(jī)構(gòu),里面創(chuàng)建一些部門和人員列表,方便我們開發(fā)和使用。


例如創(chuàng)建一個(gè)廣州愛奇迪的根結(jié)構(gòu),然后在其中在創(chuàng)建一些組織機(jī)構(gòu),如下圖所示。



然后給組織結(jié)構(gòu)根節(jié)點(diǎn)“廣州愛奇迪”增加一個(gè)管理員權(quán)限,以后再開發(fā)接口里面也就可以使用這個(gè)管理員所屬的權(quán)限Secret值進(jìn)行調(diào)用了。



CorpID是企業(yè)號(hào)的標(biāo)識(shí),每個(gè)企業(yè)號(hào)擁有一個(gè)唯一的CorpID;Secret是管理組憑證密鑰。
系統(tǒng)管理員可通過管理端的權(quán)限管理功能創(chuàng)建管理組,分配管理組對(duì)應(yīng)用、通訊錄、接口的訪問權(quán)限。完成后,管理組即可獲得唯一的secret。系統(tǒng)管理員可通過權(quán)限管理查看所有管理組的secret,其他管理員可通過設(shè)置中的開發(fā)者憑據(jù)查看。


我的企業(yè)號(hào)的創(chuàng)建者和“廣州愛奇迪”組織結(jié)構(gòu)的管理員是不同的,由于Secret是管理組憑證密鑰,因此管理者負(fù)責(zé)不同的組織機(jī)構(gòu)管理的話,自己的管理Secret值可能就不同了。如果我們需要調(diào)用接口,就需要用到這個(gè)屬于自己權(quán)限級(jí)別的Secret值,如下圖所示。



 如果不是企業(yè)號(hào)的創(chuàng)建者,那么可能不能修改里面的一些權(quán)限分配,只能查看。



2、API訪問的全局唯一票據(jù)AccessToken的獲取


和公眾號(hào)一樣,我們調(diào)用企業(yè)號(hào)API的第一步也是需要先獲取訪問的票據(jù)AccessToken。這個(gè)票據(jù)是全局性的,有一定的時(shí)效和頻率控制,因此需要適當(dāng)?shù)倪M(jìn)行緩存,不能每次調(diào)用都去刷新獲取。


企業(yè)號(hào)獲取訪問票據(jù)的主要的邏輯代碼如下所示,其主要的就是需要使用管理者的Secret值去獲取對(duì)應(yīng)的口令,這樣它就能夠知道管理的是那個(gè)組織結(jié)構(gòu)的了。



復(fù)制代碼
        /// <summary>
/// 獲取每次操作微信API的Token訪問令牌
/// </summary>
/// <param name="corpid">企業(yè)Id</param>
/// <param name="corpsecret">管理組的憑證密鑰</param>
/// <returns></returns>
public string GetAccessTokenNoCache(string corpid, string corpsecret)
{
var url = string.Format("https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={0}&corpsecret={1}",
corpid, corpsecret);
HttpHelper helper
= new HttpHelper();
string result = helper.GetHtml(url);
string regex = "\"access_token\":\"(?<token>.*?)\"";
string token = CRegex.GetText(result, regex, "token");
return token;
}

復(fù)制代碼

微信企業(yè)號(hào)的說明如下所示:


當(dāng)企業(yè)應(yīng)用調(diào)用企業(yè)號(hào)接口時(shí),企業(yè)號(hào)后臺(tái)為根據(jù)此次訪問的AccessToken,校驗(yàn)訪問的合法性以及所對(duì)應(yīng)的管理組的管理權(quán)限以返回相應(yīng)的結(jié)果。


注:你應(yīng)該審慎配置管理組的權(quán)限,夠用即好,權(quán)限過大會(huì)增加誤操作可能性及信息安全隱患。


AccessToken是企業(yè)號(hào)的全局唯一票據(jù),調(diào)用接口時(shí)需攜帶AccessToken。AccessToken需要用CorpIDSecret來換取,不同的Secret會(huì)返回不同的AccessToken。正常情況下AccessToken有效期為7200秒,有效期內(nèi)重復(fù)獲取返回相同結(jié)果,并自動(dòng)續(xù)期。由于獲取access_token的api調(diào)用次數(shù)非常有限,建議企業(yè)全局存儲(chǔ)與更新access_token,頻繁刷新access_token會(huì)導(dǎo)致api調(diào)用受限,影響自身業(yè)務(wù)


 


2、通訊錄管理之部門信息的維護(hù)


有了第一節(jié)里面的訪問票據(jù),我們就可以利用API來做很多事情了,包括組織結(jié)構(gòu)的獲取、創(chuàng)建、刪除等等功能。


創(chuàng)建部門的官方接口定義如下所示。



  • 請(qǐng)求說明

Https請(qǐng)求方式: POST


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


請(qǐng)求包結(jié)構(gòu)體為:

{
"name": "郵箱產(chǎn)品組",
"parentid": "1"
}


  • 參數(shù)說明


















參數(shù) 必須 說明
access_token 調(diào)用接口憑證
name 部門名稱。長(zhǎng)度限制為1~64個(gè)字符
parentid 父親部門id。根部門id為1

 



  • 返回結(jié)果
{
"errcode": 0,
"errmsg": "created",
"id": 2
}

根據(jù)上面的一些類似的接口定義說明,我們先來定義下組織機(jī)構(gòu)部門數(shù)據(jù)的維護(hù)接口,然后在逐步實(shí)現(xiàn)和調(diào)用。



復(fù)制代碼
        #region 部門管理
/// <summary>
/// 創(chuàng)建部門。
/// 管理員須擁有“操作通訊錄”的接口權(quán)限,以及父部門的管理權(quán)限。
/// </summary>
CorpDeptCreateJson CreateDept(string accessToken, string name, string parentId);
/// <summary>
/// 更新部門。
/// 管理員須擁有“操作通訊錄”的接口權(quán)限,以及該部門的管理權(quán)限。
/// </summary>
CommonResult DeleteDept(string accessToken, int id);
/// <summary>
/// 刪除部門.
/// 管理員須擁有“操作通訊錄”的接口權(quán)限,以及該部門的管理權(quán)限。
/// </summary>
CorpDeptListJson ListDept(string accessToken);
/// <summary>
/// 獲取部門列表.
/// 管理員須擁有’獲取部門列表’的接口權(quán)限,以及對(duì)部門的查看權(quán)限。
/// </summary>
CommonResult UpdateDept(string accessToken, int id, string name);
#endregion

復(fù)制代碼

如創(chuàng)建部門的接口實(shí)現(xiàn)如下所示,主要就是構(gòu)建URL和POST的數(shù)據(jù)包,然后統(tǒng)一調(diào)用并獲取返回?cái)?shù)據(jù),轉(zhuǎn)換為具體的Json對(duì)象實(shí)體即可。其他接口的實(shí)現(xiàn)方式類似,不在贅述。



復(fù)制代碼
        /// <summary>
/// 創(chuàng)建部門。
/// 管理員須擁有“操作通訊錄”的接口權(quán)限,以及父部門的管理權(quán)限。
/// </summary>
public CorpDeptCreateJson CreateDept(string accessToken, string name, string parentId)
{
string urlFormat = "https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token={0}";
var data = new
{
name
= name,
parentId
= parentId
};
var url = string.Format(urlFormat, accessToken);
var postData = data.ToJson();
CorpDeptCreateJson result
= CorpJsonHelper<CorpDeptCreateJson>.ConvertJson(url, postData);
return result;
}

復(fù)制代碼

CorpDeptCreateJson 對(duì)象實(shí)體類的定義如下所示,我們主要是根據(jù)返回結(jié)果進(jìn)行定義的。



復(fù)制代碼
    /// <summary>
/// 創(chuàng)建部門的返回結(jié)果
/// </summary>
public class CorpDeptCreateJson : BaseJsonResult
{
/// <summary>
/// 返回的錯(cuò)誤消息
/// </summary>
public CorpReturnCode errcode { get; set; }
/// <summary>
/// 對(duì)返回碼的文本描述內(nèi)容
/// </summary>
public string errmsg { get; set; }
/// <summary>
/// 創(chuàng)建的部門id。
/// </summary>
public int id { get; set; }
}

復(fù)制代碼

 


 3、部門管理的API調(diào)用


 上面小節(jié)介紹了如何封裝部門管理的API,那么我們封裝好了對(duì)應(yīng)的接口和接口實(shí)現(xiàn),怎么樣在實(shí)際環(huán)境里面進(jìn)行調(diào)用處理的呢,為了方便我創(chuàng)建一個(gè)小的Winform程序來測(cè)試對(duì)應(yīng)API的功能,如下所示。



下面我們來介紹一下調(diào)用的代碼和效果展示。



復(fù)制代碼
        private void btnCreateDeleteDept_Click(object sender, EventArgs e)
{
ICorpAddressBookApi bll
= new CorpAddressBookApi();
string name = "測(cè)試部門";
CorpDeptCreateJson json
= bll.CreateDept(token, name, "2");
if (json != null)
{
Console.WriteLine(
"創(chuàng)建了部門:{0}, ID:{1}", name, json.id);
//更新部門信息
name = "測(cè)試部門修改名稱";
CommonResult result
= bll.UpdateDept(token, json.id, name);
if(result != null)
{
Console.WriteLine(
"修改部門名稱:{0} {1}", (result.Success ? "成功" : "失敗"), result.ErrorMessage);
}
//刪除部門
result = bll.DeleteDept(token, json.id);
if (result != null)
{
Console.WriteLine(
"刪除部門名稱:{0} {1}", (result.Success ? "成功" : "失敗"), result.ErrorMessage);
}
}

}

復(fù)制代碼


復(fù)制代碼
        /// <summary>
/// 獲取部門列表
/// </summary>
private void btnListDept_Click(object sender, EventArgs e)
{
ICorpAddressBookApi bll
= new CorpAddressBookApi();
CorpDeptListJson list
= bll.ListDept(token);
foreach (CorpDeptJson info in list.department)
{
string tips = string.Format("{0}:{1}", info.name, info.id);
Console.WriteLine(tips);
}
}

復(fù)制代碼


 


 


如果對(duì)這個(gè)《C#開發(fā)微信門戶及應(yīng)用》系列感興趣,可以關(guān)注我的其他文章,系列隨筆如下所示:


C#開發(fā)微信門戶及應(yīng)用(20)-微信企業(yè)號(hào)的菜單管理


C#開發(fā)微信門戶及應(yīng)用(19)-微信企業(yè)號(hào)的消息發(fā)送(文本、圖片、文件、語音、視頻、圖文消息等)


C#開發(fā)微信門戶及應(yīng)用(18)-微信企業(yè)號(hào)的通訊錄管理開發(fā)之成員管理


C#開發(fā)微信門戶及應(yīng)用(17)-微信企業(yè)號(hào)的通訊錄管理開發(fā)之部門管理


C#開發(fā)微信門戶及應(yīng)用(16)-微信企業(yè)號(hào)的配置和使用


C#開發(fā)微信門戶及應(yīng)用(15)-微信菜單增加掃一掃、發(fā)圖片、發(fā)地理位置功能


 C#開發(fā)微信門戶及應(yīng)用(14)-在微信菜單中采用重定向獲取用戶數(shù)據(jù)


C#開發(fā)微信門戶及應(yīng)用(13)-使用地理位置擴(kuò)展相關(guān)應(yīng)用


C#開發(fā)微信門戶及應(yīng)用(12)-使用語音處理


C#開發(fā)微信門戶及應(yīng)用(11)--微信菜單的多種表現(xiàn)方式介紹


C#開發(fā)微信門戶及應(yīng)用(10)--在管理系統(tǒng)中同步微信用戶分組信息


C#開發(fā)微信門戶及應(yīng)用(9)-微信門戶菜單管理及提交到微信服務(wù)器


C#開發(fā)微信門戶及應(yīng)用(8)-微信門戶應(yīng)用管理系統(tǒng)功能介紹


C#開發(fā)微信門戶及應(yīng)用(7)-微信多客服功能及開發(fā)集成


C#開發(fā)微信門戶及應(yīng)用(6)--微信門戶菜單的管理操作


C#開發(fā)微信門戶及應(yīng)用(5)--用戶分組信息管理


C#開發(fā)微信門戶及應(yīng)用(4)--關(guān)注用戶列表及詳細(xì)信息管理


C#開發(fā)微信門戶及應(yīng)用(3)--文本消息和圖文消息的應(yīng)答


C#開發(fā)微信門戶及應(yīng)用(2)--微信消息的處理和應(yīng)答


C#開發(fā)微信門戶及應(yīng)用(1)--開始使用微信接口


 



主要研究技術(shù):代碼生成工具、Visio二次開發(fā)、客戶關(guān)系管理軟件、送水管理軟件等共享軟件開發(fā)
專注于Winform開發(fā)框架Web開發(fā)框架、WCF開發(fā)框架的研究及應(yīng)用。
  轉(zhuǎn)載請(qǐng)注明出處:
撰寫人:伍華聰  http://www.iqidi.com 
    





該文章在 2014/12/2 0:59:26 編輯過
關(guān)鍵字查詢
相關(guān)文章
正在查詢...
點(diǎn)晴ERP是一款針對(duì)中小制造業(yè)的專業(yè)生產(chǎn)管理軟件系統(tǒng),系統(tǒng)成熟度和易用性得到了國(guó)內(nèi)大量中小企業(yè)的青睞。
點(diǎn)晴PMS碼頭管理系統(tǒng)主要針對(duì)港口碼頭集裝箱與散貨日常運(yùn)作、調(diào)度、堆場(chǎng)、車隊(duì)、財(cái)務(wù)費(fèi)用、相關(guān)報(bào)表等業(yè)務(wù)管理,結(jié)合碼頭的業(yè)務(wù)特點(diǎn),圍繞調(diào)度、堆場(chǎng)作業(yè)而開發(fā)的。集技術(shù)的先進(jìn)性、管理的有效性于一體,是物流碼頭及其他港口類企業(yè)的高效ERP管理信息系統(tǒng)。
點(diǎn)晴WMS倉儲(chǔ)管理系統(tǒng)提供了貨物產(chǎn)品管理,銷售管理,采購(gòu)管理,倉儲(chǔ)管理,倉庫管理,保質(zhì)期管理,貨位管理,庫位管理,生產(chǎn)管理,WMS管理系統(tǒng),標(biāo)簽打印,條形碼,二維碼管理,批號(hào)管理軟件。
點(diǎn)晴免費(fèi)OA是一款軟件和通用服務(wù)都免費(fèi),不限功能、不限時(shí)間、不限用戶的免費(fèi)OA協(xié)同辦公管理系統(tǒng)。
Copyright 2010-2025 ClickSun All Rights Reserved