C#開發微信門戶及應用(20)-微信企業號的菜單管理，

C#開發微信門戶及應用(20)-微信企業號的菜單管理，

前面幾篇陸續介紹了很多微信企業號的相關操作，企業號和公眾號一樣都可以自定義菜單，因此他們也可以通過API進行菜單的創建、獲取列表、刪除的操作，因此本篇繼續探討這個主體，介紹企業號的菜單管理操作。

菜單在很多情況下，能夠給我們提供一個快速入口，也可以用來獲取用戶信息的主要入口，通過OAuth2驗證接口，以及自定義的重定向菜單，我們就可以獲取對應的用戶ID，然後進一步獲取到用戶的相關數據，可以顯示給客戶。

1、菜單的總體介紹

菜單的事件處理如下所示，包括了單擊和跳轉兩個操作，未來企業號可能會增加一些和公眾號一樣的掃碼操作，拍照操作等功能的，目前只有兩個。

官方的菜單定義接口包含了下面三種操作，菜單創建、列表獲取和菜單刪除，這點和公眾號操作幾乎一樣了。

 

2、菜單的實體類定義和接口定義處理

我們定義菜單，包括定義它的一些屬性，包含有name, type, key,url,以及一個指向自身引用的子菜單引用，因此菜單就可以循環構造多個層次，雖然嚴格意義上來講，企業號的菜單和公眾號菜單一樣，一級三個，二級最多五個，而且沒有三級菜單了。

實體類的UML圖示如下所示。

菜單管理的創建操作，官方定義如下所示。

• 請求說明

Https請求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=1

請求包如下：

{
   "button":[
       {	
           "type":"click",
           "name":"今日歌曲",
           "key":"V1001_TODAY_MUSIC"
       },
       {
           "name":"菜單",
           "sub_button":[
               {
                   "type":"view",
                   "name":"搜索",
                   "url":"http://www.soso.com/"
               },
               {
                   "type":"click",
                   "name":"贊一下我們",
                   "key":"V1001_GOOD"
               }
           ]
      }
   ]
}

• 參數說明

參數必須說明 access_token 是 調用接口憑證 agentid 是 企業應用的id，整型。可在應用的設置頁面查看 button 是 一級菜單數組，個數應為1~3個 sub_button 否 二級菜單數組，個數應為1~5個 type 是 菜單的響應動作類型，目前有click、view兩種類型 name 是 菜單標題，不超過16個字節，子菜單不超過40個字節 key click類型必須 菜單KEY值，用於消息接口推送，不超過128字節 url view類型必須 網頁鏈接，員工點擊菜單可打開鏈接，不超過256字節

• 權限說明

管理員須擁有應用的管理權限，並且應用必須設置在回調模式。

返回結果

{
   "errcode":0,
   "errmsg":"ok"
}

 

根據上面官方的定義語義，我們菜單管理的C#管理接口定義如下所示。

    /// <summary>
    /// 企業號菜單管理接口定義
    /// </summary>
    public interface ICorpMenuApi
    {
        /// <summary>
        /// 獲取菜單數據
        /// </summary>
        /// <param name="accessToken">調用接口憑證</param>
        /// <returns></returns>
        MenuListJson GetMenu(string accessToken, string agentid);

        /// <summary>
        /// 創建菜單
        /// </summary>
        /// <param name="accessToken">調用接口憑證</param>
        /// <param name="menuJson">菜單對象</param>
        /// <returns></returns>
        CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid);

        /// <summary>
        /// 刪除菜單
        /// </summary>
        /// <param name="accessToken">調用接口憑證</param>
        /// <returns></returns>
        CommonResult DeleteMenu(string accessToken, string agentid);
    }

我們以創建菜單的實現為例來介紹微信企業號菜單的操作，其他的操作類似處理，都是返回一個公共的消息類，方便處理和讀取，代碼如下所示。

        /// <summary>
        /// 創建菜單
        /// </summary>
        /// <param name="accessToken">調用接口憑證</param>
        /// <param name="menuJson">菜單對象</param>
        /// <returns></returns>
        public CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid)
        {
            var url = string.Format("https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token={0}&agentid={1}", accessToken, agentid);
            string postData = menuJson.ToJson();

            return Helper.GetCorpExecuteResult(url, postData);
        }

 

