插件機制 · CAP開發文檔

## 表單運行態插件機制 **插件掃描與加載** A8系統啟動時會掃描通用插件目錄(utils)下腳本、樣式等資源并加載。 **客開插件資源放置路徑** | 應用端 | 插件資源路徑 | | ------ | ---------------------------- | | PC | /seeyon/common/capextend | | 微協同 | /seeyon/m3/apps/v5/capextend | | M3 | /seeyon/m3files/v5/88.zip | [注]7.1SP1 930版本前的表單插件路徑為/seeyon/common/cap4/extend **目錄結構** PC端插件目錄結構如下圖（微協同和M3的類似） ![效果](https://img.kancloud.cn/88/bb/88bb07959c1a05ba73987ec4f7d4ed95_798x812.png) form、query、unflow、todo，分別表示表單、查詢列表、無流程列表、待辦列表如表單插件命名為pluginA，則pluginA目錄下添加的腳本和樣式資源均會被加載以請求pluginA插件index.js為例，多端請求路徑如下 | 應用端 | 請求路徑 | | ----------- | ------------------------------------------------------------ | | cap4 PC | /seeyon/common/capextend/cap4/form/utils/pluginA/index.js | | cap3 PC | /seeyon/common/capextend/cap3/form/utils/pluginA/index.js | | cap4 微協同 | /seeyon/m3/apps/v5/capextend/cap4/form/utils/pluginA/index.js | | cap3 微協同 | /seeyon/m3/apps/v5/capextend/cap3/form/utils/pluginA/index.js | | cap4 M3端 | http://capextend.v5.cmp/v/cap4/utils/pluginA/index.js | | cap3 M3端 | http://capextend.v5.cmp/v/form/utils/pluginA/index.js | 在M3端，capextend構建出來為88.zip 客開需要將M3上的插件統一放置到88.zip中，目錄結構跟微協同上路徑一致 **白名單插件** 1、白名單插件目錄與普通插件目錄同級。如cap4普通插件對應目錄/seeyon/common/capextend/cap4/form/utils/ 則白名單插件目錄為/seeyon/common/capextend/cap4/form/whiteList/ 2、默認不會加載白名單插件相應資源，需要在設計器高級配置中設置。白名單表：cap\_form\_plugin\_whitelist **插件資源重新掃描** 新制作完插件或者修改插件資源后需要系統重新掃描后才能生效，不通過重啟服務的方式為在已登錄的瀏覽器訪問地址 IP:端口/seeyon/rest/cap4/form/initFormPlugins **插件資源加載** 1、調用插件加載時，請求路徑為： /seeyon/rest/cap4/form/pluginScripts 2、表單加載參數：（moduleId，moduleType） /seeyon/rest/cap4/form/pluginScripts?page=form&v=cap4&client=pc&moduleId=6902010891055746387&moduleType=1 3、其他加載參數：（bussId，appId，formId） /seeyon/rest/cap4/form/pluginScripts?page=unflow&v=cap4&client=pc&bussId=6902010891055746387&appId=8697407549015999331&formId=-4281519914682530682 page類型："form", "unflow", "query", "todo" v版本："cap4", "cap3" client："pc", "wx", "m3"