泛微e-colgy與阿里釘釘集成配置手冊2015V4.0

1、 泛微e-colog與阿里釘釘集成配置手冊溫馨提示：1、 泛微e-Bridge即為原來的微信&釘釘集成平臺2、 本手冊在泛微e-Bridge的20150910版本基礎(chǔ)上編制不同版本操作界面會有所偏差一、 約束條件1. 貴司的e-cology產(chǎn)品版本號是以下的任意一個版本l ecology6.000.0601-KB60001308及以上l ecology7.100.0331-KB71001308及以上l ecology8所有版本如果貴司的e-cology產(chǎn)品低于以上版本請先升級到對應(yīng)版本2. 貴司已經(jīng)安裝了泛微云橋e-Bridge溫馨提示：考慮到到升級e-cology需要重啟e-colo

2、gy服務(wù)，所以可以在方便重啟e-cology服務(wù)的時候先進行e-cology產(chǎn)品的升級操作，之后再部署【泛微云橋e-Bridge】二、 e-cology產(chǎn)品升級1. 訪問地址：2. 將下載的【e-cology端升級文件】，并進行解壓，按照壓縮包中的升級說明進行升級（無論您的e-cology是什么版本都需要升級，請同步同步升級e-Bridge補丁包到最新版）3. 如果貴司的e-cology在以下版本內(nèi)還需要升級【e-cology個版本流程推送標準升級包】l 6.000.0601-KB60001308 至 6.000.0601-KB60001507（不包含1501、1507）l 7.100.033

3、1-KB71001308 至 7.100.0331-KB71001412（不包含1412）注意，這次升級需要覆蓋的是classbeanweaverworkflowmsgPoppupRemindInfoUtil.class 文件只有這個文件沒有做過二次開發(fā)才能升級，否則需要根據(jù)貴司的情況，對這個文件進行簡單的二次開發(fā)，具體改造方式參考【泛微e-cology流程推送到微信&釘釘開發(fā)手冊】比上述版本高的（如e-cology8），標準功能中已包含，不需要升級這個文件三、 e-cology系統(tǒng)接入配置登陸到【泛微云橋e-Bridge】，通過以下菜單路徑設(shè)置接入e-cology系統(tǒng)【集成中心】&#

4、224;【外部系統(tǒng)集成】，如下圖所示點擊本集成平臺菜單【集成中心】à【外部系統(tǒng)集成】，進入如下界面 然后點擊【新建】按鈕，輸入相關(guān)的集成系統(tǒng)的配置信息1、 系統(tǒng)名稱：要接入的系統(tǒng)的名稱，輸入名字即可2、 系統(tǒng)類型：目前可選的只有e-cology系統(tǒng)3、 管理員賬號：e-cology系統(tǒng)的管理員賬號sysadmin4、 管理員密碼：e-cology系統(tǒng)的管理員密碼（這個密碼只作為接入時候驗證權(quán)限，系統(tǒng)不會保存密碼）5、 用戶唯一標識類型：ID、loginid（如果e-cology系統(tǒng)的登陸名不是中文，建議選loginid）6、 接口密碼：用于e-cology系統(tǒng)調(diào)用本集成平臺接口的密碼

5、，自動生成，可以自己修改，不建議修改7、 系統(tǒng)編碼：如果是e-cology6、7版本選擇GBK，e-cology8及以上選擇 UTF-88、 服務(wù)地址：輸入e-cology系統(tǒng)的訪問地址,該地址為本集成平臺服務(wù)器訪問e-cology系統(tǒng)的地址，如果e-cology和本集成平臺在同一服務(wù)器上可以輸入 :端口 ,不在同一個服務(wù)器，在同一個局域網(wǎng)則輸入 http:/OA服務(wù)器IP：端口 ，如果不在一個局域網(wǎng)內(nèi)，那么請輸入 http:/OA外網(wǎng)訪問地址9、 備注說明：只是說明文字，任意輸入設(shè)置好以上信息之后點擊【確認】，如果能夠驗證通過則完成了接入配置過程。如果這里接入有