3、企業號菜單管理接口的調用和處理效果

調用的代碼和效果圖如下所示。

        private void btnMenuCreate_Click(object sender, EventArgs e)
        {
            MenuJson productInfo = new MenuJson("產品介紹", new MenuJson[] { 
                new MenuJson("軟件產品介紹", ButtonType.click, "event-software")
                , new MenuJson("框架源碼產品", ButtonType.click, "event-source")
                , new MenuJson("軟件定制開發", ButtonType.click, "event-develop")
            });

            MenuJson frameworkInfo = new MenuJson("框架產品", new MenuJson[] { 
                new MenuJson("Win開發框架", ButtonType.click, "win"),
                new MenuJson("WCF開發框架", ButtonType.click, "wcf"),
                new MenuJson("混合式框架", ButtonType.click, "mix"), 
                new MenuJson("Web開發框架", ButtonType.click, "web")
                ,new MenuJson("代碼生成工具", ButtonType.click, "database2sharp")
            });

            MenuJson relatedInfo = new MenuJson("相關鏈接", new MenuJson[] { 
                new MenuJson("公司介紹", ButtonType.click, "event_company"),
                new MenuJson("官方網站", ButtonType.view, "http://www.iqidi.com"),
                new MenuJson("聯系我們", ButtonType.click, "event_contact"),
                new MenuJson("應答系統", ButtonType.click, "set-1"),    
                new MenuJson("發郵件", ButtonType.view, "http://mail.qq.com/cgi-bin/qm_share?t=qm_mailme&email=S31yfX15fn8LOjplKCQm")
            });

            MenuListJson menuJson = new MenuListJson();
            menuJson.button.AddRange(new MenuJson[] { productInfo, frameworkInfo, relatedInfo });

            //Console.WriteLine(menuJson.ToJson());

            if (MessageUtil.ShowYesNoAndWarning("您確認要創建菜單嗎") == System.Windows.Forms.DialogResult.Yes)
            {
                ICorpMenuApi bll = new CorpMenuApi(); 
                CommonResult result = bll.CreateMenu(token, menuJson, agentid);
                Console.WriteLine("創建菜單：" + (result.Success ? "成功" : "失敗:" + result.ErrorMessage));
            }
        }

        private void btnMenuGet_Click(object sender, EventArgs e)
        {
            ICorpMenuApi bll = new CorpMenuApi();
            MenuListJson menu = bll.GetMenu(token, agentid);
            if (menu != null)
            {
                Console.WriteLine(menu.ToJson());
            }
        }

調用代碼的測試輸出如下所示。

 

如果對這個《C#開發微信門戶及應用》系列感興趣，可以關注我的其他文章，系列隨筆如下所示：

C#開發微信門戶及應用(20)-微信企業號的菜單管理

C#開發微信門戶及應用(19)-微信企業號的消息發送（文本、圖片、文件、語音、視頻、圖文消息等）

C#開發微信門戶及應用(18)-微信企業號的通訊錄管理開發之成員管理

C#開發微信門戶及應用(17)-微信企業號的通訊錄管理開發之部門管理

C#開發微信門戶及應用(16)-微信企業號的配置和使用

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

 C#開發微信門戶及應用(14)-在微信菜單中采用重定向獲取用戶數據

C#開發微信門戶及應用(13)-使用地理位置擴展相關應用

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

C#開發微信門戶及應用(11)--微信菜單的多種表現方式介紹

C#開發微信門戶及應用(10)--在管理系統中同步微信用戶分組信息

C#開發微信門戶及應用(9)-微信門戶菜單管理及提交到微信服務器

C#開發微信門戶及應用(8)-微信門戶應用管理系統功能介紹

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

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

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

C#開發微信門戶及應用(4)--關注用戶列表及詳細信息管理

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

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

