聲寶經銷商交易平台 MCP 使用 文件日期 2014 年 12 月 19 日 版次 : 1.2 三商電腦股份有限公司 Mercuries Data Systems Ltd.
版本修訂紀錄表 版本日期 (mm/dd/yy) 修改摘要 1.0 12/08/14 初版 1.1 12/16/14 1.2 12/19/14 1. 5.2 APK 上傳 5.3 IPA 上傳 補充說明 : 版本號需和 APP 安裝檔中設定的版本號一致 2. 5.4 推播服務 補充說明 :[ 訊息內容 ] 建議字數 15 個字左右 1. 增加 5.5 資料檔更新 2. 增加 附錄 : SampoB2BWinService 說明 版次 :1.2 文件日期 :2014 年 12 月 19 日 頁數 :i
目錄 1. 前言... 1 2. 登入... 2 2.1 登入頁... 2 2.2 功能選單... 2 3. 基本資料管理... 3 3.1 組織架構管理... 3 3.2 使用者資料管理... 3 3.3 行動裝置管理... 4 4. 個人資料管理... 5 4.1 密碼變更... 5 5. 系統管理... 6 5.1 系統權限管理... 6 5.2 APK 上傳... 7 5.3 IPA 上傳... 8 5.4 推播服務... 9 5.5 資料檔更新... 10 6. 後台統計資訊... 11 6.1 使用率統計 (APP)... 11 6.2 使用率統計 ( 轄區 )... 12 附錄 : SAMPOB2BWINSERVICE 說明... 13 版次 :1.2 文件日期 :2014 年 12 月 19 日 頁數 :ii
1. 前言 本說明聲寶經銷商平台 APP 的 MCP 後台管理功能, 包括基本資料管理 個人資料管理 系統管理 後台統計資訊的說明 推播服務是由一支獨立的 SampoB2BWinService 服務進行推播作業, 此服務也會定期 ( 每個整點 ) 檢查 / 更新一次 地區資料 訂單交易產品別清單 維修服務產品清單 的資料檔 在附錄的部分說明該服務的功能 架構 及安裝方式 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :1
2. 登入 2.1 登入頁 網址 :http://b2bmcp.sampo.com.tw/sampob2bmcp/ 2.2 功能選單 登入後, 在左方可看到功能選單, 主要分四類 : 基本資料管理 個人資料管理 系統管理 後台統計資訊 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :2
3. 基本資料管理 3.1 組織架構管理 (1) 路徑 : 基本資料管理 >> 組織架構管理 (2) 以階層方式建立組織架構 [ 註 ] 聲寶經銷商交易平台案 只有後台管理人員會使用此平台, 所以在此無需建立組織架構 3.2 使用者資料管理 (1) 路徑 : 基本資料管理 >> 使用者資料管理 (2) 可新增 刪除 啟用 停用使用者 (3) 新增 時, 預設密碼為使用者帳號 ; 密碼重置 會將密碼設成和帳號一樣 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :3
3.3 行動裝置管理 (1) 路徑 : 基本資料管理 >> 行動裝置管理 (2) 僅供查看行動裝置的 ID 狀態 目前使用的 APP 版本號 以及最近一次登入的使用者帳號和登入時間 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :4
4. 個人資料管理 4.1 密碼變更 (1) 路徑 : 個人資料管理 >> 密碼變更 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :5
5. 系統管理 5.1 系統權限管理 (1) 路徑 : 系統管理 >> 系統權限管理 (2) 功能頁籤 : 設定各角色擁有的功能權限 及各功能下的動作權限 (3) 角色頁籤 : 設定各角色使用者在新增使用者時, 可以賦予新使用者哪些角色 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :6
5.2 APK 上傳 (1) 路徑 : 系統管理 >> APK 上傳 (2) 輸入版本號 及版本描述, 選擇要上傳的 Android App 安裝檔, 完成後點擊 上傳 按鈕 完成後在下方更新歷程中可看到此次上傳的紀錄 (3) 更新歷中的 [ 版本號 版本描述 ] 可以修改, 修改後需點擊 儲存版本歷程資訊 按鈕 未儲存的情況下, 點擊 放棄 按鈕, 會回覆成修改前的資料 [APK 版本號 ] 需與 Android APP 安裝檔中設定的版本號一致 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :7
5.3 IPA 上傳 (1) 路徑 : 系統管理 >> IPA 上傳 (2) 輸入版本號 及版本描述, 選擇要上傳的 iphone App 安裝檔, 完成後點擊 上傳 按鈕 完成後在下方更新歷程中可看到此次上傳的紀錄 (3) 更新歷中的 [ 版本號 版本描述 ] 可以修改, 修改後需點擊 儲存版本歷程資訊 按鈕 未儲存的情況下, 點擊 放棄 按鈕, 會回覆成修改前的資料 [IPA 版本號 ] 需與 iphone APP 安裝檔中設定的版本號一致 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :8
5.4 推播服務 (1) 路徑 : 系統管理 >> 推播服務 (2) 推播服務列表可查看手動推播的內容 及推播狀態 (3) 點擊 新增 按鈕, 可開啟新增畫面 推播類型 : 最新消息 / 廣告影片 / 行銷園地 裝置類型 : 全部 /android/ios 推播時間 : 立即 / 指定推播日期時間 訊息內容 : 必填 建議字數 15 個字左右 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :9
(4) 點擊列表中的資料時, 可開啟該資料內容頁 5.5 資料檔更新 (1) 路徑 : 系統管理 >> 資料檔更新 (2) 資料檔會排程一個小時做一次 [ 檢查 / 更新 ], 檢查資料有變更時, 才會進行檔案更新 可透過此介面手動執行 [ 檢查 / 更新 ] 的動作 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :10
6. 後台統計資訊 6.1 使用率統計 (APP) (1) 路徑 : 後台統計資訊 >> 使用率統計 (APP) (2) 可查看 APP 功能的使用次數 使用率 (3) 點擊某一個 APP 功能項, 可看到此 APP 功能項的使用者使用次數統計 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :11
6.2 使用率統計 ( 轄區 ) (1) 路徑 : 後台統計資訊 >> 使用率統計 ( 轄區 ) (2) 可查看各轄區使用 APP 的次數 使用率 (3) 點擊某一轄區, 可看到此轄區使用各 APP 功能項的次數統計 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :12
附錄 : SampoB2BWinService 說明 1. 功能 及架構圖 SampoB2BWinService 服務主要負責兩項作業 :(1) 訊息推播 (2) 排程作業 (1) 推播訊息 : 要推播的訊息會由 MCP 後台寫至 訊息佇列 (MSMQ) 中, 此時 WinService 監聽到有新的訊息進入 訊息佇列 (MSMQ) 後, 會依據推播訊息的推播對象至資料庫中取得推播對象的 pushtoken 並進行訊息推播, 完成後會將推播的狀態回寫至資料庫中, 後續使用者可從 MCP 後台管理介面查詢 (2) 排程作業 : 服務啟動後, 會執行一次, 之後每個整點都會執行一次 排程作業包含下面兩項 檢查資料庫中是否有排程待推的訊息, 若有且已達推播時間, 則呼叫 MCP 後台的 API 將此訊息寫入 訊息佇列 (MSMQ) 中 檢查 / 更新幾個 APP 端會用到 但變動頻率不高的資料檔 (SQLite), 包含 地區資料 訂單交易產品別清單 維修服務產品清單 的資料檔 網站伺服器 資料庫伺服器 IIS MCP 後台管理 MSMQ 推播訊息 SQL Server 資料庫 WinService 推播 排程作業 2. 安裝說明 (1) 執行 SampoB2BWinServiceInstaller.msi 安裝檔 請安裝至 D:\SampoApp\SampoB2BWinService 安裝過程中, 會要求輸入執行此服務的身份 因為此服務須透過 Windows 驗證連至資料庫伺服器, 所以請輸入 MOD 這個使用者的帳密 ( 如下圖 ) 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :13
(2) 安裝完成後, 在 D:\SampoApp\SampoB2BWinService 資料夾下可看到以下幾個檔案 主程式 程式庫 SampoB2BWinService.exe MDS.PushService.dll MDSUtils.dll Newtonsoft.Json.dll SampoB2BJobHelper.dll ios 推播憑證 SampoB2B.p12 一年需更新一次 設定檔 SampoB2BWinService.exe.config 請確認參數設定是否正確 紀錄檔 Log\JobLog_yyyyMM.txt Log\PushLog_yyyyMM.txt 服務啟動後才會產生 設定檔參數說明 : MCPDB:MCP 的 SQL Server 資料庫連線字串 GCMAPIKEY:Android 推播服務的 Key APNSCERTFILE:iOS 推播服務的憑證檔檔名 APNSCERTPW:iOS 推播服務的憑證密碼 QueueName_SampoB2BPush: 存放推播訊息的訊息佇列 (MSMQ) 名稱 MCPServerIP:MCP 管理平台所在的伺服器 IP 或伺服器名稱 (3) 第一次安裝完成後, 先確認 SampoB2BWinService.exe.config 設定檔中的參數是否正確, 完成後請至 服務 中啟動 SampoB2BService 服務 版次 :1.2 文件日期 :2014 年 12 月 19 日頁數 :14