動易CMS模板標簽轉換精靈使用說明

　　一、針對轉換程序的簡單介紹

　　動易模板標簽轉換精靈是對模板文件進行批量轉換的便捷工具，方便與諸如標簽參數的變更替換、參數整理等等功能。下面是該程序的應用界面：

　　動易模板標簽轉換精靈的所有轉換規則都是可以配置的，依賴于正則表達式。目前第一個版本的配置文件提供了動易.NET系列產品2.X-3.0模板標簽的轉換規則，在功能發面提供了四個可選功能，分別是：

　　1. 轉換模板中調用的標簽，該功能主要是應用與官方標簽參數接口(即，參數的調用名稱，或參數代表的意義和功能)發生變化時，將較老的模板中調用標簽轉換至配置中期望的。該過程僅僅針對指定名的標簽進行轉換。

　　2. 轉換配置中的公共參數，該功能的主要應用與參數的重命名，批量移除等，該過程會對所有標簽的參數進行轉換。

　　3. 轉換配置中的公共內容，該功能所操作的范圍更加廣泛，會將符合配置規則的任何內容都進行轉換。

　　4. 標簽參數整理，該功能會將標簽中調用的個個參數按照一定的方式進行順序排列，會移除個個參數間多余的空格，使模板內的標簽調用統一化。

　　二、轉換的相關疑問

　　1.是否有必要進行轉換

　　3.0的系統標簽在性能上、安全上和規范化上做了進一步的優化，有非常可觀的性能提升，因此我們建議您對其進行升級，保持與官方標簽持于同步狀態。

　　注：如果是全新安裝的系統則無必要進行任何轉換。

　　2.如果是自定義模板是否可以進行轉換

　　可以進行轉換，這也是該工具的設計意圖

　　3.轉換過程是否絕對安全

　　轉換過程是并不是絕對安全，可以通過預覽轉換結果查看轉換的內容。當在修改了配置文件中存在的標簽時該過程就是不安全狀態，比如修改了配置文件中存在的一些系統標簽，如通用信息列表，如為此標簽增加了自定義的查詢條件，增加了自定義參數等。

　　三、轉換的流程

　　1.轉換流程概覽：

　　2.轉換步驟詳解：

　　A. 轉換工作的首要步驟是準備您現有的模板目錄(模板和標簽的總目錄)

　　B. 查閱配置文件，如果有需要可以增加您自己所需的轉換規則

　　C. 記錄下配置節中將要轉換的標簽(如下圖所示的label 的lhs屬性值)

　　D. 啟動轉換程序點擊預覽按鈕(如下圖所示)查閱預轉換的結果

　　E. 確認無誤后點擊轉換按鈕進行轉換

　　F. 等待轉換完成以后從3.0的正式版發布包中提取先前記錄的(標簽轉換規則配置節)標簽覆蓋被轉換模板目錄中標簽庫中相對應的標簽。

　　四、轉換配置詳解

　　轉換原理：將著手邊的內容按照一定的規則替換為右手邊的內容。

　　左右邊：被替換的內容。

　　右手邊：將要替換的內容。

　　交換行為：替換的行為方式，目前有三種方式，刪除、交換、追加。

　　第三參數：用于而外的輔助捕獲判斷。

　　反向引用：引用先前捕獲中分組的內容。

　　轉換程序依賴于配置文件(轉換程序中config目錄下的config.xml文件)。

　　該配置文件由4個主要的節組成：

　　1. 節：該節點配置屬于公共參數配置節，也就是說當轉換程序捕獲到一個標簽后開始查閱該標簽是否有參數和該節下的內容相符，如果有則將這個參數替換為指定的參數，如果該節配置右手邊為空則表示移除該參數。

　　例如：節下的配置含義為：如果當前標簽包含參數displayDateTime=””則移除該參數。

　　再如：的配置含義為：如果當前標簽包含參數displayDateTime=””則將該參數替換為displayDateTime=”mm-dd”

　　2. 節：該節點配置針對指定的標簽進行轉換

　　節為標簽匹配節，左手邊為需要匹配的標簽，右手邊為將要替換為的標簽

　　節下又有參數節，僅當轉換程序捕獲到指定的標簽后，并且該標簽擁有該節點配置的參數時，將其左右邊替換為右手邊，該節點配置擁有兩個而外的屬性，分別是action(行為)和oth(第三參)action可以為add，其意義為，當該標簽不包含左手邊的參數時，將補上右手邊配置的參數;oth為第三參數需要和action行為的第二種可能性配合使用。Action第二種參數為swap,swap為交換方式，其意義為如果包含左手邊，且不存在第三參數，這替換左手邊為右手邊

　　3. Contents節，該節配置所有轉換規則，不區分是否是標簽和模板，凡是符合規則的會將其左手邊替換為右手邊

　　4. 節，該節定義了標簽參數的排序規則，如果該標簽包含的參數存在于該配置節中將會按照此配置節中參數出現的順序排列，并且會重整理標簽使之更加符合規范。

　　五、需要注意的事項

　　1. 轉換程序并不會改變被轉換標簽的邏輯處理結構，僅僅轉換符合捕獲規則的內容或者標簽參數，因此當轉換完成后，需要手工將配置文件列表中的標簽(最新版本的可以從官網的全新安裝包中獲得)覆蓋被轉換的標簽

　　2. 為了數據的安全，轉換前要針對模板進行備份

　　3. 如果打算自定義配置請保證正則表達式的準確性和捕獲的精確性

生活不易，碼農辛苦
如果您覺得本網站對您的學習有所幫助,可以手機掃描二維碼進行捐贈