模板标签转换精灵使用说明

作者:动易开发组 来源:本站原创 点击数: 更新时间:2009年08月31日

 

一、        针对转换程序的简单介绍
动易模板标签转换精灵是对模板文件进行批量转换的便捷工具,方便与诸如标签参数的变更替换、参数整理等等功能。下面是该程序的应用界面:
  动易模板标签转换精灵的所有转换规则都是可以配置的,依赖于正则表达式。目前第一个版本的配置文件提供了动易.NET系列产品2.X-3.0模板标签的转换规则,在功能发面提供了四个可选功能,分别是:
1.      转换模板中调用的标签,该功能主要是应用与官方标签参数接口(即,参数的调用名称,或参数代表的意义和功能)发生变化时,将较老的模板中调用标签转换至配置中期望的。该过程仅仅针对指定名的标签进行转换。
2.      转换配置中的公共参数,该功能的主要应用与参数的重命名,批量移除等,该过程会对所有标签的参数进行转换。
3.      转换配置中的公共内容,该功能所操作的范围更加广泛,会将符合配置规则的任何内容都进行转换。
4.      标签参数整理,该功能会将标签中调用的个个参数按照一定的方式进行顺序排列,会移除个个参数间多余的空格,使模板内的标签调用统一化。
5.      动易模板标签转换精灵详细操作请见《动易模板标签转换精灵使用方法》一文。
二、        转换的相关疑问
 
1.     是否有必要进行转换
3.0的系统标签在性能上、安全上和规范化上做了进一步的优化,有非常可观的性能提升,因此我们建议您对其进行升级,保持与官方标签持于同步状态。
注:如果是全新安装的系统则无必要进行任何转换。
 
2.     如果是自定义模板是否可以进行转换
可以进行转换,这也是该工具的设计意图
 
3.     转换过程是否绝对安全
转换过程是并不是绝对安全,可以通过预览转换结果查看转换的内容。当在修改了配置文件中存在的标签时该过程就是不安全状态,比如修改了配置文件中存在的一些系统标签,如通用信息列表,如为此标签增加了自定义的查询条件,增加了自定义参数等。
 
三、        转换的流程
 
1.     转换流程概览:
2.     转换步骤详解:
A.     转换工作的首要步骤是准备您现有的模板目录(模板和标签的总目录)
B.      查阅配置文件,如果有需要可以增加您自己所需的转换规则
C.      记录下配置节中将要转换的标签(如下图所示的label 的lhs属性值)
D.     启动转换程序点击预览按钮(如下图所示)查阅预转换的结果
E.      确认无误后点击转换按钮进行转换
F.      等待转换完成以后从3.0的正式版发布包中提取先前记录的(标签转换规则配置节)标签覆盖被转换模板目录中标签库中相对应的标签。
四、        转换配置详解
转换原理:将着手边的内容按照一定的规则替换为右手边的内容。
左右边:被替换的内容。
右手边:将要替换的内容。
交换行为:替换的行为方式,目前有三种方式,删除、交换、追加。
第三参数:用于而外的辅助捕获判断。
反向引用:引用先前捕获中分组的内容。
转换程序依赖于配置文件(转换程序中config目录下的config.xml文件)。
该配置文件由4个主要的节组成:
1.      <params>节:该节点配置属于公共参数配置节,也就是说当转换程序捕获到一个标签后开始查阅该标签是否有参数和该节下的内容相符,如果有则将这个参数替换为指定的参数,如果该节配置右手边为空则表示移除该参数。
例如:<params>节下<param lhs='\s displayDateTime=""'/>的配置含义为:如果当前标签包含参数displayDateTime=””则移除该参数。
再如:<param lhs='\s displayDateTime=""' rhs='displayDateTime="mm-dd"'/>的配置含义为:如果当前标签包含参数displayDateTime=””则将该参数替换为displayDateTime=”mm-dd”
 
2.      <labels>节:该节点配置针对指定的标签进行转换
<label>节为标签匹配节,左手边为需要匹配的标签,右手边为将要替换为的标签
<label>节下又有参数节,仅当转换程序捕获到指定的标签后,并且该标签拥有该节点配置的参数时,将其左右边替换为右手边,该节点配置拥有两个而外的属性,分别是action(行为)和oth(第三参)action可以为add,其意义为,当该标签不包含左手边的参数时,将补上右手边配置的参数;oth为第三参数需要和action行为的第二种可能性配合使用。Action第二种参数为swap,swap为交换方式,其意义为如果包含左手边,且不存在第三参数,这替换左手边为右手边
 
3.      Contents节,该节配置所有转换规则,不区分是否是标签和模板,凡是符合规则的会将其左手边替换为右手边
 
4.      <orders>节,该节定义了标签参数的排序规则,如果该标签包含的参数存在于该配置节中将会按照此配置节中参数出现的顺序排列,并且会重整理标签使之更加符合规范。
五、需要注意的事项
1.      转换程序并不会改变被转换标签的逻辑处理结构,仅仅转换符合捕获规则的内容或者标签参数,因此当转换完成后,需要手工将配置文件列表中的标签(最新版本的可以从官网的全新安装包中获得)覆盖被转换的标签
 
2.      为了数据的安全,转换前要针对模板进行备份
 
3.      如果打算自定义配置请保证正则表达式的准确性和捕获的精确性
 
33444
本篇文章的Tags:    SiteFactory标签文档  
如果以上内容未能解决您的问题,欢迎您到我们的讨论区发帖寻求帮助,我们的工作人员会热情为您解答。