C#開發微信門戶及應用(1)--開始使用微信接口

 

C:\

可以的

參考這個對C盤進行清理：
1.關閉系統還原:我的電腦屬性/系統還原/關閉所有磁盤上的系統還原,但是以後就不能用系統還原了!
2.關閉系統休眠:控制面板/電源/休眠/在啟動系統休眠前面的勾去掉
3.移動虛擬內存，我的電腦屬性/高級/性能/設置/高級/更改/選C盤也就是系統盤，選無分頁面，然後把虛擬內存設置到其磁盤，要剩余磁盤空間多的磁盤，比如D，E，F等盤． 設成內存的1.5~2.5倍,大小可設成一樣!
5.清理IE臨時文件夾，internet選項，刪除臨時文件和脫機文件
6.刪除系統日志和程序日志，我的電腦/控制面板/管理工具/計算機管理/事件查看器/應用程序，鼠標右鍵/清除所事件，在依次清除系統日志
7.清理系統緩存：2000系統是：C:\WINNT\system32\dllcache下的所有文件
XP系統是：C:\windows\system32\dllcache下的所有文件 清理系統緩存(打開我的電腦/工具/文件和文件夾選項/隱藏受保護的系統文件的勾去掉在把顯示全部文件勾上)。也可以直接運行sfc.exe /purgecache命令自動刪除。
8.清空回收站
9.刪除c:\windows\SoftwareDistribution\Download下的文件(系統更新時下載的文件如你裝好了更新也就沒有用了)
10.刪除c:\windows\RegisteredPackages下所有目錄
11.刪除C:\WINDOWS\Downloaded Program Files下所有的文件
12.我的電腦 文件夾選項 查看 隱藏已知受系統保護的文件勾去掉,顯示所有文件勾上確定。
13.刪除c:\windows\所有帶$8882305$的文件(系統更新後的備份文件)

zhidao.baidu.com/question/11035955.html
zhidao.baidu.com/question/12223613.html
zhidao.baidu.com/question/14874715.html
......余下全文>>
 

C:\

可以的

參考這個對C盤進行清理：
1.關閉系統還原:我的電腦屬性/系統還原/關閉所有磁盤上的系統還原,但是以後就不能用系統還原了!
2.關閉系統休眠:控制面板/電源/休眠/在啟動系統休眠前面的勾去掉
3.移動虛擬內存，我的電腦屬性/高級/性能/設置/高級/更改/選C盤也就是系統盤，選無分頁面，然後把虛擬內存設置到其磁盤，要剩余磁盤空間多的磁盤，比如D，E，F等盤． 設成內存的1.5~2.5倍,大小可設成一樣!
5.清理IE臨時文件夾，internet選項，刪除臨時文件和脫機文件
6.刪除系統日志和程序日志，我的電腦/控制面板/管理工具/計算機管理/事件查看器/應用程序，鼠標右鍵/清除所事件，在依次清除系統日志
7.清理系統緩存：2000系統是：C:\WINNT\system32\dllcache下的所有文件
XP系統是：C:\windows\system32\dllcache下的所有文件 清理系統緩存(打開我的電腦/工具/文件和文件夾選項/隱藏受保護的系統文件的勾去掉在把顯示全部文件勾上)。也可以直接運行sfc.exe /purgecache命令自動刪除。
8.清空回收站
9.刪除c:\windows\SoftwareDistribution\Download下的文件(系統更新時下載的文件如你裝好了更新也就沒有用了)
10.刪除c:\windows\RegisteredPackages下所有目錄
11.刪除C:\WINDOWS\Downloaded Program Files下所有的文件
12.我的電腦 文件夾選項 查看 隱藏已知受系統保護的文件勾去掉,顯示所有文件勾上確定。
13.刪除c:\windows\所有帶$8882305$的文件(系統更新後的備份文件)

zhidao.baidu.com/question/11035955.html
zhidao.baidu.com/question/12223613.html
zhidao.baidu.com/question/14874715.html
......余下全文>>