6、問題，可能是以下原因之一，請檢查a) 管理員賬號密碼錯誤：請輸入正確的e-cology系統(tǒng)的 sysadmin 的密碼b) 服務(wù)地址錯誤：輸入的地址不是e-cology系統(tǒng)的地址或者該地址不能在集成平臺服務(wù)器上進行訪問c) 安裝泛微云橋e-Bridge的時候【系統(tǒng)設(shè)置】à【基礎(chǔ)參數(shù)設(shè)置】中設(shè)置的【本系統(tǒng)內(nèi)網(wǎng)地址】有問題，請確認這個地址是e-Bridge的地址，并且可以被e-cology系統(tǒng)所在的服務(wù)器進行訪問四、 阿里釘釘接入配置登陸到【泛微云橋e-Bridge】，點擊左側(cè)菜單 【阿里釘釘號】如下圖所示點擊【+】號，然后進入如下頁面 嚴格按照這個頁面上的說明一步步操作，接入阿里釘釘號

7、五、 e-cology組織用戶與阿里釘釘通訊錄同步完成阿里釘釘號接入后，可以通過本集成平臺可以直接管理阿里釘釘號中的通訊錄，并且可以實現(xiàn)將泛微e-cology系統(tǒng)中的組織用戶通過到本集成平臺進而同步到阿里釘釘號中。點擊【阿里釘釘號】，可以進入釘釘號的設(shè)置界面，如下圖所示鼠標指向需要配置的阿里釘釘號點擊【設(shè)置】按鈕第一次進入【通訊錄管理】，系統(tǒng)會提示對當前阿里釘釘號內(nèi)已有通訊錄的處理方式l 同步到本系統(tǒng)：將阿里釘釘號內(nèi)現(xiàn)有的通訊錄同步到集成平臺l 刪除歷史數(shù)據(jù)：刪除阿里釘釘號內(nèi)現(xiàn)有的所有通訊錄數(shù)據(jù)您可以根據(jù)實際情況進行選擇，以下幾種情況建議【刪除歷史數(shù)據(jù)】1、 阿里釘釘號內(nèi)已激活的用戶不多，建議

8、選擇刪除歷史數(shù)據(jù)2、 需要與e-cology系統(tǒng)進行組織用戶同步集成，并且阿里釘釘號內(nèi)的釘釘用戶唯一標識與泛微OA的登陸賬號（或者用戶數(shù)據(jù)庫ID）不一致進行完基礎(chǔ)數(shù)據(jù)的處理之后，以后阿里釘釘號的通訊錄管理可以直接在本集成平臺中完成（此后禁止在阿里釘釘號后臺管理通訊錄，對組織用戶及人員進行增刪改等操作，所有組織用戶的管理都請在集成平臺進行操作，以免出現(xiàn)數(shù)據(jù)不一致）通過本集成平臺的通訊錄管理功能，可以實現(xiàn)以下功能1、 組織結(jié)構(gòu)管理：對阿里釘釘號的組織結(jié)構(gòu)進行增、刪、改操作2、 用戶管理：對阿里釘釘號的用戶進行增、刪、改等操作3、 與e-cology系統(tǒng)的組織用戶進行同步：點擊【+】選擇【外部系統(tǒng)同

9、步】會出現(xiàn)如下窗口1、 選擇外部系統(tǒng)：這里可以選擇，前面外部系統(tǒng)集中中配置過的e-cology系統(tǒng)2、 新成員添加到釘釘后臺：從e-cology系統(tǒng)同步過來的新成員是否直接添加成阿里釘釘號賬號3、 不同步分部部門：勾選了不會同步e-cology的組織結(jié)構(gòu)到阿里釘釘號，只會同步用戶賬號4、 同步分部范圍：選擇需要同步的組織結(jié)構(gòu)的OA中分部的范圍（分部必須從頂級部分開始選擇）不選擇表示全部5、 需要同步部門范圍：需要同步的分部下的部門的范圍（部門必須從頂級部門開始選擇）不選擇表示被選擇需同步分部下的所有部門6、 同步人員范圍：哪些人需要同步，不選擇表示全部人員（如果人員所在的部門沒有被同步，那么對

