trswcm6.5及以上二次开发-008属性面板

1、修订序号变更日期变更动作变更内容详情描述版本1.2010-04-25DEV2新建新建本文档1.02.2011-01-12修改1 添加了修改页，以后本文档有修改时请填写修改信息。1. 列表页面属性面板1.1. 概述WCM65 的列表页面右侧通常会有三块面板，其中第三块面板中的信息是当前选中的一些属性信息，因此也称其为属性面板，在属于面板上，能快速方便的查阅和修改当前对象的一些基本信息，提高了系统的使用效率。关于属性面板的数据来源在文档 TRSWCM65 二次开发-操作面板中已经详细叙述了，常用的属性面板数据来源的处理方式有两种，一种是以发送服务的方式来获取数据，一般会convertor 到一个_

2、findbyid.jsp 页面。另一种是面板的时候将控制数据来源的 url 参以下描述的几个场景。下面数直接指向一个 jsp 页面。无论是那个方式，都会遇到就实际需求中常见的几种使用场景来一一操作。1.2. 实战示例修改的文件：对于 WCM 现有的普通对象，一般是修改下面描述的文件，app_ findbyid.js， 其中对象名称见TRSWCM6.5- 目录结构.doc ， 比如文档为，那么就是app_ findbyid.jsp。但也有一些是例外的，如工作列表，短消息，模板变量，这些都是通过 js 画出来的，见TRSWCM6.5 二次开发-操作面板实战的场景 3，而上面的这 2 中情况都是有操

3、作面板里面的 js 代码决定的，在相应对象的操作面板的 js 中（ 见TRSWCM6.5 二次开发- 操作面板文件说明）， 搜索wcm.PageOper.registanels，找到单个对象的，代码中加粗的部分，决定了详细信息面板的代码文件所在，如 template 的为：那么模板的详细信息面板的文件就是 template_ findbyid.jsp模板变量的为：templateArg : title : String.format(wcm.LANGOPER_TITLE_OBJ, sName), displayNum : 7,detail : function(cmsobjs, opt) va

4、r obj = cmsobjs.ge(0);return getEditInfo(obj);template : title : String.format(wcm.LANGOPER_TITLE_OBJ, sName), displayNum : 7,url : ?serviceid=wcm61_template&methodname=jFindbyid,那么模板变量的详细信息面板就是通过 js 画出来的，详见TRSWCM6.5 二次开发-操作面板的描述。场景一 可编辑的输入框类型在的属性面板中，有些属性是可以直接在输入框中进行修改的，例如文档列表中文档标题。下图是某篇文档的属性面板，其中文档

5、标题“我来新建下”在样式上是深蓝色，点击一下会呈现为一个输入框，在输入框中输入新的标题后，当此输入框失去焦点的时候，会自动将新的标题信息提交保存起来。以上可输入修改的这种效果怎么实现呢？修改方法：在对应的 jsp 页面中添加如下的代码参数说明和示例代码如下：/*约定的布局+样式的方式*DIV 中套 span。，其中 div 的样式 attribute_row 是固定的，添加上这样的样式，底层会认为该元素是对象的一个属性元素。如果是一些主要属性，可以在 Div 中上添加样式 main_attr，属性内容就会呈现深蓝色。*当 Span 的样式是 wcm_attr_value 的时候，底层会认为这是

6、一个显示属性值的元素*当 DIV 的样式中包含样式 editable 时，底层会认为此属性值是可以修改的，点击此属性值元素的时候，会将其变为可编辑的状态，同时修改完后，当此输入框失去焦点的时候，自动将新的内容保存*属性值对应的 dom 元素 span 中可以指定哪些属性呢？必须指定哪些属性呢？*必须指定的属性:_fieldName：字段名属性决定了保存的时候，是保存到数据库中的那个字段。,场景二 只允许查看的类型有些属性在属性面板只是显示值，但不需要修改，例如下图中文档的属性面板中的创建用户、创建时间、所属栏目。_fieldValue:字段值属性的使用是这样的，保存的时候，如果当前元素是 in

7、put类型的，则取其 value，如果不是，则取属性_fieldValue 的值，当然底层框架会属性_fieldValue 的值，保证该值为设置值。*额外可以添加的属性：Validation：对该属性值的校验的控制。可以对其类型，长度等进行校验。_serviceId 和_methodName:之前 讲到在输入框失去焦点的时候，系统会自动保存，对于这个保存，在这详细介绍下， 是采用发送服务的方式进行保存的，当 span元素中不指定_serviceId 和_methodName 的时候，默认发送到的服务名是在_list.js 中指定的 PageContext.serviceId，方法名为 save

8、，如果有特殊的需求，可以在 span 中用这两个属性指定服务名和方法名。*/String sEditable = bCanEdit?editable:readonly;div class=attribute_row doctitle main_attr首页标题:span class=wcm_attr_value _fieldName=DOCTITLE_fieldValue= validation=max_len:200,type:string,desc:首页标题 validation_desc=首页标题 _serviceId=wcm61_methodName=&;修改方法： 在 对 应 的 j

9、sp 页面 （ 例如_findbyid.jsp, 例 如 文 档 列 表 的 是 在app_ findbyid.jsp。）中添加如下的代码。参数说明和示例代码如下：场景三 下拉选择框可修改类型修改方法：在对应的 jsp 页面中添加如下的代码参数说明和示例代码如下/*约定的布局+样式的方式*DIV 中套 span。，其中 div 的样式 attribute_row 是固定的，添加上这样的样式，底层会认为该元素是对象的一个属性元素。*当 DIV 的样式中包含样式 readonly 时，底层会认为此属性值是不可以修改的。*div 中的样式 descinfo 表示这是描述信息，控制信息的显示位置以及字

10、体效果。*当 Span 的样式是 wcm_attr_value 的时候，底层会认为这是一个显示属性值的元素在 span 元素上添加 select 样式，用来控制其显示效果。*必须指定的属性:_fieldName：字段名属性决定了保存的时候，是保存到数据库中的那个字段。_fieldValue:字段值属性的使用是这样的，保存的时候，如果当前元素是 input类型的，则取其 value，如果不是，则取属性_fieldValue 的值，当然底层框架会属性_fieldValue 的值，保证该值为设置值。_selec：只有指定了该属性，底层框架才能识别这是一个下拉选择框。该值必须为已经定义好了一个的 se

11、lect 元素的 name/*约定的布局+样式的方式*DIV 中套 span。，其中 div 的样式 attribute_row 是固定的，添加上这样的样式，底层会认为该元素是对象的一个属性元素。*当 DIV 的样式中包含样式 readonly 时，底层会认为此属性值是不可以修改的。*div 中的样式 descinfo 表示这是描述信息，控制信息的显示位置以及字体效果。*当 Span 的样式是 wcm_attr_value 的时候，底层会认为这是一个显示属性值的元素里层 span 中的样式 value 的作用是控制内容显示为灰色，但是只有在该 span 元素是样式 descinfo 所在元素的

12、子元素才能起到效果。*/span title=文档:&;创建者:创建时间：RecID:&;用户创建于场景四 在多个属性之间分割线修改方法：在对应的 jsp 页面中添加如下的代码，代码示例如下：/该 div 添加的样式必须为 attrbute_row_sep*额外可以添加的属性：Validation：对该属性值的校验的控制。可以对其类型，长度等进行校验。_serviceId 和_methodName:之前 讲到在输入框失去焦点的时候，系统会自动保存，对于这个保存，在这详细介绍下， 是采用发送服务的方式进行保存的，当 span元素中不指定_serviceId 和_methodName 的时候，默认发送到的服务名是在_list.js 中指定的 PageCo