易客CRM,中小企业最忠实的合作伙伴!

SugarCRM研究(二)

803℃

SugarCRM列表的实现原理的核心是ListView类。下文将根据一个实例来解剖ListView类。
1)$ListView = new ListView();
2)$ListView->initNewXTemplate(‘modules/Documents/DocumentRevisionListView.html’,$mod_strings);
3)$ListView->setQuery(" document_id = ‘$focus->id’",""," document_revisions.date_entered desc","");
4)$ListView->setHeaderTitle($mod_strings['LBL_DOC_REV_HEADER']);
5)$ListView->processListView($revision, "main", "DOCREVISION");
以上代码是文档模块的文档列表的实现代码。
1)    是创建一个ListView实例,和Java创建实例一样;
2)    初始化模版(XTemplate);
3)    设置where条件(setQuery的第一个参数)和设置排序字段(setQuery的第三个参数);
4)    设置列表页面的标题;
5)    调用processListView方法,$revision是document模块的bean的实例,main是 DocumentRevisionListView.html中的板块名称,DOCREVISION是用来存取SESSION里有关document模块 相关的信息。

在processListView方法里,首先处理massUpdate(批量更新)的操作,然后调用processListViewTwo方法;

在processListViewTwo这个方法里,首先调用processSugarBean,返回查询得到的记录List,然后处理排序和 Orderby等问题,接着调用processListRows($list,$xTemplateSection, $html_varName)方法显示得到的记录;

在processSugarBean方法里,调用seed(模块bean的实例)的get_list方法获取list,在get_list方法里调用 seed的create_list_query(create query sql)和process_list_query;

在process_list_query方法里,根据查询语句和vardefs.php定义的field_defs从数据库取值并赋值给seed对应的变 量,然后调用seed的fill_in_additional_list_fields方法取得没有在vardefs.php定义的字段或者变量,如果需 要把这些额外的变量赋给列表上的变量(DocumentRevisionListView.html列表中定义的,但没有在vardefs.php定义的 变量),需要在get_list_view_data方法返回的数组里添加这些额外的变量以及额外变量对应的KEY,即 DocumentRevisionListView.html模版定义的变量。

在processListRows方法里,循环DataList,在循环里,调用aItem的
$aItem->check_date_relationships_load();进行日期格式处理(gmdate和date的处理)
然后调用$fields = $aItem->get_list_view_data();在get_list_view_data里,把bean的字段变为大写作为KEY,对 应值作为value,把key-value放在数组里赋给DocumentRevisionListView.html模版里的变量 DOCREVISION(模块名的大写)。

get_list_view_data是在fill_in_additional_list_fields之后被调用的,这两个函数一般都需要子类覆盖 SugarBean的这两个方法,特别是fill_in_additional_list_fields方法,SugarBean里是空的,什么操作都没 有,需要子类实现。

注意:模版文件里定义的需要显示的变量需要与数据库表的字段一样,一般在模版里是大写,modulebean定义的表结构变量是小写。

下一篇:如何添加subpanel?

转载请注明:易客CRM官方博客 » SugarCRM研究(二)

喜欢 (0)or分享 (0)