10、應(yīng)的人會被放在一個默認的部門下面）選擇后，點擊【開始同步】，系統(tǒng)會將泛微e-cology系統(tǒng)中的組織賬號信息同步到本集成平臺，如果您選擇了【新成員添加到釘釘號】那么用戶數(shù)據(jù)會同時添加到阿里釘釘號中，這個過程有一下幾個注意點1、 系統(tǒng)會自動在阿里釘釘號中建立一個新的部門，部門名稱為外部系統(tǒng)集成中設(shè)置的系統(tǒng)名稱。a) 如果選擇【不同步分部&部門】，那么所有同步的用戶都放在這個部門下b) 否則所有從泛微e-cology中同步過來的用戶會歸類到和OA一樣的部門下面2、 從e-cology那邊同步過來的用戶會自動根據(jù)用戶登陸賬號或者ID，和已有的用戶進行關(guān)聯(lián)（通過什么方式關(guān)聯(lián)根據(jù)前面配置e-co

11、logy系統(tǒng)接入設(shè)置時選擇的用戶唯一標識類型而定）3、 后續(xù)能夠使用泛微e-cology系統(tǒng)功能的用戶只有這些能夠關(guān)聯(lián)上的用戶六、 阿里釘釘號的賬號與OA賬號不一致處理如果您的阿里釘釘號在集成泛微e-cology系統(tǒng)之前已經(jīng)有了通訊錄數(shù)據(jù)，并且通訊錄中的賬號與泛微e-cology系統(tǒng)中的登錄賬號（或者用戶的數(shù)據(jù)庫ID）不一致，并且不希望刪除原來的組織用戶，那么您可以按照以下方式處理1、 放棄e-cology組織用戶與阿里釘釘號通訊錄的同步功能，通過其他方式維護阿里釘釘號的通訊錄2、 使用集成平臺的【外部系統(tǒng)賬號綁定】功能，綁定操作如下方式進行a) 批量綁定（如果大分部的賬號都不一致可以用這個方

12、式）如上圖所示，點擊【+】號然后選擇【外部系統(tǒng)綁定】，出現(xiàn)如下界面選擇號需要綁定賬號的e-cology系統(tǒng)，然后點擊【導出企業(yè)號所有人員】系統(tǒng)會生成一個excel表格，請按照要求將excel表格填好，然后重新導入b) 單個用戶操作綁定（如果只有部分賬號不一致，可以用這個方式）點擊通訊錄中需要綁定賬號的員工，出現(xiàn)如下界面點擊【關(guān)聯(lián)外部系統(tǒng)賬號】，彈出如下界面選擇對應(yīng)的e-cology系統(tǒng)，然后選擇需要綁定的賬號點擊【關(guān)聯(lián)】完成綁定溫馨提示：如果用戶的在釘釘企業(yè)通訊錄中的賬號和e-cology賬號一樣會自動綁定無需手動操作七、 e-cology標準模塊配置完成阿里釘釘號接入后，可以按照以下步驟完成

13、標準的e-cology阿里釘釘號辦公應(yīng)用接入登陸到【泛微云橋e-Bridge】，點擊左側(cè)菜單 【阿里釘釘號】如下圖所示鼠標移動到您需要配置的阿里釘釘號上點擊【設(shè)置】，然后點擊【應(yīng)用設(shè)置】進入如下頁面點擊【+】號會出現(xiàn)如下界面，按照界面的指引配置阿里釘釘中的應(yīng)用配置指引中最后一步需要配置的信息說明如下：c) 應(yīng)用名稱：這個應(yīng)用的名字d) 應(yīng)用ID：從阿里釘釘那邊新建的應(yīng)用中拷貝過來e) 訪問目標：在這里選擇對應(yīng)的e-cology系統(tǒng)（如果這里沒有對應(yīng)的系統(tǒng)可選擇，那么說明您沒有做上文描述的【e-cology系統(tǒng)接入配置】操作），f) 調(diào)用模塊：這里選擇這個應(yīng)用對應(yīng)e-cology中的哪個模塊（這

14、里的模塊可以參考后面的【e-cology應(yīng)用個性化設(shè)置】章節(jié)）g) 然后點擊【提交】，就可以將對應(yīng)的應(yīng)用配置到阿里釘釘號中你可以重復以上步驟，把您所需要的應(yīng)用進行逐個配置，不過泛微建議，這只配置一個應(yīng)用，其他的應(yīng)用通過下一章節(jié)的門戶管理來實現(xiàn)通過上面的配置e-cology的標準應(yīng)用就可以接入到阿里釘釘號中了，您可以通過阿里釘釘號來訪問e-cology中的各種功能進行釘釘辦公。附：e-cology集成應(yīng)用的說明l 工作流程類：e-cology系統(tǒng)中的流程待辦處理、流程發(fā)起、流程已辦辦結(jié)查詢、申請跟蹤l 新聞：以新聞頁的方式顯示e-cology系統(tǒng)中的文檔l 會議日程：e-cology系統(tǒng)中的會議

15、室預定、日程安排會議、日程查看l 通訊錄：e-cology系統(tǒng)中的員工通訊錄查看l 協(xié)作：接入e-cology系統(tǒng)中的協(xié)作區(qū)模塊（類似BBS論壇）l 郵件：接入e-cology系統(tǒng)的郵件模塊進行內(nèi)外部郵件收發(fā)l 客戶：接入e-cology系統(tǒng)的客戶管理模塊實現(xiàn)客戶資料查詢、客戶聯(lián)系記錄填寫l 任務(wù)：接入e-cology系統(tǒng)執(zhí)行力平臺的任務(wù)管理模塊實現(xiàn)任務(wù)的安排、執(zhí)行反饋l 微博：接入e-cology系統(tǒng)的工作微博模塊實現(xiàn)微博的查閱、填寫、評論l 主次賬號：e-cology系統(tǒng)的主次賬號切換功能，如果沒用到主次賬號那么可以不配置l 簽到：接入e-cology系統(tǒng)上下班簽到簽退功能，實現(xiàn)基于GPS

16、定位的上下班考勤注意：如果你不希望使用阿里釘釘提供的應(yīng)用頁面，想自己定義頁面八、 利用門戶管理實現(xiàn)阿里釘釘自定義主頁如果您希望將泛微e-cology中各種應(yīng)用功能組合在一個頁面上進行展示，可以利用【門戶管理功能】按照如下方式進行配置1. 新建門戶點擊【泛微云橋e-Bridge】的【門戶管理】菜單，進入如下頁面點擊【+】號可以新建一個門戶i. 門戶名稱：這個門戶的名字ii. 顯示模板：目前只有一個模板可以選擇，控制門戶的顯示樣式iii. 功能模板：目前只有一個，ecology模板把泛微e-cology中的功能組合在門戶中iv. 橫幅高度：如果需要在門戶頭部顯示幻燈片方式切換的橫幅圖片可以設(shè)置橫幅

17、圖的寬高比例v. 橫幅：上傳橫幅圖片，如果上傳多張會以幻燈片的方式切換顯示（圖片設(shè)計的寬高比例按照前面的設(shè)置）vi. 底部文字：輸入需要顯示在門戶底部的文字設(shè)置號門戶的基本信息后點擊保存，可以設(shè)置門戶中的具體模塊，如下圖所示按照下圖的實例設(shè)置每個模塊2. 配置阿里釘釘號主頁點擊【泛微云橋e-Bridge】的【阿里釘釘號】菜單，選擇需要配置的阿里釘釘號點擊【設(shè)置】，點擊【釘釘首頁設(shè)置】，如下圖所示a) 綁定應(yīng)用：任意選擇一個之前配置好的應(yīng)用（因為釘釘?shù)南拗?，必須設(shè)置先設(shè)置一個訪問地址指向本集成平臺的應(yīng)用）b) 訪問目標：選擇【訪問系統(tǒng)功能】c) 調(diào)用系統(tǒng)：選擇【本系統(tǒng)】d) 調(diào)用模塊：選擇【門戶

18、】e) 門戶：選擇前面配置好的門戶配置好以上信息之后點擊【保存】，頁面會顯示如下指引頁面按照這個頁面的說明在阿里釘釘中設(shè)置釘釘?shù)膽?yīng)用首頁九、 e-cology集成消息推送配置如果您希望將e-cology中各種待辦工作（如流程、日程、會議及新聞通知公告等文檔）通過釘釘消息的方式進行推送提醒，那么請按照以下說明進行設(shè)置設(shè)置路徑：【泛微云橋e-Bridge】à【集成中心】à【外部系統(tǒng)集成】點擊對應(yīng)e-cology系統(tǒng)的【推送設(shè)置】,進入如下圖所示頁面點擊【新建】，彈出如下圖所示界面，設(shè)置您的消息推送規(guī)則1、 顯示名稱：推送規(guī)則的名字2、 消息類型：選擇需要推送的消息類型（流程、文

19、檔、會議、日程等）3、 關(guān)聯(lián)消息（類型）模板：該消息需要通過哪個模板進行推送（對應(yīng)的模板在【集成中心à外部系統(tǒng)消息模板中設(shè)置】，具體請查閱下一章節(jié)），a) 模板可以多選，但是一般情況下只選擇一個，除非您需要將同一條消息發(fā)送到多個阿里釘釘號的應(yīng)用中去（因為每個模板對應(yīng)一個阿里釘釘號應(yīng)用）b) 配置模板的時候要注意模板中的鏈接目標與推送消息類型的一致性，否則用戶收到消息將無法打開正確的數(shù)據(jù)4、 掃描頻率：文檔、日程、會議、協(xié)作、微博、客戶等消息的推送不是實時的，具體推送的時間根據(jù)您設(shè)定的掃描頻率決定，如您設(shè)置的掃描頻率是10分鐘，那么推送會在0-10分鐘內(nèi)完成（其中文檔比較特別，會再10

20、-20分鐘內(nèi)完成，因為需要預留10分鐘給用戶設(shè)置文檔共享權(quán)限，文檔會推送給文檔創(chuàng)建或者編輯之后10分鐘內(nèi)設(shè)置的共享對象）5、 針對文檔、會議、日程等消息的設(shè)置，因為這些消息的推送不是實時的，是定時掃描系統(tǒng)中有新數(shù)據(jù)產(chǎn)生而進行推送6、 內(nèi)容設(shè)置：需要推送哪些內(nèi)容（如推送流程則可以設(shè)置推送哪些類型的流程）7、 是否啟用：這個規(guī)則是否有效8、 下面針對各類型的推送進行特別的說明a) 流程：可以設(shè)置哪些流程的流程需要進行待辦消息推送b) 文檔：可以設(shè)置哪些目錄下的文檔需要進行消息推送，一旦對應(yīng)的目錄下有新的文檔產(chǎn)生，系統(tǒng)就會將他以釘釘消息的方式推送給對這個文檔有共享權(quán)限的人（文檔創(chuàng)建或者編輯之后10分

21、鐘內(nèi)設(shè)置的共享對象）c) 日程、會議：e-cology系統(tǒng)有會議、日程安排的時候會以釘釘消息的方式通知會議日程的參與者（可以選擇是創(chuàng)建就推送，還是等會議日程快開始的時候推送） d) 協(xié)作：有新的協(xié)作、或者新的回復會通過釘釘消息提醒協(xié)作的參與人員e) 微博：微博的評論會推送給被評論者這些模塊中有新的內(nèi)容產(chǎn)f) 客戶：有新的客戶分配會提醒客戶經(jīng)理g) 消息：這個在釘釘號中無用，只針對微信集成使用 h) 文檔群發(fā)：這個在釘釘號中無用，只針對微信集成使用9、 消息推送特殊說明a) 針對流程的推送規(guī)則您可以設(shè)置多個實現(xiàn)將不同的流程待辦推送到不同的阿里釘釘號應(yīng)用中去（這個適用于將流程拆分成多個應(yīng)用的情況）

22、b) 針對文檔的推送規(guī)則您可以設(shè)置多個實現(xiàn)將不同類型的文檔推送到不同的阿里釘釘號應(yīng)用中去（這個適用于將流程拆分成多個應(yīng)用的情況，比如將文檔拆分成新聞模塊、通知模塊、知識分享模塊等）十、 外部系統(tǒng)消息推送模板配置企業(yè)內(nèi)的各應(yīng)用系統(tǒng)可以通過調(diào)用本集成平臺的消息接口，將消息推送到阿里釘釘號中，在調(diào)用本集成平臺的接口之前需要在本集成平臺中先配置一個消息模板。配置入口：【微信集成平臺】à【集成中心】à【外部系統(tǒng)消息模板】點擊【新建】按鈕可以建立一個新的消息模板1、 模板名稱：2、 是否啟用：該模板是否可用3、 推送目標：發(fā)送的消息需要推送到哪里（推送給哪個阿里釘釘號的哪些應(yīng)用或者推送

23、到哪個服務(wù)號）4、 是否帶鏈接：推送的消息是否有鏈接地址可以被用戶點擊開進行查閱，如果帶鏈接，那么鏈接地址是什么？這里可以選擇用戶打開鏈接的時候訪問到哪個web應(yīng)5、 消息格式：推送出去的消息是格式，建議選擇圖文消息6、 消息內(nèi)容模板：發(fā)送出去的消息要套用什么模板，如果不輸入則直接將消息的原始內(nèi)容發(fā)送出去，如果輸入，則會將消息模板中的標簽替換成具體的消息內(nèi)容然后發(fā)送，模板支持標簽替換目前支持以下標簽$content:消息的原始內(nèi)容，會被替換成消息的原本內(nèi)容$url：消息對應(yīng)的鏈接地址，會被替換成消息后附帶的鏈接地址，一般無需設(shè)置舉例如模板設(shè)置為：您有一個流程：【$content】需要處理，請點

24、擊本消息進行處理如果有新流程提醒：大家下午三點到會議室開會那么用戶將會收到的內(nèi)容是：您有一個流程：【大家下午三點到會議室開會】需要處理，請點擊本消息進行處理十一、 e-cology日?？记诘乩砦恢迷O(shè)置e-cology日?？记诠δ苁强梢曰贕PS定位設(shè)置每個用戶可以在哪個位置進行考勤的，每個用戶可以考勤的地理位置通過以下操作進行設(shè)置設(shè)置路徑：【泛微云橋e-Bridge】à【集成中心】à【外部系統(tǒng)集成】點擊對應(yīng)e-cology系統(tǒng)的【考勤設(shè)置】,進入如下圖所示頁面a) 考勤位置設(shè)置：在這里設(shè)置好可以進行考勤的地點，可以設(shè)置多個考勤地點和考勤偏差范圍b) 考勤規(guī)則設(shè)置：這里設(shè)置每

25、個單位、部門可以進行考勤的地點a) 適用范圍：設(shè)置該規(guī)則適用的對象可以是分部、部門、所有人b) 考勤位置：選擇前面設(shè)置的位置，如果選擇任意位置則不控制簽到位置c) 如果一個人同時歸于于多個規(guī)則，則按照部門、分部、所有的的優(yōu)先級溫馨提示：如果不設(shè)置任何考勤位置則表示不限制考勤位置十二、 e-cology應(yīng)用的個性化配置之前配置的e-cology應(yīng)用對接的都是默認的設(shè)置，你可以通過，以下方式實現(xiàn)個性化的需求。下面以個性化設(shè)置一個公司制度模塊為例來說明下個性化設(shè)置的操作：1. 需求假設(shè)：a) 需求1：希望在阿里釘釘號中有個【人事制度發(fā)布】模塊，該模塊實現(xiàn)用戶查詢通過e-cology系統(tǒng)發(fā)布的各類制度

26、需求b) 需求2：希望系統(tǒng)中一旦有這些制度產(chǎn)生就自動通過釘釘推送給用戶2. 配置實現(xiàn)a) 配置e-cology：在【集成中心】à【外部系統(tǒng)集成】中增加e-cology模塊i. 設(shè)置路徑【集成中心】à【外部系統(tǒng)集成】選擇對應(yīng)e-cology系統(tǒng)點擊【模塊設(shè)置】ii. 點擊【添加】會增加一個模塊，如下圖所示iii. 設(shè)置模塊如下1. 名稱：人事制度2. 類型：文檔3. 設(shè)置：選擇e-cology系統(tǒng)中存放公司制度的目錄 注：其他模塊同樣可以通過這樣的方式增加，如待辦、已辦等之后您就把這個新增的模塊通過兩個方式配置到釘釘中i. 按照【利用門戶管理實現(xiàn)阿里釘釘個性化首頁】章節(jié)將這個功能作為一個門戶的模塊發(fā)布到釘釘中ii. 按照【e-cology標準模塊配置】章節(jié)的說明作為一個釘釘應(yīng)用發(fā)布到釘釘中b) 配置消息推送: